การรับชำระเงิน (Pay-In · เวียดนาม)

API Pay-in ภูมิภาคเวียดนาม (VND) ดู วิธีการชำระเงิน

คำขอ

POST/v2.0/transaction/pay-in

เส้นทางคำขอ:

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/transaction/pay-in
production: https://gateway.smilepayz.com/v2.0/transaction/pay-in

พารามิเตอร์หัวข้อ

Field	จำเป็น	ประเภท	คำอธิบาย
Content-Type	M	String	เนื้อหาคำขอ application/json
X-TIMESTAMP	M	String	รูปแบบ: yyyy-MM-ddTHH:mm:ss±HH:mm (เช่น เวียดนาม ICT +07:00)
X-SIGNATURE	M	String	ลายเซ็นของเนื้อหา JSON (ดูเอกสาร Signature)
X-PARTNER-ID	M	String	Your merchantID

พารามิเตอร์เนื้อหา

Field	จำเป็น	ประเภท	คำอธิบาย
orderNo	M	String(32)	รหัสไม่ซ้ำของร้านค้า 6–32 อักขระอักษรและตัวเลข
purpose	M	String(64)	บันทึกถึงผู้จ่าย 1–64 ตัวอักษร UTF-8
merchant	M	Object	ห่อ merchantId และฟิลด์ sub-merchant ตามต้องการ
merchantId	M	String	merchantId Smilepayz สำหรับคำขอนี้
merchantName	O	String	ชื่อแสดงผลร้านค้า UTF-8
subMerchantId	O	String	รหัส sub-merchant
subMerchantName	O	String	ชื่อ UTF-8 สำหรับ subMerchantId
money	M	Object	สกุลเงิน และ จำนวนเงิน ของธุรกรรมนี้
currency	M	String	คงที่เป็น VND
amount	M	Number	Amount (integer only). ทศนิยมดูที่ Money
paymentMethod	O	String	รหัส (ดูเอกสาร วิธีการชำระเงิน)
expiryPeriod	O	Number	ExpiryPeriod, default 3600.
redirectUrl	O	String(256)	URL HTTPS หลังชำระเงิน สูงสุด 256 ตัวอักษร
callbackUrl	O	String(256)	URL HTTPS แจ้งสถานะแบบอะซิงค์ สูงสุด 256 ตัวอักษร

---

ตัวอย่างเนื้อหา – คำขอธุรกรรม:

Content-type: application/json
X-TIMESTAMP: 2020-12-17T10:55:00+07:00
X-SIGNATURE: 7MHd9v5/m9JeqmDZVwWBZUZ5J5...7120QnFEny7Qm7uQR1G0TWCh10fsU6nVxiRoeoQ==
X-PARTNER-ID: 20001

{
    "orderNo": "20011563d9094aa7d4d9e9b933bb",
    "purpose": "E-wallet top-up — HCMC",
    "merchant": {
        "merchantId": "20011"
    },
    "money": {
        "currency": "VND",
        "amount": 1000000
    },
    "paymentMethod": "W_MOMO",
    "redirectUrl": "https://www.example.com/success"
}

การตอบกลับ

HTTP (คำขอ)

Field	จำเป็น	ประเภท	คำอธิบาย
Content-Type	M	String	เนื้อหา application/json
X-TIMESTAMP	M	String	รูปแบบ: yyyy-MM-ddTHH:mm:ss±HH:mm

พารามิเตอร์เนื้อหา

