Skip to main content
POST
Create a crypto balance top-up

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Headers

Idempotency-Key
string
required

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

Required string length: 8 - 255

Body

application/json
amount
integer
required

Top-up amount in USD cents (minimum 100 = $1.00).

Required range: x >= 100
successUrl
string<uri>
required

Trusted Orbit URL the payment provider redirects to on confirmation.

cancelUrl
string<uri>
required

Trusted Orbit URL the payment provider redirects to on close.

currency
enum<string>
default:usd

Wallet currency; only USD is supported today.

Available options:
usd

Response

200 - application/json

Crypto invoice created; open checkoutUrl and poll intentId for status.

data
object
meta
object