API 문서
전체 API
서비스
ATM 출금 예약동기
버전: v1
버전: v1
/api/v1/refund/atm/reservation/no-hce
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
requestTime
string
필수
길이 : 16
예약 요청 시각
- 형식 : yyyyMMddHHmmssSSS
userId
number
필수
최소 : 1 , 최대 : 9999999999999999999
회원 ID
- 회원가입 시 부여되는 회원의 고유 ID입니다.
par
string
필수
길이 : 27
보안을 위한 16자리 카드번호의 대체 카드번호
balance
number
필수
최소 : 1 , 최대 : 1000000000
카드 잔액
fee
number
필수
최소 : 1 , 최대 : 1000000000
출금 수수료
reservedAmount
number
필수
최소 : 1 , 최대 : 1000000000
예약된 출금 요청 금액
otp
string
필수
최소 : 1 , 최대 : 1000000000
채번된 One Time password
- otp Number (length : 8, 유효시간 존재)
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success
설명
성공 테스트
400
에러 코드
001_006
메시지
Wallet user not found.
설명
회원이 아니거나 탈퇴한 회원인 경우
400
에러 코드
009_007
메시지
Refund failed.
설명
환불 정책에 의한 환불 거절 상태
400
에러 코드
009_008
메시지
Card balnace is less than refund amount.
설명
카드 잔액보다 환불 요청 금액이 큰 경우
400
에러 코드
009_006
메시지
Invalid refund amount unit.
설명
요청 금액 단위가 유효하지 않은 경우
400
에러 코드
009_014
메시지
Inactive card.
설명
카드가 ACTIVE하지 않음.
400
에러 코드
009_021
메시지
Atm service not allow.
설명
해당 카드 상품 ATM 사용 불가
400
에러 코드
009_009
메시지
Refundable amount not enough.
설명
환불 요청 금액이 10,000원 미만 인 경우.
400
에러 코드
009_005
메시지
Refund balance is zero.
설명
환불 요청 금액이 0원인 경우.
400
에러 코드
009_019
메시지
Year limit atm refund amount is over.
설명
연 출금 한도가 초과된 경우
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.