Skip to main content
POST
Purchase wallet credits

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Headers

Idempotency-Key
string
required

Stable client-generated key so retries reuse the same session.

Required string length: 8 - 255

Body

application/json
amount
integer
required

Top-up amount in USD cents (above Stripe's per-currency minimum).

successUrl
string<uri>
required

Trusted Orbit URL to redirect to after successful payment.

cancelUrl
string<uri>
required

Trusted Orbit URL to redirect to if the customer cancels.

Response

200 - application/json

Checkout session created; redirect the customer to checkoutUrl.

data
object
meta
object