Wallet

Get a card top-up

GET
/v1/wallet/top-ups/{id}

Where a card top-up stands: pending until Stripe confirms the payment, then paid once the wallet is credited, or failed. Also takes the Stripe Checkout session id the top-up was started with.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

The top-up id, or its Stripe Checkout session id (cs_...)

Length1 <= length <= 255

Response Body

Success

application/json
  1. response

Success

id*string
status*string

pending until Stripe confirms the payment, then paid (the wallet is credited) or failed (nothing was charged). A paid top-up later becomes refunded or disputed if the payment is refunded or a dispute is lost

Value in"pending""paid""failed""refunded""disputed"
amount*integer

Charged to the card, in cents

creditAmount*integer

Credited to the wallet, in cents; less than amount when the card fee is passed on

currency*"USD"
Value in"USD"
receiptUrl*|

Stripe’s own receipt link, once paid

createdAt*string

ISO 8601 timestamp

Formatdate-time
paidAt*|

When Stripe confirmed the payment; null until then

curl -X GET "https://example.com/v1/wallet/top-ups/wtp_01K6XJ4Q8ZT3M9R5V2B7WDHNCA"
{  "id": "wtp_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "status": "paid",  "amount": 10320,  "creditAmount": 10000,  "currency": "USD",  "receiptUrl": null,  "createdAt": "2026-10-07T11:04:31.000Z",  "paidAt": "2026-10-07T11:04:31.000Z"}