Hanzo
OpenapiBilling

Buy a plan with a card

Vaults the card (or reuses one already on file), charges the plan's FIRST period at the catalog price, and opens the subscription — one act, all of it…

POST /v1/billing/subscribe/card

Addresshttps://api.hanzo.ai/v1/billing/subscribe/card
MethodPOST
Operationpost_billing_subscribe_card
AuthAuthorization: Bearer $HANZO_API_KEY

Vaults the card (or reuses one already on file), charges the plan's FIRST period at the catalog price, and opens the subscription — one act, all of it server-side.

There is NO AMOUNT in the request. level picks which of the plan's published prices to buy at — an index, never a number — so what the card is charged is decided by the catalog and underpaying cannot be expressed.

A fresh sale answers 201 with the receipt. An identical retry answers 200 with the FIRST sale's body, byte for byte, so a client cannot read a replay as a second subscription having been opened. A caller already on a paid plan is 409 rather than charged again.

Request

The document declares no body for POST /v1/billing/subscribe/card. The handler is typed in cloud but its shape is not yet emitted, so the fields are not listed here — ask the MCP door's describe for post_billing_subscribe_card, which answers from the running route.

Response

The document declares no response body for this operation. It answers 200 on success and the platform error shape on failure — see Errors.

Examples

hanzo billing subscribe card

Billing API · All Hanzo APIs · Interactive reference

How is this guide?

On this page