API 문서
전체 API
서비스
충전 및 충전취소 결과 확인동기
버전: v1
버전: v1
/api/v1/recharges/by-bank-account/result/inquiry
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
result
string
필수
최소 : 6 , 최대 : 9
충전/충전 취소 거래 결과
- COMPLETED
- 충전/충전 취소 거래 완료
- FAILED
- 충전/충전 취소 거래 실패
- PENDING
- 거래 과정에서 PG(쿠콘 또는 오픈뱅킹)에 고객 계좌로부터 출금 이체 요청 시, 네트워크 불안 등의 원인으로, PG로부터 정상적으로 응답을 받지 못하는 경우 은행 또는 PG의 상황에 따라. 다소 시간이 걸릴 수 있으며, 지속적으로 PG에 해당 출금 이체의 성공 여부를 체크합니다. 성공할 경우, 카드 충전 거래를 완료하며, 실패할 경우, 충전 실패 처리를 합니다.
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success
설명
성공
400
에러 코드
000_002
메시지
Invalid input parameter. sequenceId
설명
잘못된 요청, api의 request한 parameter가 부정확
400
에러 코드
007_009
메시지
Previous transaction not found.
설명
잘못된 요청, api의 request한 parameter가 부정확
400
에러 코드
007_009
메시지
Previous transaction not found.
설명
해당 sequenceId와 merchantId로 조회 되는 카드 충전/ 충전 취소 결과가 없음
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.