API 문서
전체 API
서비스
계좌 충전동기
버전: v1
버전: v1
/api/v1/recharges/by-bank-accounts/no-hce
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
nrNumber
string
필수
최소 : 1 , 최대 : 50
거래 고유 번호
isPending
boolean
필수
충전 거래 대기 여부
(충전) 거래 과정에서 네트워크 불안 등의 원인으로 PG로부터 정상 응답을 받지 못하는 경우 해당 값을 "true"로 응답합니다.
이와 같은 거래는 은행 또는 PG의 네트워크 상황에 따라 다소 시간이 걸릴 수 있으며, 지속적으로 PG에 해당 출금 이체의 성공 여부를 체크합니다.
성공할 경우, 카드 충전 거래를 완료하며 실패할 경우 충전실패로 처리합니다.
요청 당일에 한하여 5분단위로 계속 확인 합니다.
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
성공
400
에러 코드
000_002
메시지
Invalid input parameter. userId
설명
입력 파라미터 오류
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로 요청한 이력이 있을 경우 발생
전체 보기
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.
