계좌이체 결제
결제 수단을 계좌이체로 확정하고, 구매자에게 안내할 입금 계좌 정보를 발급합니다.
POST
https://pay.apiacc.com/pay/{token}/bank요청 본문 없이 호출합니다. 결제를 bank_transfer로 잠그고, 결제 페이지에서 입력한 이름을 입금자명으로 사용하는 충전 요청을 생성합니다.
결제 수단은 한 번만 선택 가능
결제 수단이 확정되면
method가 잠깁니다. 이후 같은 결제에서 다른 결제 수단으로 전환할 수 없습니다.경로 파라미터
| 필드 | 타입 | 필수 | 제한 | 예시 |
|---|---|---|---|---|
token결제 생성 응답의 checkout_url에 포함된 공개 토큰입니다. | string | 필수 | — | "pub_xxx" |
curl -X POST "https://pay.apiacc.com/pay/pub_xxx/bank" \
--max-time 10응답
200계좌이체 정보 발급 성공
{
"payment": {
"id": "pay_xxx",
"ref": "order_1234",
"amount": 10000,
"status": "processing",
"method": "bank_transfer"
},
"bank": {
"bank_name": "국민은행",
"bank_account": "123456-04-987654",
"account_holder": "김판매",
"depositor": "홍길동"
},
"idempotent_replay": false
}depositor는 결제 생성 시 전달한 name 값입니다. 구매자는 반드시 이 이름으로 입금해야 정상적으로 매칭됩니다. 같은 토큰으로 다시 호출하면 idempotent_replay가 true인 채로 동일한 계좌 정보가 반환됩니다.
주요 오류
| 상태 | error | 설명 |
|---|---|---|
| 404 | payment_not_found | — |
| 409 | payment_complete | 이미 최종 상태로 확정된 결제입니다. |
| 409 | payment_processing | 다른 결제 수단이 이미 처리 중입니다. |
| 409 | payment_expired | — |
| 409 | payment_review_required | — |
| 409 | payment_method_locked | 이미 다른 결제 수단으로 확정되어 계좌이체로 전환할 수 없습니다. |
| 409 | bank_settings_required | 판매자가 계좌이체 결제 수단을 아직 설정하지 않았습니다. |
| 429 | rate_limit_exceeded | — |