bankstract
Api

Start a subscription checkout (admin)

Admin-only. Initializes a Paystack transaction for the tier's plan and returns inline-checkout params. apps/app proxies this; the Paystack secret stays worker-side.

POST
/v1/admin/billing/subscribe

Header Parameters

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/admin/billing/subscribe" \  -H "Content-Type: application/json" \  -d '{    "owner": "string",    "email": "string",    "tier": "starter"  }'
{  "authorization_url": "string",  "access_code": "string",  "reference": "string"}
{  "error": "string",  "error_class": "string",  "format_version": "string",  "marker_coverage": 0}
{  "error": "string",  "error_class": "string",  "format_version": "string",  "marker_coverage": 0}
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}

Revoke an API key DELETE

Admin-only. Marks the key revoked (never deletes it, for the audit trail). A revoked key stops parsing immediately.

Owner subscription status (admin) GET

Admin-only. The owner's tier, status (active/inactive/none), and current period end. The dashboard reads this; the worker is the source of truth.