Skip to main content
POST
/
wallet
/
fund
Add funds to wallet
curl --request POST \
  --url https://api.lava.so/v1/wallet/fund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payment_method_id": "<string>",
  "amount": "25.00"
}
'
{
  "status": "completed",
  "payment_id": "pay_abc123",
  "balance": "75.00"
}

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.