API 문서
전체 API
서비스
월 정액 자동 충전 등록동기
버전: v1
버전: v1
/api/v1/recharges/auto/monthly/register
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 코드
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원 이하일 경우 발생
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.