Transaction Registration

To invoke the payment screen, you must register the order information through this API and receive the Payment Window URL in the response.

Request

Request URL

POST https://{API Domain}/easytalkpay/v1/orders.do
Content-type: application/json; charset=euc-kr

Note

Supports API Idempotency (See API Idempotency)

Parameters

Field Name	Type	Length	Required	Description
vanTid	String	8Byte	✅	VAN Terminal ID
shopTransactionId	String	60Byte	✅	Merchant Transaction ID (API Idempotency Key)
shopReqDate	String	14Byte	✅	Request Date/Time (yyyyMMddHHmmss)
inflowPath	String	30Byte	✅	Payment Inflow Path (Fixed: "SHP")
shopOrderNo	String	40Byte	✅	Merchant Order Number (Must be a unique value)
productNm	String	500Byte	✅	Product Name
amount	Number		✅	Total Payment Amount (Including VAT)
tax	Number		✅	VAT (Set to 0 if tax-exempt)
returnUrl	String	1000Byte	✅	URL to return to after authentication is complete
completeUrl	String	1000Byte		URL to return to after Naver Pay approval Refer to Naver Pay Guide
mallNm	String	200Byte	✅	Merchant Name
bussNo	String	10Byte	✅	Merchant Business Registration Number (Numeric only)
noticeMsg	String	3000Byte		Merchant notice message displayed on the payment window

Request Example

{  
  "vanTid": "{VAN Terminal ID}", 
  "shopReqDate": "20230915121212", 
  "shopTransactionId": "{API Idempotency Key}", 
  "inflowPath": "SHP", 
  "shopOrderNo": "GDS30004", 
  "productNm": "May Tuition Fees", 
  "amount": 47000, 
  "tax": 4700, 
  "returnUrl": "{Merchant URL for Auth Completion}", 
  "completeUrl": "{Merchant URL for Naver Pay Approval Completion}", 
  "mallNm": "Elite Math", 
  "bussNo": "1178119949", 
  "noticeMsg": "Welcome to Elite Math. This is the tuition fee payment for student John Doe."
}

Response

Parameters

Field Name	Type	Length	Required	Description
resCd	String	4Byte	✅	Result Code (Success: “0000”)
resMsg	String	1000Byte	✅	Result Message
shopTransactionId	String	60Byte	✅	Returns the same value as sent in the request
authPageUrl	String	256Byte		Payment Window URL

Response Example

{
  "resCd": "0000",
  "resMsg": "Success",
  "shopTransactionId": "{Returns request value}",
  "authPageUrl": "{Payment Window URL}"
}