Skip to main content

Transaction Registration (VAN)

Register payment information to invoke the authentication screen. Upon successful registration, the Authentication Window URL will be provided in the response.

info

Request​

Request URL
POST https://{API Domain}/easycheck/auth/paymentAuthReg.do
Content-type: application/json; charset=euc-kr
Note

Supports API Idempotency (See API Idempotency)

Parameters​

Field NameTypeLengthRequiredDescription
customerKeyString60Byte✅Simple Payment Member Unique Key
easypayVirtualNoString60Byte✅Payment Method Virtual Number selected by the customer
payMethodTypeCodeString2Byte✅Payment Method Type Code (See Payment Method Codes)
payMethodDetailCodeString3Byte✅Detailed Payment Method Code (See Card Codes)
shopTransactionIdString60Byte✅Merchant Transaction ID (API Idempotency Key)
shopOrderNoString40Byte✅Merchant Order Number
returnUrlString256Byte✅Merchant Return URL after authentication
Redirects to this URL (HTTPS only)
shopParameterString4000ByteMerchant Reserved Field (Do not include personal information)
Request Example
{    
"customerKey": "{Simple Payment Member Unique Key}",
"easypayVirtualNo": "{Payment Method Virtual Number}",
"payMethodTypeCode": "11",
"payMethodDetailCode": "026",
"shopTransactionId": "{API Idempotency Key}",
"shopOrderNo": "{Merchant Order Number}",
"returnUrl": "{Merchant Return URL}"
}

Response​

Parameters​

Field NameTypeLengthRequiredDescription
resCdString4Byte✅Result Code (Normal: “0000”)
resMsgString1000Byte✅Result Message
shopTransactionIdString60ByteReturns the same value sent in the request
authPageUrlString256ByteAuthentication Window URL (URL Encoded)
Response Example
{
"resCd": "0000",
"resMsg": "Success",
"shopTransactionId": "{API Idempotency Key}",
"authPageUrl": "{Authentication Window URL}"
}