Skip to main content
POST
Top up your prepaid balance

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Headers

Idempotency-Key
string
required

Stable client-generated key (8-255 chars) that dedupes retried top-ups, so a repeated request returns the same payment session instead of charging twice.

Required string length: 8 - 255

Body

application/json
amount
integer
required

Amount to add to the wallet, in cents.

successUrl
string<uri>
required

Trusted-origin URL to redirect to after a successful payment.

cancelUrl
string<uri>
required

Trusted-origin URL to redirect to if the payment is cancelled.

currency
enum<string>
default:usd
Available options:
usd,
eur

Response

200 - application/json

Payment session created; redirect the caller to checkoutUrl to complete the charge.

data
object
meta
object