Start a checkout to save a card

View as Markdown

Returns an embedded Stripe Checkout clientSecret in setup mode. The customer enters card details in Checkout; on completion the card is saved to the account’s Stripe customer for top-ups and subscription billing, and appears in paymentMethods on GET /api/v1/billing. Not available during impersonation.

Authentication

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

Request

This endpoint expects an object.
returnUrlstringOptionalformat: "uri"
Where Checkout returns after completion. Defaults to the dashboard billing page.

Response

Embedded Checkout client secret.
clientSecretstring

Errors

401
Unauthorized Error