StableOps
API reference

Create a merchant subscription

Create a StableOps subscription for a merchant user and selected plan, inspect its first invoice or trial state, and prepare a separate wallet payment flow.

POST/v1/merchant/subscriptions

Authorization

bearerAuth
AuthorizationBearer <token>

Paste your API key from the dashboard.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/merchant/subscriptions" \  -H "Content-Type: application/json" \  -d '{    "plan_id": "string",    "merchant_user_id": "string"  }'
{
  "subscription": {
    "id": "string",
    "merchant_user_id": "string",
    "plan_id": "string",
    "status": "incomplete",
    "current_period_start": "2019-08-24T14:15:22Z",
    "current_period_end": "2019-08-24T14:15:22Z",
    "cancel_at_period_end": true,
    "pending_plan_id": "string",
    "pending_plan_change_at": "2019-08-24T14:15:22Z",
    "trial_ends_at": "2019-08-24T14:15:22Z",
    "canceled_at": "2019-08-24T14:15:22Z",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  },
  "invoice": {
    "id": "string",
    "subscription_id": "string",
    "merchant_user_id": "string",
    "kind": "first",
    "period_start": "2019-08-24T14:15:22Z",
    "period_end": "2019-08-24T14:15:22Z",
    "amount": "string",
    "asset": "USDC",
    "status": "open",
    "payment_order_id": "string",
    "target_plan_id": "string",
    "due_at": "2019-08-24T14:15:22Z",
    "paid_at": "2019-08-24T14:15:22Z",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}

How is this guide?

Last updated

Delete a merchant plan DELETE

Review the StableOps merchant plan deletion endpoint, required plan ID, request scope, and response before removing a plan from your subscription offering.

List merchant subscriptions GET

List StableOps merchant subscriptions to inspect customer enrollment, current lifecycle states, and billing periods for access management and reconciliation.