API Documentation
All API
Service
Transfer card balanceSync
Version: v1
Version: v1
/api/v1/transfer/balance
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
amount
number
Required
Value : 0
이관된 잔액
Response Code
Detailed classification and addition of error for unseccessful withfrawal
200
Error code
000_000
Message
Success.
Description
성공
400
Error code
000_003
Message
Missing required values. toCardNo
Description
입력 파라미터 오류 - `toCardNo` 입력 요청 정보가 null 인 경우
400
Error code
005_017
Message
Possible collection balance is zero.
Description
이관되는 카드 잔액이 0일 경우
400
Error code
005_018
Message
There is not enough balance to transfer.
Description
이관 요청하는 금액이 카드 잔액 보다 많을 경우
400
Error code
017_001
Message
Balance is over the max.
Description
이관 받는 카드의 잔액 한도 초과일 경우
400
Error code
017_002
Message
Failed to balance transfer.
Description
잔액 이관 실패
400
Error code
017_003
Message
Value transfer between same card.
Description
같은 카드 간에 잔액 이관을 요청할 경우
400
Error code
017_004
Message
Input affiliateId is not same as owner affiliateId.
Description
입력받은 affiliateId와 owner affiliateId가 다를 경우
400
Error code
017_005
Message
Product is not allowed collection.
Description
잔액 합치기 기능이 지원하지 않는 상품으로 요청할 경우
400
Error code
017_006
Message
Owner affiliate not found.
Description
해당 상품의 owner affiliateId가 존재하지 않을 경우
Show All
Test Data
Request
Response
Click Try It!
to start a Request and see the Response here!