Skip to main content
POST
Add credit

Authorizations

Authorization
string
header
required

Your Wixzel Voice API key: Authorization: Bearer wv_live_.... Keys are scoped; grant only what the integration needs.

Headers

Idempotency-Key
string
required
Required string length: 1 - 255

Body

application/json
amount_usd
number
required

Amount to add, in US dollars.

Required range: 5 <= x <= 10000
Example:

25

return_url
string<uri>

Where to send the customer after checkout.

Response

Pending top-up with a checkout URL

id
string
required
object
enum<string>
required
Available options:
topup
status
enum<string>
required
Available options:
pending,
completed,
failed,
refunded
amount_usd
number
required
credited_micros
integer | null
required

Micro-USD. 1_000_000 = $1.00.

Example:

194000

checkout_url
string | null
required

Send the customer here to pay.

created_at
string<date-time>
required

ISO 8601, always UTC.

Example:

"2026-09-01T12:00:00.000Z"