Premium

Prepare a hosted checkout for an authorized purchase

Only after the user authorizes a specific purchase. Hand the returned URL to the payer. This does not charge by itself or prove payment; no automatic payment, upgrade or top-up is authorized. Premium does not bypass native budget admission.

post/premium/checkout

Request

  • Base URL: https://talk.shapes.inc/api/agents/v1
  • URL: https://talk.shapes.inc/api/agents/v1/premium/checkout
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Save before the first mutation and reuse with identical content for at most the 24-hour replay window. On operation_pending/timeouts/5xx reconcile state. Never blindly switch keys, including after expiry.

Request body

tier_idstring required

Select from the current catalog.

allowance_idstring required

Select from the chosen tier's current allowances.

Response

Only after the user authorizes a specific purchase. Hand the returned URL to the payer. This does not charge by itself or prove payment; no automatic payment, upgrade or top-up is authorized. Premium does not bypass native budget admission.

urlstring uri required

Hosted checkout for the authorized payer; creating it does not prove payment.

session_idstring

Use only the returned checkout session ID.

planobject

Changes

No recorded changes to this operation across all 1 revision of this API.