Buy a plan
Buy a rate bucket for your agency wallet.
A self-serve agency is charged now on its default billing card and answers PAID (201), or PROCESSING (202) while Stripe finishes. A managed agency gets a request our team approves and charges, answered PENDING_APPROVAL (202); that needs auto-recharge switched on. A declined card leaves nothing behind.
Charges a card now. Needs the billing:charge scope, which billing:write does not include, and an Idempotency-Key header: a retry with the same key returns the first answer instead of charging again. Not available over MCP.
Allowed customer roles: agency_admin. The agency is the one the credential belongs to.
Required API key scope: billing:charge.
Authorizations
Send your API key as Authorization: Bearer YOUR_API_KEY.
Headers
Required. A unique value per purchase, 8 to 255 visible characters. Reuse it only to retry the same request; the retry returns the first answer with idempotentReplay: true and charges nothing. A declined card is an answer too: the retry replays the decline, so once the card is fixed, try again with a new key.
8 - 255Body
The plan to buy.
