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 Name	Type	Length	Required	Description
requestTid	String	60Byte	✅	Merchant Request Unique ID (Must be unique for every request)
shopUserId	String	60Byte	✅	Customer ID managed by the Merchant
shopUserMail	String	50Byte	✅	Customer e-mail managed by the Merchant
certType	String	10Byte	✅	Authentication Type for identification (“CI” or “NONE”)
certValue	String	200Byte		Customer Auth Value. If certType is “CI”, send the customer's CI info as a HexString after SEED Encryption.
returnUrl	String	256Byte	✅	Merchant URL to return to after user registration. Redirects to this URL (HTTPS only).
shopParameter	String	4000Byte		Merchant 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 Name	Type	Length	Required	Description
resCd	String	4Byte	✅	Result Code (Normal: “0000”)
resMsg	String	1000Byte	✅	Result Message
registerTid	String	60Byte		Auth Registration Unique ID Required for Customer Key issuance
requestTid	String	60Byte		requestTid provided in the request Required for Customer Key issuance
isSignUpUser	Boolean			Subscription status. Subscribed: true, Not subscribed: false
easyPayCertPageUrl	String	256Byte		User 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}"
}