นักพัฒนา
เรียกครั้งเดียว callback ครั้งเดียว ลงบัญชีรายการเดียว
การเชื่อมต่อทั้งหมดคือ endpoint REST ที่คุณเซ็น callback ที่คุณตรวจ และสถานะที่ถามซ้ำได้เสมอ
สร้างการชำระเงิน
เซ็น JSON body ด้วย HMAC-SHA256 บน path — middleware ตัดคำนำหน้า /api ออกก่อนคำนวณ จึงต้องเซ็น /v2/payins ทั้งที่ POST ไปที่ /api/v2/payins
ตัวอย่างโค้ดใช้ api.example.com — endpoint จริงจะออกให้ตอน onboarding
create-payment.sh
curl -X POST https://api.example.com/v2/payins \
-H "Content-Type: application/json" \
-H "X-API-Key: <your-api-key>" \
-H "X-Timestamp: <unix-timestamp>" \
-H "X-Signature: <hmac-sha256-of-path>" \
-d '{
"merchant_ref_id": "unique-order-ref-id-2025001",
"currency_code": "THB",
"request_amount": 1000,
"customer_id": "0198cbc6-fd02-7459-a671-78c306d0a1ad",
"customer_account_id": "0198cbc7-35ec-7c8c-8994-d3ac3e7f5255",
"redirect_url": "https://merchant.example.com/payment/success"
}'{
"id": "0198cbff-db9b-7b6a-9f82-6a55fdfb6575",
"merchant_ref_id": "unique-order-ref-id-2025001",
"status": "pending",
"request_amount": 1000,
"paypage_url": "https://pay.example.com/pay/0198cbff-db9b-7b6a-9f82-6a55fdfb6575"
}จัดการ webhook — ยืนยันตัวตนและกันซ้ำ
เราส่งซ้ำจนกว่า server คุณจะตอบ HTTP 200 ลายเซ็นคำนวณจาก raw body การเอา JSON ที่ parse แล้วมา stringify ใหม่จะไม่ตรง
อ้างอิง
ขอบเขต API
| Endpoint | ใช้ทำอะไร |
|---|---|
| /v2/payins | สร้างรายการรับเงิน (แนะนำ) |
| /v1/payins/:id | อ่านรายการรับเงินรายการเดียว |
| /v2/payins/:id/cancel | ยกเลิกรายการที่ยังค้าง |
| /v1/payouts | สร้างรายการจ่ายออก |
| /v1/payouts/:id | อ่านรายการจ่ายออกรายการเดียว |
| /v1/settlements | ถอนเข้าบัญชีองค์กรตัวเอง |
| /v1/payins/:id/slip | ส่งสลิปการโอน |
| /me/balances | ยอดคงเหลือแยกตามสกุลเงิน |
| /me/limits | วงเงินของคุณ |
| /me/issues | แจ้งและติดตามปัญหา |
แซนด์บ็อกซ์
มี endpoint สำหรับ debug ของทั้งฝั่งรับเงินและจ่ายเงินแยกไว้ ให้ไล่ทดสอบการเชื่อมต่อได้ครบเส้นก่อนขึ้นจริง
endpoint จริงออกให้ตอน onboarding
สมัครบัญชีแล้วใบสมัครจะถูกตรวจก่อนเปิดใช้งาน — credential และ endpoint จริงจะออกให้เมื่อผ่านการอนุมัติ
ขอสิทธิ์เข้าใช้งาน