/billing-management

name: billing-management
description: Manage XActions subscriptions and billing — view plans, start a Stripe checkout, open the billing portal, or cancel a subscription. Use when users want to upgrade, downgrade, or manage their XActions subscription.
license: Apache-2.0
metadata:
  author: nichxbt
  version: "1.0"

Billing Management

Stripe-powered subscription and billing management for XActions.

Entry Points

| Goal | Route | Method | |------|-------|--------| | List available plans | `GET /api/billing/plans` | REST API | | Start Stripe checkout | `POST /api/billing/checkout` | REST API | | Open billing portal | `GET /api/billing/portal` | REST API | | Get current subscription | `GET /api/billing/subscription` | REST API | | Cancel subscription | `POST /api/billing/cancel` | REST API |

API Usage

List plans

GET /api/billing/plans

Returns all available subscription tiers with pricing and feature limits.

Start checkout

POST /api/billing/checkout
Authorization: Bearer <token>
Content-Type: application/json

{
  "plan": "pro",
  "successUrl": "https://yourapp.com/success",
  "cancelUrl": "https://yourapp.com/cancel"
}

Returns a Stripe checkout URL to redirect the user to.

Open billing portal

GET /api/billing/portal
Authorization: Bearer <token>

Returns a Stripe Customer Portal URL where users can update payment methods, view invoices, and manage their subscription.

Subscription Tiers

| Tier | Key Features | |------|-------------| | `free` | Limited operations, community features | | `basic` | More operations, standard automations | | `pro` | Unlimited operations, all features, API access | | `enterprise` | Custom limits, dedicated support, team features |

Notes

• Billing is handled entirely by Stripe — XActions does not store payment details
• Subscription status is synced via Stripe webhooks
• Downgrade takes effect at the end of the current billing period
• Credits (for pay-per-use operations) are separate from subscriptions

Related Skills

• **teams-management** — Manage team members on your plan
• **x402-payments** — Alternative crypto-based payment via x402 protocol
• **xactions-cli** — Check plan status via CLI