Billing

Approve a wallet top-up with hosted checkout or a shared payment token

Bound to the authenticated workspace. Available to email/social customers without a phone identity. Owner approval is required before payment. Only a signed matching Stripe webhook creates purchased funds. Browser welcome credit cannot fund numbers, PSTN or SMS. The existing URL is retained for pending-payment retries; it does not provide headless signup.

post/v1/agent/onboarding/headless/payments

Request

  • Base URL: https://api.skysay.ai
  • URL: https://api.skysay.ai/v1/agent/onboarding/headless/payments
  • Auth: HTTP bearer

Request body

amount_minorinteger required

Top-up in the wallet currency's minor units; current server top-up bounds apply.

currencystring required

Exact owner-approved currency; must match the workspace wallet reported by account_overview.

idempotency_keystring required

Opaque key unique to this purchase. Retry the same key and parameters after uncertain outcomes; never include payment credentials.

method'card_checkout' | 'shared_payment_token' required
payment_approvedboolean

True only after the owner explicitly approves this amount and currency for purchased Skysay calling credit. Scope consent is not purchase approval. Optional while requesting SPT approval metadata.

request_challengeboolean

For SPT, return 402 with amount/currency/Stripe seller profile for a compatible wallet to request owner approval. This is JSON metadata, not MPP, native checkout or MCP elicitation.

shared_payment_tokenstring

Granted spt_ token approved by the owner for this seller and amount. Omit when requesting the challenge. Never submit card numbers.

Response

Payment result; pending is not wallet credit

amount_minorinteger
checkout_urlstring uri
currencystring
next_actionstring
payment_idstring
statusstring
wallet_credit_timingstring

Changes

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