Hướng dẫn này cho biết cách nạp số dư tài khoản qua API.
Mỗi yêu cầu sử dụng khóa API cá nhân của bạn từ bảng điều khiển tài khoản (cách lấy khóa API). Trong các ví dụ dưới đây, hãy thay YOUR_API_KEY bằng khóa của bạn. Để thanh toán bằng số dư tài khoản, dùng paymentId = 1.
⚠️ Bước cuối tạo một khoản thanh toán thực.
Bước 1 — Kiểm tra số dư hiện tại
Kiểm tra số dư tài khoản hiện tại.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get
Phản hồi
{
"status": "success",
"data": { "summ": 10 },
"errors": []
}
Bước 2 — Chọn phương thức thanh toán
Liệt kê các hệ thống thanh toán khả dụng và sao chép id bạn muốn dùng làm paymentId.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list
Phản hồi
{
"status": "success",
"data": {
"items": [
{ "id": "30", "name": "Visa / MasterCard" },
{ "id": "41", "name": "USDT (TRC-20)" },
{ "id": "29", "name": "PayPal" }
]
},
"errors": []
}
Bước 3 — Nạp số dư (tạo khoản thanh toán thực)
Nạp số dư với số tiền và paymentId. Phản hồi trả về URL thanh toán để hoàn tất.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/add
Nội dung yêu cầu
Tên | Loại | Mô tả |
summ | Number | Số tiền bạn muốn nạp. |
paymentId | Number | ID hệ thống thanh toán từ danh sách trên. |
Ví dụ
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/add
Phản hồi
{
"status": "success",
"data": {
"url": "https://proxy-seller.com/personal/pay/?ORDER_ID=595PAYMENT"
},
"errors": []
}