This guide shows you how to top up your account balance through the API.
Every request uses your personal API key from your account dashboard (how to get your API key). In the examples below, replace YOUR_API_KEY with your own key. To pay from your account balance, use paymentId = 1.
⚠️ The last step creates a real payment.
Step 1 — Check the current balance
Check your current account balance.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get
Response
{
"status": "success",
"data": { "summ": 10 },
"errors": []
}
Step 2 — Choose a payment method
List the available payment systems and copy the id you want to use as paymentId.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list
Response
{
"status": "success",
"data": {
"items": [
{ "id": "30", "name": "Visa / MasterCard" },
{ "id": "41", "name": "USDT (TRC-20)" },
{ "id": "29", "name": "PayPal" }
]
},
"errors": []
}
Step 3 — Replenish the balance (creates a real payment)
Replenish the balance with the amount and paymentId. The response returns a payment URL to complete the payment.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/add
Request body
Name | Type | Description |
summ | Number | The amount you want to add. |
paymentId | Number | Payment system ID from the list above. |
Example
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/add
Response
{
"status": "success",
"data": {
"url": "https://proxy-seller.com/personal/pay/?ORDER_ID=595PAYMENT"
},
"errors": []
}