Skip to content

Top up wallet

POST
/v1/wallets/{wallet_id}/top_up

Top up a wallet with credits.

wallet_id
required
Wallet Id
string format: uuid
WalletTopUp
object
credits
required
Any of:
number
> 0
source
Source
string
default: manual /^(manual|interval|threshold)$/

Successful Response

WalletResponse
object
id
required
Id
string format: uuid
customer_id
required
Customer Id
string format: uuid
name
Any of:
string
code
Any of:
string
status
required
Status
string
balance_cents
required
Balance Cents
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
credits_balance
required
Credits Balance
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
consumed_amount_cents
required
Consumed Amount Cents
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
consumed_credits
required
Consumed Credits
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
rate_amount
required
Rate Amount
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
currency
required
Currency
string
expiration_at
Any of:
string format: date-time
priority
required
Priority
integer
created_at
required
Created At
string format: date-time
updated_at
required
Updated At
string format: date-time

Invalid top-up amount or wallet state

Unauthorized – invalid or missing API key

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object