은행계좌를 통한 충전 취소

API Description

Doc. No. A8S1D2V1
API Title 충전 > 은행계좌를 통한 충전 취소
API Description 회원 계좌로 부터 충전된 거래를 취소하기 위해 사용합니다.
- 충전취소된 금액은 카드의 잔액에서 차감 후, 회원의 등록된 계좌로 취소 요청일+1 일에 입급처리 됩니다.
Protocol HTTP Interface Type SYNC
HTTP METHOD POST Request URL /api/v1/recharges/by-bank-accounts/no-hce/cancel
Data Encryption Request : NO / Response : YES

Request Parameter

Field Type Length MOC Description
sequenceId STRING 1~30 MANDATORY 관리번호
- 요청에 대해 응답을 받지 못했을 경우, 해당 관리번호로 결과를 확인하기 위한 입력 값으로 사용됩니다.
- 해당 번호는 Unique 해야 합니다.
userId NUMBER 1~999999999999 MANDATORY 회원 ID
- 회원가입 시 부여되는 회원의 고유 ID입니다.
nrNumber STRING 1~50 MANDATORY 거래 고유 번호.
- (충전) 거래 요청 시 응답으로 받은 값입니다.
oneTimeToken STRING 16 MANDATORY 일회용 Token
- 일회용 Token 발급 요청시 응답받은 값입니다.
dcvv STRING 3 MANDATORY DCVV
- 일회용 Token 발급 요청시 응답받은 값입니다.

Response Parameter

Field Type Length MOC Description
isPending BOOLEAN MANDATORY 충전 거래 대기 여부
- (충전취소) 거래 과정에서 네트워크 불안 등의 원인으로 PG로부터 정상 응답을 받지 못하는 경우 해당 값을 "true"로 응답합니다.
- 이와 같은 거래는 은행 또는 PG의 네트워크 상황에 따라 다소 시간이 걸릴 수 있으며, 지속적으로 PG에 해당 출금 이체의 성공 여부를 체크합니다.
- 성공할 경우, 카드 충전취소 거래를 완료하며 실패할 경우 충전취소실패로 처리합니다.
- 요청 당일에 한하여 5분단위로 계속 확인 합니다.
response OBJECT MANDATORY 응답 결과 값
└ code STRING 1~7 MANDATORY 응답 결과 코드
└ description STRING 1~255 MANDATORY 응답 결과 상세 설명

Response Code

HTTP Status Error code Message Description
프로토콜 항목의 "공통 Error Message 정보"에서 추가 확인 바랍니다.
400 007_001 Bank account not found 등록된 계좌가 없음
400 007_030 Cancellation not possible for this transaction 충전 취소가 불가능한 거래.
400 007_040 Cancel request for another method. 충전 취소할 충전 건의 충전 금액 지불 방식이 다른 경우
400 007_043 Cancellation request denied due to name mismatch. 시스템에 등록된 회원 이름과 은행계좌 소유자명이 다른 상태에서 취소 요청이 들어온 경우 발생한 에러.
회원의 개명 후, 시스템에 개명된 이름이 반영 된 경우, 고객 계좌로 충전 취소된 금액을 환불 처리 하기 위해서는, 계좌 등록을 새로 해야 함.

Example

Request


            

        

        

            

                
Response