이 가이드는 API로 계정 잔액을 충전하는 방법을 설명합니다.
모든 요청은 계정 대시보드의 개인 API 키를 사용합니다 (API 키 발급 방법). 아래 예시에서 YOUR_API_KEY를 본인의 키로 바꾸세요. 계정 잔액으로 결제하려면 paymentId = 1을 사용하세요.
⚠️ 마지막 단계에서 실제 결제가 생성됩니다.
1단계 — 현재 잔액 확인
현재 계정 잔액을 확인하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get
응답
{
"status": "success",
"data": { "summ": 10 },
"errors": []
}
2단계 — 결제 수단 선택
사용 가능한 결제 시스템을 조회하고 paymentId로 사용할 id를 복사하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list
응답
{
"status": "success",
"data": {
"items": [
{ "id": "30", "name": "Visa / MasterCard" },
{ "id": "41", "name": "USDT (TRC-20)" },
{ "id": "29", "name": "PayPal" }
]
},
"errors": []
}
3단계 — 잔액 충전(실제 결제 생성)
금액과 paymentId로 잔액을 충전하세요. 응답으로 결제를 완료할 결제 URL이 반환됩니다.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/add
요청 본문
이름 | 유형 | 설명 |
summ | Number | 충전할 금액. |
paymentId | Number | 위 목록의 결제 시스템 ID. |
예시
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/add
응답
{
"status": "success",
"data": {
"url": "https://proxy-seller.com/personal/pay/?ORDER_ID=595PAYMENT"
},
"errors": []
}