은행계좌를 통한 충전

API Description

Doc. No. A8S1D1V1
API Title 충전 > 은행계좌를 통한 충전
API Description 회원에 등록된 계좌를 이용하여 선불카드의 잔액으로 충전을 처리 합니다.
- (충전) 거래데이터를 위한 일회용 Token을 발급받아야 합니다.
Protocol HTTP Interface Type SYNC
HTTP METHOD POST Request URL /api/v1/recharges/by-bank-accounts/no-hce
Data Encryption Request : NO / Response : NO

Request Parameter

Field Type Length MOC Description
sequenceId STRING 1~30 MANDATORY 관리번호
- 요청에 대해 응답을 받지 못했을 경우, 해당 관리번호로 결과를 확인하기 위한 입력 값으로 사용됩니다.
- 해당 번호는 Unique 해야 합니다.
userId NUMBER 1~999999999999 MANDATORY 회원 ID
- 회원가입 시 부여되는 회원의 고유 ID입니다.
amount NUMBER 1~999999999999 MANDATORY 충전 요청 금액
oneTimeToken STRING 16 MANDATORY 일회용 Token
- 일회용 Token 발급 요청시 응답받은 값입니다.
dcvv STRING 3 MANDATORY DCVV
- 일회용 Token 발급 요청시 응답받은 값입니다.
merchantId STRING 15 MANDATORY 가맹점 ID
- 가맹점에 부여한 고유 식별 값입니다.
reqAspId STRING 15 OPTIONAL 충전 요청한 ASP ID
- reqAspId 가 존재하면 reqUserId도 필수
reqUserId STRING 1~999999999999 OPTIONAL 충전 요청한 회원 ID
회원 ID
- 회원가입 시 부여되는 회원의 고유 ID입니다.
- reqUserId가 존재하면 reqAspId도 필수

Response Parameter

Field Type Length MOC Description
nrNumber STRING 1~50 MANDATORY 거래 고유 번호
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 002_043 Bank account problem. 은행 계좌에 문제가 있음. 은행에 문의
400 007_001 Bank account not found. 등록된 계좌가 없음
400 007_002 Inconsistent requested benefit. 요청한 혜택 정보(인센티브)와 충전 시점에 적용할 혜택 정보가 다를 경우 발생
400 007_003 Credit limit exceeded. 코나카드의 승인서버로부터 금액(한도) 초과로 승인 거절
400 007_004 Withdraw failure from PG. PG 에서 출금 이체 실패
400 007_005 Account charge request while proceeding. 계좌로 충전하기 거래가 진행 중인 상태에서 계좌로 충전하기 요청이 유입되었을 경우 발생
400 007_006 Account charge request while proceeding auto charge. 결제 시 자충으로 충전 거래가 진행 중인 상태에서 계좌로 충전하기 요청이 유입되었을 경우 발생
400 007_007 Recharge amount should be more than zero. 충전 요청한 금액이 0원 이하일 경우 발생
400 007_008 Same sequenceId already exists. 같은 seqId로 요청한 이력이 있을 경우 발생
400 007_018 Merchant error. 가맹점 오류
400 007_022 Invalid one time token. 유효하지 않은 one time token으로 충전 시도한 경우

Example

Request


            

        

        

            

                
Response