การโอนจ่าย (Pay-out · เวียดนาม)

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

คำขอ

POST/v2.0/disbursement/pay-out

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

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/disbursement/pay-out
production: https://gateway.smilepayz.com/v2.0/disbursement/pay-out

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

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	M	String	รหัส (ดู วิธีการชำระเงิน)
cashAccount	M	String(32)	เลขบัญชีธนาคารผู้รับเงิน
receiver	M	Object	อ็อบเจ็กต์ผู้รับ (ดูโมเดล Receiver)
name	M	String	ชื่อเต็มผู้รับ (UTF-8)
phone	O	String	โทรศัพท์ผู้รับในรูปแบบท้องถิ่น
email	O	String	อีเมลผู้รับ
callbackUrl	O	String(256)	URL HTTPS แจ้งสถานะแบบอะซิงค์ สูงสุด 256 ตัวอักษร

---

ตัวอย่างเนื้อหา – คำขอ Pay-out:

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

{
    "orderNo": "2000102900000000000001",
    "purpose": "Payroll — Da Nang team",
    "merchant": {
        "merchantId": "20001"
    },
    "money": {
        "currency": "VND",
        "amount": 1000000
    },
    "paymentMethod": "VCB",
    "cashAccount": "9876543210123",
    "receiver": {
        "name": "Nguyen Van An",
        "phone": "84901234567",
        "email": "[email protected]"
    }
}

การตอบกลับ

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
accountNo	O	String	accountNo การชำระเงินหากเกตเวย์ส่งคืน
money	M	Object	สกุลเงิน และ จำนวนเงิน ของธุรกรรมนี้
currency	M	String	คงที่เป็น VND
amount	M	Number	Amount (integer only). ทศนิยมดูที่ Money
disbursementTime	M	String	รูปแบบ (yyyy-MM-ddTHH:mm:ss±HH:mm)
channel	M	Object	ข้อมูลช่องทาง (paymentUrl, qrString, …)
paymentMethod	M	String	รหัส (ดู วิธีการชำระเงิน)
cashAccount	M	String	เลขบัญชีธนาคารผู้รับเงิน
accountName	O	String	ชื่อเจ้าของบัญชี
status	O	String	ค่าสถานะคำสั่งซื้อหรือ สถานะการชำระเงิน

ตัวอย่างเนื้อหา – การตอบกลับ Pay-out:

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

{
    "code": "00",
    "message": "successful",
    "orderNo": "2000102900000000000001",
    "tradeNo": "1822000109e998347483949",
    "merchant": {
        "merchantId": "20001",
        "merchantName": "Smilepayz Demo Store",
        "accountNo": "2000124234782342"
    },
    "money": {
        "currency": "VND",
        "amount": 1000000
    },
    "disbursementTime": "2024-12-17T10:55:00+07:00",
    "channel": {
        "paymentMethod": "VCB",
        "cashAccount": "9876543210123",
        "accountName": "Nguyen Van An"
    },
    "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
money	M	Object	สกุลเงิน และ จำนวนเงิน ของธุรกรรมนี้
currency	M	String	คงที่เป็น VND
amount	M	Number	Amount (integer only). ทศนิยมดูที่ Money
status	M	String	ค่าสถานะคำสั่งซื้อหรือ สถานะการชำระเงิน

การตอบกลับ

สำคัญ

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

{
    "orderNo": "2000102900000000000001",
    "tradeNo": "1822000109e998347483949",
    "merchantId": "20001",
    "merchantName": "Smilepayz Demo Store",
    "subMerchantId": "",
    "subMerchantName": "",
    "paymentMethod": "VCB",
    "transactionTime": "2024-12-17T10:55:00+07:00",
    "money": {
        "currency": "VND",
        "amount": 1000000
    },
    "status": "SUCCESS"
}

SUCCESS