Field	จำเป็น	ประเภท	คำอธิบาย
code	M	String	00 สำเร็จ ค่าอื่นคือข้อผิดพลาด
message	M	String	ข้อความผลลัพธ์ UTF-8 ที่อ่านได้
orderNo	M	String	รหัสไม่ซ้ำของร้านค้า 6–32 อักขระอักษรและตัวเลข
tradeNo	O	String	tradeNo Smilepayz สำหรับคำสั่งซื้อนี้
merchant	M	Object	ห่อ merchantId และฟิลด์ sub-merchant ตามต้องการ
merchantId	M	String	merchantId Smilepayz สำหรับคำขอนี้
merchantName	O	String	ชื่อแสดงผลร้านค้า UTF-8
subMerchantId	O	String	รหัส sub-merchant
subMerchantName	O	String	ชื่อ UTF-8 สำหรับ subMerchantId
money	M	Object	สกุลเงิน และ จำนวนเงิน ของธุรกรรมนี้
currency	M	String	คงที่เป็น VND
amount	M	Number	Amount (integer only). ทศนิยมดูที่ Money
transactionTime	M	String	yyyy-MM-ddTHH:mm:ss±HH:mm
channel	M	Object	ข้อมูลช่องทาง (paymentUrl, qrString, …)
paymentMethod	O	String	รหัส (ดู วิธีการชำระเงิน)
paymentUrl	M	String	URL เครื่องคิดเงินให้ผู้จ่ายเปิด
status	O	String	ค่าสถานะคำสั่งซื้อหรือ สถานะการชำระเงิน

Content-type: application/json
X-TIMESTAMP: 2020-12-17T10:55:00+07:00

{
    "code": "00",
    "message": "Successful",
    "orderNo": "20011563d9094aa7d4d9e9b933bb",
    "tradeNo": "1812001125042115424463245",
    "merchant": {
        "merchantId": "20011",
        "merchantName": "Smilepayz Demo Store",
        "accountNo": "11820011202403071031"
    },
    "money": {
        "currency": "VND",
        "amount": 1000000
    },
    "transactionTime": "2025-06-19T10:31:33+07:00",
    "channel": {
        "paymentMethod": "W_MOMO",
        "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1812001125042115424463245"
    },
    "status": "PROCESSING"
}

การแจ้งเตือน / callback

Callback signature ≠ request signature

อย่าใช้สูตร request ไปตรวจ X-SIGNATURE ของ callback ดู Callback Signature

HTTP (คำขอ)

Field	จำเป็น	ประเภท	คำอธิบาย
Content-Type	M	String	เนื้อหา application/json
X-TIMESTAMP	M	String	รูปแบบ: yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	ดู Callback Signature

พารามิเตอร์เนื้อหา

Field	จำเป็น	ประเภท	คำอธิบาย
orderNo	M	String	รหัสไม่ซ้ำของร้านค้า 6–32 อักขระอักษรและตัวเลข
tradeNo	M	String	tradeNo Smilepayz สำหรับคำสั่งซื้อนี้
merchantId	M	String	merchantId Smilepayz สำหรับคำขอนี้
merchantName	M	String	ชื่อแสดงผลร้านค้า UTF-8
subMerchantId	O	String	รหัส sub-merchant
subMerchantName	O	String	ชื่อ UTF-8 สำหรับ subMerchantId
paymentMethod	M	String	รหัส (ดู วิธีการชำระเงิน)
transactionTime	M	String	รูปแบบ: yyyy-MM-ddTHH:mm:ss
status	M	String	ค่าสถานะคำสั่งซื้อหรือ สถานะการชำระเงิน
money	M	Object	สกุลเงิน และ จำนวนเงิน ของธุรกรรมนี้
currency	M	String	คงที่เป็น VND
amount	M	Number	Amount (integer only). ทศนิยมดูที่ Money

การตอบกลับ

สำคัญ

ตอบกลับด้วยสตริง SUCCESS เท่านั้น

{
    "orderNo": "20011563d9094aa7d4d9e9b933bb",
    "tradeNo": "1812001125042115424463245",
    "merchantId": "20011",
    "merchantName": "Smilepayz Demo Store",
    "subMerchantId": "",
    "subMerchantName": "",
    "paymentMethod": "W_MOMO",
    "transactionTime": "2025-06-19T10:31:33+07:00",
    "status": "SUCCESS",
    "money": {
        "currency": "VND",
        "amount": 1000000
    }
}

SUCCESS