@radzor/subscription-billing

Manage recurring subscriptions with Stripe Billing. Create, update, cancel subscriptions, and handle lifecycle events like payment failures and renewals.

Paymentv0.1.0typescriptpythonServerstripesubscriptionbillingrecurringpaymentsaasby Radzor

Install

View source on GitHub →

$npx radzor@latest add subscription-billing

⚠ Constraints: Requires Stripe secret key (server-side only). Webhook endpoint must be publicly accessible. Customers must be created in Stripe before subscriptions. Use test keys during development.

Inputs

Name	Type	Default	Description
secretKey*	string	—	Stripe secret API key (sk_live_... or sk_test_...).STRIPE_SECRET_KEY
webhookSecret*	string	—	Stripe webhook signing secret for verifying subscription events.STRIPE_WEBHOOK_SECRET
defaultCurrency	string	usd	Default currency for new subscriptions (ISO 4217).

secretKey*string

Stripe secret API key (sk_live_... or sk_test_...).

STRIPE_SECRET_KEY

webhookSecret

{ "llm": { "constraints": "Requires Stripe secret key (server-side only). Webhook endpoint must be publicly accessible. Customers must be created in Stripe before subscriptions. Use test keys during development.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/subscription-billing", "tags": [ "stripe", "subscription", "billing", "recurring", "payment", "saas" ], "events": [ { "name": "onSubscriptionCreated", "payload": { "status": "string", "priceId": "string", "customerId": "string", "subscriptionId": "string" }, "description": "Fired when a new subscription is created." }, { "name": "onSubscriptionCancelled", "payload": { "cancelAt": "number", "customerId": "string", "subscriptionId": "string" }, "description": "Fired when a subscription is cancelled." }, { "name": "onPaymentFailed", "payload": { "invoiceId": "string", "customerId": "string", "attemptCount": "number", "subscriptionId": "string" }, "description": "Fired when a subscription payment attempt fails." } ], "inputs": [ { "name": "secretKey", "type": "string", "envVar": "STRIPE_SECRET_KEY", "required": true, "description": "Stripe secret API key (sk_live_... or sk_test_...)." }, { "name": "webhookSecret", "type": "string", "envVar": "STRIPE_WEBHOOK_SECRET", "required": true, "description": "Stripe webhook signing secret for verifying subscription events." }, { "name": "defaultCurrency", "type": "string", "default": "usd", "required": false, "description": "Default currency for new subscriptions (ISO 4217)." } ], "radzor": "1.0.0", "actions": [ { "name": "createSubscription", "params": [ { "name": "customerId", "type": "string", "description": "Stripe customer ID." }, { "name": "priceId", "type": "string", "description": "Stripe price ID for the plan." }, { "name": "trialDays", "type": "number", "required": false, "description": "Optional trial period in days." } ], "returns": "Promise<SubscriptionData>", "description": "Create a new subscription for a customer." }, { "name": "cancelSubscription", "params": [ { "name": "subscriptionId", "type": "string", "description": "Stripe subscription ID to cancel." }, { "name": "immediate", "type": "boolean", "required": false, "description": "If true, cancel immediately. Otherwise cancel at period end." } ], "returns": "Promise<SubscriptionData>", "description": "Cancel a subscription immediately or at the end of the current billing period." }, { "name": "updateSubscription", "params": [ { "name": "subscriptionId", "type": "string", "description": "Stripe subscription ID to update." }, { "name": "newPriceId", "type": "string", "required": false, "description": "New Stripe price ID for plan change." }, { "name": "quantity", "type": "number", "required": false, "description": "New seat/unit quantity." } ], "returns": "Promise<SubscriptionData>", "description": "Update an existing subscription (change plan, adjust quantity)." }, { "name": "listSubscriptions", "params": [ { "name": "customerId", "type": "string", "description": "Stripe customer ID to list subscriptions for." }, { "name": "status", "type": "string", "required": false, "description": "Filter by status (active, past_due, canceled, all)." } ], "returns": "Promise<SubscriptionData[]>", "description": "List all subscriptions for a customer, optionally filtered by status." } ], "outputs": [ { "name": "subscription", "type": "SubscriptionData", "fields": [ { "name": "id", "type": "string", "description": "Stripe subscription ID." }, { "name": "customerId", "type": "string", "description": "Stripe customer ID." }, { "name": "status", "type": "string", "description": "Subscription status (active, past_due, canceled, etc.)." }, { "name": "priceId", "type": "string", "description": "Stripe price ID for the subscribed plan." }, { "name": "currentPeriodEnd", "type": "number", "description": "Unix timestamp of current billing period end." }, { "name": "cancelAtPeriodEnd", "type": "boolean", "description": "Whether the subscription is set to cancel at period end." } ], "description": "The current subscription object with status, billing details, and plan info." }, { "name": "subscriptionList", "type": "SubscriptionData[]", "description": "Array of subscriptions returned by listSubscriptions." } ], "runtime": "server", "version": "0.1.0", "category": "payment", "languages": [ "typescript", "python" ], "description": "Manage recurring subscriptions with Stripe Billing. Create, update, cancel subscriptions, and handle lifecycle events like payment failures and renewals.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "event": "onPaymentFailed", "description": "Alert on failed subscription payment", "compatibleWith": [ "@radzor/email-send.action.send.message", "@radzor/slack-bot.action.sendMessage.text", "@radzor/notification-hub.action.send.body" ] }, { "output": "subscription", "mapField": "customerId", "compatibleWith": [ "@radzor/invoice-generator.action.setCustomer.name", "@radzor/usage-metering.action.recordUsage.customerId" ] }, { "event": "onSubscriptionCancelled", "description": "Notify team of subscription cancellation", "compatibleWith": [ "@radzor/slack-bot.action.sendMessage.text", "@radzor/email-send.action.send.message" ] } ] } }

@radzor/subscription-billing

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json

Name	Type	Description
subscription	SubscriptionData	The current subscription object with status, billing details, and plan info. .idstring .customerIdstring .statusstring .priceIdstring .currentPeriodEndnumber .cancelAtPeriodEndboolean
subscriptionList	SubscriptionData[]	Array of subscriptions returned by listSubscriptions.