billing-management - SKILL.md Agent Skill

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: MIT 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