เชื่อมต่อครั้งแรก
ให้ครบทั้งฝากและถอน

ดาวน์โหลดสองไฟล์ไว้ในโฟลเดอร์เดียวกัน

node --version

ควรได้ v20 หรือสูงกว่า · ดาวน์โหลด Node.js

node sandbox.cjs

เปิด Sandbox Console — 127.0.0.1:4545 ↗

node merchant-example.cjs

เปิด เว็บร้านตัวอย่าง — 127.0.0.1:4546 ↗ แล้วกด ตรวจ API จาก backend

ถ้าจะใช้ backend ของคุณเอง

เปิด “แสดงค่าตั้งค่า Test” ใน Sandbox Console แล้วนำสามค่านี้ไปตั้งฝั่งเซิร์ฟเวอร์

1. ใน Sandbox Console ใส่ Webhook URL ด้านล่าง แล้วกด บันทึก URL
2. กด ส่ง Test Webhook
3. ดู delivery ได้ delivered / HTTP 200 และเว็บร้านแสดง ✓ Test webhook

http://127.0.0.1:4546/webhook

ตัวอย่างร้านใช้ X-Gateway-Signature, อ่านสถานะซ้ำผ่าน API และตอบ 2xx หลังบันทึกสำเร็จ ปุ่มส่งซ้ำใช้ทดสอบว่าร้านไม่ลงยอดซ้ำ

1. ในเว็บร้านตัวอย่าง เลือก Deposit จำนวน 500 บาท แล้วกดสร้างรายการ
2. ควรได้ HTTP 201, payment_id และสถานะ pending
3. ไป Sandbox Console หาเลขอ้างอิงเดียวกัน แล้วกด paid
4. กลับเว็บร้าน ตรวจออเดอร์เป็น paid และยอดลูกค้าเพิ่ม 500 บาทเพียงครั้งเดียว

{
  "amount": 500,
  "merchant_ref": "deposit-order-001"
}

Headers: X-Api-Key, Content-Type: application/json, Idempotency-Key: deposit-order-001

ทดสอบให้ครบสามสถานการณ์

ตรวจข้อความจริงได้ที่ “Webhook ที่ผ่านการตรวจ” ในเว็บร้าน: payload.late มาจาก webhook ที่ตรวจลายเซ็นแล้ว ไม่อยู่ในผล GET ถ้าข้อมูลเก่าไม่มี payload ให้กดส่ง webhook เดิมซ้ำจาก Sandbox เพื่อเก็บหลักฐาน

ค่าธรรมเนียมตัวอย่าง 1.6%: ฝาก 500 → ยอดร้านใน Sandbox เพิ่ม 492 บาท ส่วนยอดลูกค้าในตัวอย่างเพิ่ม 500 บาท

1. ในเว็บร้าน เลือก Withdraw จำนวน 500 บาท ใช้เลขอ้างอิงใหม่
2. สร้างรายการ ควรได้ HTTP 202 และ queued เว็บร้านกันยอดลูกค้าไว้ 500 บาท
3. ใน Sandbox Console กด paid แล้วกลับไปตรวจออเดอร์สำเร็จ โดยไม่หักยอดลูกค้าซ้ำ
4. สร้างรายการใหม่เพื่อทดสอบ rejected และ unknown → paid

{
  "amount": 500,
  "merchant_ref": "withdraw-order-001",
  "recipient": {
    "type": "account", "bank_code": "004", "account_no": "0012345678",
    "account_name": "Example Recipient", "given_name": "Example", "surname": "Recipient",
    "address_country": "TH", "address_city": "Bangkok", "address_street": "1 Example Road",
    "tax_id": "1234567890123", "email": "recipient@example.com"
  }
}

ทดสอบยอดร้านไม่พอผ่าน backend ของคุณด้วยจำนวนที่เกินยอด Sandbox หรือกันยอดร้านด้วยรายการ queued เพิ่มก่อน ค่าถอนตัวอย่าง 0.2%: ถอน 500 → กันยอดร้าน 501 บาท ปุ่มเติมยอดจำลองเพิ่มเฉพาะยอดร้านใน Sandbox

เปลี่ยนไป Production อย่างไร

1. รับ production URL, API key, webhook secret, เรท และสิทธิ์ฝาก/ถอนของร้านจากผู้ดูแล
2. ตั้งค่าเหล่านี้ใน backend ที่ deploy แล้ว พร้อม HTTPS Webhook URL และ IP allowlist ตามที่ร้านใช้
3. ใช้ฐานข้อมูลและรายการเงินจริงแยกจากข้อมูลทดลอง แล้วทดสอบรายการจริงตามแผนที่ตกลงกับผู้ดูแล