{
"customerEmail": "alice@example.com",
"customerName": "Alice Johnson",
"walletAddress": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12"
}
{
"id": "sub_abc123def456",
"planId": "plan_abc123def456",
"planName": "Pro Monthly",
"customerEmail": "alice@example.com",
"customerName": "Alice Johnson",
"walletAddress": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
"status": "trialing",
"currentPeriodStart": "2026-03-26T14:30:00Z",
"currentPeriodEnd": "2026-04-26T14:30:00Z",
"trialEnd": "2026-04-09T14:30:00Z",
"createdAt": "2026-03-26T14:30:00Z"
}
Subscriptions
Subscribe to Plan
Create a new subscription for a customer on a specific plan
POST
/
v1
/
subscription-plans
/
{id}
/
subscribe
{
"customerEmail": "alice@example.com",
"customerName": "Alice Johnson",
"walletAddress": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12"
}
{
"id": "sub_abc123def456",
"planId": "plan_abc123def456",
"planName": "Pro Monthly",
"customerEmail": "alice@example.com",
"customerName": "Alice Johnson",
"walletAddress": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
"status": "trialing",
"currentPeriodStart": "2026-03-26T14:30:00Z",
"currentPeriodEnd": "2026-04-26T14:30:00Z",
"trialEnd": "2026-04-09T14:30:00Z",
"createdAt": "2026-03-26T14:30:00Z"
}
Authentication
This endpoint requires a Bearer token in theAuthorization header.
Authorization: Bearer <your_jwt_token>
Path Parameters
Body Parameters
The email address of the customer subscribing to the plan. Used for sending receipts and renewal notifications.
The customer’s cryptocurrency wallet address. Recurring payments will be collected from this address via the on-chain subscription smart contract.
Response
The subscription status. Newly created subscriptions start as
active (or trialing if the plan has a trial period).{
"customerEmail": "alice@example.com",
"customerName": "Alice Johnson",
"walletAddress": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12"
}
{
"id": "sub_abc123def456",
"planId": "plan_abc123def456",
"planName": "Pro Monthly",
"customerEmail": "alice@example.com",
"customerName": "Alice Johnson",
"walletAddress": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
"status": "trialing",
"currentPeriodStart": "2026-03-26T14:30:00Z",
"currentPeriodEnd": "2026-04-26T14:30:00Z",
"trialEnd": "2026-04-09T14:30:00Z",
"createdAt": "2026-03-26T14:30:00Z"
}