Start a credit top-up checkout

View as Markdown
Returns an embedded Stripe Checkout `clientSecret` for a pay-as-you-go credit top-up (amount entered by the customer in Checkout). The wallet is credited when the resulting invoice is paid. The customer may optionally save the card for future use; the first saved card becomes the default payment method automatically. Rejected with `409` while a subscription is active — subscription accounts don't draw on the wallet. 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
409
Conflict Error