API Documentation
All API
Service
Issuance of Disposable TokenSync
Version: v3
Version: v3
Version: v2
Version: v1
/api/v2/payment/generate/onetimetoken
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
oneTimeToken
string
Required
Length : 16
Disposable Token
dcvv
string
Required
Length : 3
DCVV
Dynamic CVV (Verification Code)
expiryTime
number
Required
Min : 1 , Max : 9999999999999
Valid time of disposable Token issued
- unit : ms
Response Code
Detailed classification and addition of error for unseccessful withfrawal
200
Error code
000_000
Message
Success
Description
Success
400
Error code
006_001
Message
CardNo not found.
Description
Not available to find the card matching.
400
Error code
006_002
Message
Invalid cardNo.
Description
Incorrect Card Number
400
Error code
006_003
Message
One time token generation failed.
Description
Failed to issue disposable token
400
Error code
006_031
Message
One time token reissue failed.
Description
일회용 token 재발급 실패
Test Data
Request
Response
Click Try It!
to start a Request and see the Response here!