Buy credits
Starts a credit purchase and returns the provider checkout to send the customer to.
purchase_reference is your own idempotency key: reusing one returns the existing purchase rather than charging again, and it is what the status endpoint takes afterwards. An account with no subscription returns a 422 with type: "unlinked_stripe_customer".
Authorizations
This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.
Path Parameters
The numeric ID of the account
Body
How much to buy, within the top_up_limits the wallet reports.
5000
Your own idempotency key. Reusing one returns the existing purchase instead of charging again, and it is also what the status endpoint takes.
"docs-example-top-up-1"
Response
Success
A URL into the payment provider's own hosted flow. What sits behind that URL is the provider's, not ours — its appearance, its steps and the shape of anything it returns can change without a change here. Treat the URL as short-lived and redirect to it rather than storing it.
Version of this payload's shape.
The account.
Where this answer came from and how current it is. Billing reads several systems, so every response says which one it used — treat state other than fresh as a reason to be careful with the numbers rather than a failure.