Subscription API

Create recurring payment plans, request customer authorization, manage subscriptions and securely process customer-approved plan changes. Every subscription authorization requires a TrustBill wallet login, funding-asset selection and six-digit payment PIN approval.

Production base URL: https://pay.trustbill.net

API v1 X-API-KEY Wallet Login Required Funding Asset Selection 6-Digit PIN Approval Idempotency Supported Webhooks

Authentication

Send the merchant API key with every protected API request.

X-API-KEY: your_api_key

Create a plan

Define the recurring amount, currency and billing interval.

POST /api/v1/subscription-plans

Create a subscription

TrustBill returns an authorization URL. The customer logs in, selects the funding asset and confirms with the six-digit payment PIN. Guest crypto payment is not available for subscriptions.

POST /api/v1/subscriptions

Manage lifecycle

Pause, resume or cancel an existing subscription using the merchant API.

POST /api/v1/subscriptions/{id}/pause