충전 요청
은행 입금을 통한 자동충전 요청을 생성합니다.
POST
https://bank.apiacc.com/request새로운 충전 요청을 생성합니다. 생성된 요청은 pending 상태이며, 실제 입금이 확인되면 충전 확인 API로 승인됩니다.
요청 본문
| 필드 | 타입 | 필수 | 제한 | 예시 |
|---|---|---|---|---|
amount충전 요청 금액. KRW 정수입니다. | integer | 필수 | 최소 충전 금액(기본 1,000원) 이상 | 10000 |
depositor실제 계좌에 입금할 입금자명입니다. | string | 필수 | — | "홍길동" |
platform요청을 생성한 서비스 식별자입니다. 예: my-service, shopping-mall, game-server | string | 필수 | — | "my-service" |
ref플랫폼에서 생성한 고유 주문 번호입니다. 같은 platform과 ref를 재사용하지 마세요. | string | 필수 | — | "order_1234" |
curl -X POST "https://bank.apiacc.com/request" \
-H "Authorization: Bearer $BANK_API_KEY" \
-H "Content-Type: application/json" \
--max-time 10 \
-d '{
"amount": 10000,
"depositor": "홍길동",
"platform": "my-service",
"ref": "order_1234"
}'응답
201충전 요청 생성 성공
{
"charge": {
"id": "chg_example123",
"amount": 10000,
"depositor": "홍길동",
"platform": "my-service",
"ref": "order_1234",
"status": "pending",
"requested_at": "2026-08-15T03:00:00Z",
"expires_at": "2026-08-15T03:03:00Z"
}
}같은 platform/ref가 이미 처리된 요청이면 멱등 응답이 반환될 수 있습니다.
멱등 응답 예시
{
"charge": {
"id": "chg_example123",
"status": "approved"
},
"idempotent_replay": true
}주요 오류
| 상태 | error |
|---|---|
| 400 | invalid_amount |
| 400 | invalid_depositor |
| 400 | invalid_platform |
| 400 | invalid_ref |
| 409 | pending_charge_exists |
| 429 | cooldown_active |
| 429 | rate_limit_exceeded |