Skip to main content

User Auth Registration

This API allows you to request the registration of merchant customer information and receive the User Registration Window URL in the response.

Request​

Request URL
POST https://{API Domain}/easypay/cert/userCertReg.do
Content-type: application/json; charset=euc-kr

Parameters​

Field NameTypeLengthRequiredDescription
requestTidString60Byte✅Merchant Request Unique ID (Must be unique for every request)
shopUserIdString60Byte✅Customer ID managed by the Merchant
shopUserMailString50Byte✅Customer e-mail managed by the Merchant
certTypeString10Byte✅Authentication Type for identification (“CI” or “NONE”)
certValueString200ByteCustomer Auth Value. If certType is “CI”, send the customer's CI info as a HexString after SEED Encryption.
returnUrlString256Byte✅Merchant URL to return to after user registration.
Redirects to this URL (HTTPS only).
shopParameterString4000ByteMerchant Reserved Field (Do not include personal information).
Request Example
{  
"requestTid": "{Merchant Request Unique ID}",
"shopUserId": "{Customer ID managed by the Merchant}",
"shopUserMail": "{Customer Email}",
"certType": "CI",
"certValue": "{Customer Auth Value}",
"returnUrl": "{Merchant Return URL}",
"shopParameter": "{Merchant Custom Data}"
}

Response​

Parameters​

Field NameTypeLengthRequiredDescription
resCdString4Byte✅Result Code (Normal: “0000”)
resMsgString1000Byte✅Result Message
registerTidString60ByteAuth Registration Unique ID
Required for Customer Key issuance
requestTidString60ByterequestTid provided in the request
Required for Customer Key issuance
isSignUpUserBooleanSubscription status. Subscribed: true, Not subscribed: false
easyPayCertPageUrlString256ByteUser Registration Window URL
Response Example
{
"resCd": "0000",
"resMsg": "Success",
"registerTid": "{Auth Registration Unique ID}",
"requestTid": "{requestTid from request}",
"isSignUpUser": true,
"easyPayCertPageUrl": "{User Registration Window URL}"
}