Managing Subscriptions

Once subscriptions are running, you can list and filter them, pull payment history to reconcile, and cancel. List endpoints are paginated, newest first. Everything here is also available in the merchant dashboard.

List and filter subscriptions

GET /api/v3/subscriptions

# All active or past-due subscriptions
curl "https://api.confirmo.com/api/v3/subscriptions?status=ACTIVE&status=PAST_DUE" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter by status, by customerProfileId (the profileId you set at creation), or by a createdFrom / createdTo date range. To fetch one subscription, use GET /api/v3/subscriptions/{subscriptionId}.

List payments

GET /api/v3/subscriptions/payments

A payment is a single recurring charge — one record per cycle, ending in SUCCEEDED or FAILED. Pull the history for one subscription, or across all of them.

# All payments for one subscription
curl "https://api.confirmo.com/api/v3/subscriptions/payments?subscriptionId=5c2e8d4a..." \
  -H "Authorization: Bearer YOUR_API_KEY"

Each payment record carries the billed fiat amount, the settled stablecoin amount, the fee breakdown, the chain, and the transaction hash, so your finance team can reconcile down to the on-chain transaction. The full field list is in the Subscriptions API Specification.

Cancel a subscription

POST /api/v3/subscriptions/{subscriptionId}/cancel

A subscription can be canceled at any time, by you or by your subscriber. Cancellation stops future billing immediately and fires subscription.canceled with a cancellation.reason. The call is idempotent — canceling an already-canceled subscription just returns its current state. A subscription that has already expired can't be canceled and returns 409.

curl -X POST https://api.confirmo.com/api/v3/subscriptions/5c2e8d4a.../cancel \
  -H "Authorization: Bearer YOUR_API_KEY"

Give subscribers a clear way to cancel

We recommend offering your subscribers a dedicated cancellation path: either on your site, with your backend calling the cancel endpoint for them, or by contacting you so you can cancel on their behalf.

Merchant dashboard analytics

The merchant dashboard gives you Monthly Recurring Revenue (MRR) and subscriber analytics, a per-plan summary, a searchable subscription list, a payment ledger, and failed-payment callouts for at-risk subscribers.