API 문서
전체 API
서비스
계좌 충전취소동기
버전: v1
버전: v1
/api/v1/recharges/by-bank-accounts/no-hce/cancel
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
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_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.
설명
시스템에 등록된 회원 이름과 은행계좌 소유자명이 다른 상태에서 취소 요청이 들어온 경우 발생한 에러.
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.