Simple Payment User Key (Customer Key)

Issue Customer Key

This API issues a unique Customer Key for a user who has completed the registration process. This key is mandatory for inquiring about payment methods, processing payments, and managing payment methods.

Request

Request URL

POST https://{API Domain}/easypay/user/customerkey/generation.do
Content-type: application/json; charset=euc-kr

Parameters

Field Name	Type	Length	Required	Description
requestTid	String	60Byte	✅	Merchant Request Unique ID (Sent during auth registration)
registerTid	String	60Byte	✅	Auth Registration Unique ID
certSeqNo	String	60Byte	✅	Identity Verification Sequence Number

Request Example

{  
  "requestTid": "{Merchant Request Unique ID}", 
  "registerTid": "{Auth Registration Unique ID}", 
  "certSeqNo": "{Identity Verification Sequence Number}"
}

Response

Parameters

Field Name	Type	Length	Required	Description
resCd	String	4Byte	✅	Result Code (Normal: “0000”)
resMsg	String	1000Byte	✅	Result Message
customerKey	String	60Byte		Simple Payment Customer Unique ID
shopUserId	String	60Byte		Customer ID managed by the Merchant

Response Example

{
  "resCd": "0000",
  "resMsg": "Success",
  "customerKey": "{Simple Payment Customer Unique ID}",
  "shopUserId": "{Customer ID managed by the Merchant}"
}   

---

Delete Customer Key (Expiration)

This API expires (deletes) the Customer Key issued to a registered user. Once expired, the key can no longer be used for payment inquiries or transactions.

Request

Request URL

POST https://{API Domain}/easypay/user/customerkey/expiration.do
Content-type: application/json; charset=euc-kr

Parameters

Field Name	Type	Length	Required	Description
customerKey	String	60Byte	✅	Simple Payment Member Unique Key
shopUserId	String	60Byte	✅	Customer ID managed by the Merchant

Request Example

{
  "customerKey": "{Simple Payment Member Unique Key}",
  "shopUserId": "{Customer ID managed by the Merchant}"
}

Response

Parameters

Field Name	Type	Length	Required	Description
resCd	String	4Byte	✅	Result Code (Normal: “0000”)
resMsg	String	1000Byte	✅	Result Message
isExpired	Boolean			Expiration Status (Expired: true, Not Expired: false)

Response Example

{
  "resCd": "0000",
  "resMsg": "Success",
  "isExpired": true
}