API ReferenceTop ups
Start a wallet top-up
Creates a top-up. With Stripe configured this returns a checkoutUrl to complete payment; the wallet is credited when checkout succeeds (listen for the wallet.credited webhook). In dev fake-payments mode the top-up settles instantly.
Authorization
apiKey AuthorizationBearer <token>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/v1/topups" \ -H "Content-Type: application/json" \ -d '{ "amountCents": 1000 }'{ "topup": { "id": "string", "amountCents": 0, "currency": "string", "provider": "string", "status": "string", "createdAt": "string", "completedAt": "string" }, "checkoutUrl": "string", "paymentsMode": "string"}