Skip to main content

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 NameTypeLengthRequiredDescription
vanTidString8Byte✅VAN Terminal ID
shopTransactionIdString60Byte✅Merchant Transaction ID (API Idempotency Key)
shopReqDateString14Byte✅Request Date/Time (yyyyMMddHHmmss)
inflowPathString30Byte✅Payment Inflow Path (Fixed: "SHP")
shopOrderNoString40Byte✅Merchant Order Number (Must be a unique value)
productNmString500Byte✅Product Name
amountNumber✅Total Payment Amount (Including VAT)
taxNumber✅VAT (Set to 0 if tax-exempt)
returnUrlString1000Byte✅URL to return to after authentication is complete
completeUrlString1000ByteURL to return to after Naver Pay approval
Refer to Naver Pay Guide
mallNmString200Byte✅Merchant Name
bussNoString10Byte✅Merchant Business Registration Number (Numeric only)
noticeMsgString3000ByteMerchant 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 NameTypeLengthRequiredDescription
resCdString4Byte✅Result Code (Success: “0000”)
resMsgString1000Byte✅Result Message
shopTransactionIdString60Byte✅Returns the same value as sent in the request
authPageUrlString256BytePayment Window URL
Response Example
{
"resCd": "0000",
"resMsg": "Success",
"shopTransactionId": "{Returns request value}",
"authPageUrl": "{Payment Window URL}"
}