API Documentation
All API
Service
ATM Withdrawal ReservationSync
Version: v1
Version: v1
/api/v1/refund/atm/reservation/no-hce
Request Headers
Request Parameters
Response Headers
X-KM-Correlation-Id
string
Required
Length : 20
Transaction number for tracking trasncription
- Form : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7digit, Hex String
X-KM-Crypto-Key-Id
string
Optional
Length : 32
Data encryption/decryption key ID
- Given ID from creating the service provider's project
- If it is passed as a callback, the first key issued among the keys issued to the service provider is used.
Response Parameters
requestTime
string
Required
Length : 16
Reservation Request Time
- yyyyMMddHHmmssSSS
userId
number
Required
Min : 1 , Max : 9999999999999999999
User’s ID
- Unique user's ID granted after registration KONA PLATE platform
par
string
Required
Length : 27
Alternate PAN(Primary Account Number)
balance
number
Required
Min : 1 , Max : 1000000000
Balance of Card
fee
number
Required
Min : 1 , Max : 1000000000
Withdrawal Fee
reservedAmount
number
Required
Min : 1 , Max : 1000000000
Reserved Withdrawal Request Amount
otp
string
Required
Min : 1 , Max : 1000000000
One Time password
- otp Number (length : 8, Existence of Validity Period)
Response Code
Detailed classification and addition of error for unseccessful withfrawal
200
Error code
000_000
Message
Success
Description
Success
400
Error code
001_006
Message
Wallet user not found.
Description
회원이 아니거나 탈퇴한 회원인 경우
400
Error code
009_007
Message
Refund failed.
Description
환불 정책에 의한 환불 거절 상태
400
Error code
009_008
Message
Card balnace is less than refund amount.
Description
카드 잔액보다 환불 요청 금액이 큰 경우
400
Error code
009_006
Message
Invalid refund amount unit.
Description
요청 금액 단위가 유효하지 않은 경우
400
Error code
009_014
Message
Inactive card.
Description
카드가 ACTIVE하지 않음.
400
Error code
009_021
Message
Atm service not allow.
Description
해당 카드 상품 ATM 사용 불가
400
Error code
009_009
Message
Refundable amount not enough.
Description
환불 요청 금액이 10,000원 미만 인 경우.
400
Error code
009_005
Message
Refund balance is zero.
Description
환불 요청 금액이 0원인 경우.
400
Error code
009_019
Message
Year limit atm refund amount is over.
Description
연 출금 한도가 초과된 경우
Test Data
Request
Response
Click Try It!
to start a Request and see the Response here!