StableOps
API reference

Retrieve a merchant subscription

Retrieve a StableOps merchant subscription by ID to inspect its current state, plan, billing period, and pending changes before updating customer access.

GET/v1/merchant/subscriptions/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

Paste your API key from the dashboard.

In: header

Path Parameters

id*unknown

Merchant subscription id.

Response Body

application/json

curl -X GET "https://example.com/v1/merchant/subscriptions/{id}"
{
  "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"
}

How is this guide?

Last updated

Retrieve a merchant subscription by user GET

Look up a StableOps merchant subscription by merchant user ID, inspect the returned billing state, and map customer access to the correct subscription record.

Change a merchant subscription plan POST

Change a StableOps merchant subscription plan, inspect upgrade difference invoices or scheduled renewal changes, and wait for settlement before changing access.