UnknownPay Merchant API
UnknownPay เป็นแพลตฟอร์มรับ-จ่ายเงิน (Payment Aggregator) ที่ให้ร้านค้าเชื่อมต่อแบบ Server-to-Server (S2S) จากเซิร์ฟเวอร์ของร้านค้าโดยตรง เพื่อ:
UnknownPay เป็นแพลตฟอร์มรับ-จ่ายเงิน (Payment Aggregator) ที่ให้ร้านค้าเชื่อมต่อแบบ Server-to-Server (S2S) จากเซิร์ฟเวอร์ของร้านค้าโดยตรง เพื่อ:
- รับเงินเข้า (Deposit) จากลูกค้าผ่าน PromptPay QR หรือ Bank Transfer แล้วเครดิตเข้ายอดร้านค้าอัตโนมัติเมื่อจับคู่ยอดสำเร็จ
- ถอนเงินออก (Withdrawal / Payout) จากยอดคงเหลือของร้านค้าไปยังบัญชีปลายทางที่ระบุ
- รับแจ้งสถานะแบบ near real-time ผ่าน Webhook โดยไม่ต้อง poll
Portal ใช้สำหรับ "ตั้งค่า" (ออก API key, ตั้ง webhook) ส่วน S2S API ใช้สำหรับ "ทำธุรกรรมจริง" ด้วย API key + HMAC signature — เป็นคนละส่วนกัน
3 เรื่องที่ต้องจำก่อนเขียนโค้ดบรรทัดแรก
เงินทุก field บน wire เป็นสตริงบาททศนิยม 2 ตำแหน่ง เช่น
"100.50" — ไม่ใช่ตัวเลข (100.5) และไม่ใช่สตางค์ (10050) ส่งผิดหน่วยคือบั๊กระดับ 100 เท่า- เงิน = สตริงบาท 2 ตำแหน่ง เช่น
"100.50" - Secret แสดงครั้งเดียว (show-once) ทั้ง API secret และ Webhook signing secret — คัดลอกเก็บทันที
- ต้องเซ็น HMAC-SHA256 ทุก request (
X-Api-Key+X-Signature+X-Timestamp) — ไม่มีลายเซ็น =401