@radzor/stripe-checkout

Simplified Stripe Checkout integration. Creates checkout sessions, handles payment webhooks, and manages subscription lifecycle.

Paymentv0.1.0typescriptpythonServerstripepaymentcheckoutsubscriptionbillingby Radzor

Install

View source on GitHub →

$npx radzor@latest add stripe-checkout

⚠ Constraints: Requires Stripe secret key (server-side) and publishable key (client-side). Webhook endpoint must be publicly accessible. Use STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET environment variables.

Inputs

Name	Type	Default	Description
priceId*	string	—	Stripe Price ID for the product or subscription.
quantity	number	1	Quantity of the item to purchase.
successUrl*	string	—	URL to redirect to after successful payment.
cancelUrl*	string	—	URL to redirect to if the user cancels checkout.
mode	'payment' \| 'subscription'	payment	Checkout mode: one-time payment or recurring subscription.
secretKey*	string	—	Stripe secret API key (sk_live_... or sk_test_...). Server-side only.

{ "llm": { "constraints": "Requires Stripe secret key (server-side) and publishable key (client-side). Webhook endpoint must be publicly accessible. Use STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET environment variables.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/stripe-checkout", "tags": [ "stripe", "payment", "checkout", "subscription", "billing" ], "events": [ { "name": "onPaymentSuccess", "payload": { "amount": "number", "sessionId": "string", "customerId": "string" }, "description": "Fired when payment is successfully completed (via webhook)." }, { "name": "onPaymentFailed", "payload": { "error": "string", "sessionId": "string" }, "description": "Fired when payment fails." }, { "name": "onSubscriptionCreated", "payload": { "priceId": "string", "customerId": "string", "subscriptionId": "string" }, "description": "Fired when a new subscription is created." }, { "name": "onSubscriptionCanceled", "payload": { "subscriptionId": "string" }, "description": "Fired when a subscription is canceled." } ], "inputs": [ { "name": "priceId", "type": "string", "required": true, "description": "Stripe Price ID for the product or subscription." }, { "name": "quantity", "type": "number", "default": 1, "required": false, "description": "Quantity of the item to purchase." }, { "name": "successUrl", "type": "string", "required": true, "description": "URL to redirect to after successful payment." }, { "name": "cancelUrl", "type": "string", "required": true, "description": "URL to redirect to if the user cancels checkout." }, { "name": "mode", "type": "'payment' | 'subscription'", "default": "payment", "required": false, "description": "Checkout mode: one-time payment or recurring subscription." }, { "name": "secretKey", "type": "string", "envVar": "STRIPE_SECRET_KEY", "required": true, "description": "Stripe secret API key (sk_live_... or sk_test_...). Server-side only." }, { "name": "webhookSecret", "type": "string", "envVar": "STRIPE_WEBHOOK_SECRET", "required": true, "description": "Stripe webhook signing secret (whsec_...) for verifying webhook events." } ], "radzor": "1.0.0", "actions": [ { "name": "createCheckout", "params": [ { "name": "customerEmail", "type": "string", "required": false, "description": "Customer email for the checkout session." } ], "returns": "Promise<StripeCheckoutSession>", "description": "Create a new Stripe Checkout session and return the session URL." }, { "name": "getPaymentStatus", "params": [ { "name": "sessionId", "type": "string", "description": "Stripe Checkout session ID." } ], "returns": "Promise<string>", "description": "Check the payment status of a checkout session." }, { "name": "cancelSubscription", "params": [ { "name": "subscriptionId", "type": "string", "description": "Stripe subscription ID to cancel." } ], "returns": "Promise<void>", "description": "Cancel an active subscription at the end of the current billing period." }, { "name": "handleWebhook", "params": [ { "name": "payload", "type": "string", "description": "Raw request body from Stripe webhook." }, { "name": "signature", "type": "string", "description": "Stripe-Signature header value." } ], "returns": "Promise<WebhookEvent>", "description": "Verify and parse a Stripe webhook event." } ], "outputs": [ { "name": "checkoutSession", "type": "StripeCheckoutSession", "fields": [ { "name": "id", "type": "string" }, { "name": "url", "type": "string" }, { "name": "status", "type": "string" } ], "description": "The created Stripe Checkout session with URL and ID." }, { "name": "paymentStatus", "type": "'pending' | 'succeeded' | 'failed' | 'canceled'", "description": "Current payment status." } ], "runtime": "server", "version": "0.1.0", "category": "payment", "languages": [ "typescript", "python" ], "description": "Simplified Stripe Checkout integration. Creates checkout sessions, handles payment webhooks, and manages subscription lifecycle.", "dependencies": { "packages": { "stripe": "^14.0.0" } }, "composability": { "connectsTo": [ { "event": "onPaymentSuccess", "description": "Notify customer and team when payment succeeds.", "compatibleWith": [ "@radzor/email-send.action.send.message", "@radzor/slack-bot.action.sendMessage.text", "@radzor/push-notification.action.sendToDevice.notification", "@radzor/sms-send.action.send.body" ] }, { "event": "onPaymentFailed", "description": "Alert on payment failure.", "compatibleWith": [ "@radzor/email-send.action.send.message", "@radzor/slack-bot.action.sendMessage.text" ] }, { "event": "onSubscriptionCreated", "description": "Send welcome email for new subscribers.", "compatibleWith": [ "@radzor/email-send.action.send.message" ] }, { "event": "onSubscriptionCanceled", "description": "Send cancellation confirmation.", "compatibleWith": [ "@radzor/email-send.action.send.message" ] }, { "output": "checkoutSession", "mapField": "id", "description": "Generate invoice/receipt PDF from checkout session data.", "compatibleWith": [ "@radzor/pdf-generate.action.fromTemplate.data" ] } ] } }

@radzor/stripe-checkout

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json

Version History

Name	Type	Description
checkoutSession	StripeCheckoutSession	The created Stripe Checkout session with URL and ID. .idstring .urlstring .statusstring
paymentStatus	'pending' \| 'succeeded' \| 'failed' \| 'canceled'	Current payment status.