Skip to main content
POST
Add funds to wallet

Authorizations

Authorization
string
header
required

Bearer token authentication used for standard API calls. Format: 'Bearer YOUR_API_KEY'

Body

application/json
payment_method_id
string
required

ID of the payment method to charge. Use the List payment methods endpoint to get available IDs.

amount
string
required

Amount in USD to add, as a decimal string. Minimum $10, maximum $10,000.

Example:

"25.00"

Response

Payment processed

status
enum<string>

Payment status. "completed" means funds were added immediately. "requires_action" means 3D Secure verification is needed.

Available options:
completed,
requires_action
payment_id
string

Unique identifier for this payment

balance
string

New wallet balance after funding (only present when status is "completed")

Example:

"75.00"

redirect_url
string

URL for 3D Secure verification (only present when status is "requires_action"). Open in a browser to complete.