Billing
POST
/v1/billing/checkoutCreate Checkout
Create a Stripe checkout session for plan upgrade. Returns a real Stripe Checkout URL when Stripe is configured, or a stub-checkout URL inside the console when it isn't (so the upgrade flow is demoable without wiring Stripe).
Bearer tokenscope: org memberoperation_id: billing.checkout
Authentication
Send Authorization: Bearer <token>. Admin token — create via POST /v1/orgs/{org_id}/tokens/admin. Org-wide scope, so keep it tightly held. Requests without a valid credential are rejected with 401.
SDK install
pip install znyx-sdknpm install @znyx/sdkCode samples
Request
curl -X POST "$ZNYX_API_URL/v1/billing/checkout?plan=growth" \ -H "Authorization: Bearer $ZNYX_TOKEN"
Response
application/json
Successful Response
null
Schema: any
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| plan#query | string | optional | - |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Response schema
any
Errors & what triggers them
| Code | Trigger | Fix |
|---|---|---|
| 401 | Missing or expired Authorization header. | - |
| 403 | Token does not have the required role (admin / editor). | - |
| 404 | Target resource does not exist in this org. | - |
| 422 | Request body failed validation. | - |