Example Webhook Payloads
View sample webhook payloads for different event types
Idempotency Required
Webhook อาจถูกส่งซ้ำหลายครั้ง โปรดออกแบบระบบให้รองรับการส่งซ้ำ (Idempotent) เพื่อป้องกันการประมวลผลข้อมูลซ้ำ
Select Event Type
เลือกประเภท Webhook Event ที่ต้องการดูตัวอย่าง
Old Format
Legacy Format - ไม่มี type และ transaction
{
"event": "PAYMENT_PAID",
"data": {
"payment": {
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"txid": "0x00",
"chain": "offchain",
"amount": "1000",
"status": "SUCCESS",
"address": "0x00",
"fx_rate": {
"THB": 1000.23,
"USD": 31.583
},
"network": "mainnet",
"seq_num": 26500136,
"agent_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"lifetime": 900,
"order_id": "MERCHANT ORDER ID",
"source_id": "payment",
"created_at": "2025-12-12T05:14:44.800Z",
"expired_at": "2025-12-12T05:29:44.701Z",
"updated_at": "2025-12-12T05:15:26.686Z",
"to_currency": "THB",
"from_currency": "THB",
"payment_amount": 1000.23,
"payment_status": "PAYMENT_PAID",
"merchant_amount": 986.23,
"payer_paid_amount": 1000.23,
"payer_bank_provider": "SCB",
"payer_paid_currency": "THB",
"payer_bank_account_name": "นางสาว XXXXX XXXXX",
"payer_bank_account_number": "03912838390",
"order_user_reference": "HH123456789"
}
}
}New Format
Current Format - รวม type, failed_reason และ transaction
{
"event": "PAYMENT_PAID",
"type": "FIAT",
"data": {
"payment": {
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"txid": "0x00",
"chain": "offchain",
"amount": "500.00",
"status": "SUCCESS",
"address": "0x00",
"fx_rate": {
"THB": 500.02,
"USD": 15.944
},
"network": "mainnet",
"seq_num": 44120291,
"agent_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"lifetime": 900,
"order_id": "MERCHANT ORDER ID",
"source_id": "payment",
"created_at": "2026-01-16T07:02:31.142Z",
"expired_at": "2026-01-16T07:17:31.110Z",
"updated_at": "2026-01-16T07:04:20.621Z",
"to_currency": "THB",
"from_currency": "THB",
"failed_reason": "UNKNOWN",
"payment_amount": 500.02,
"payment_status": "PAYMENT_PAID",
"merchant_amount": 493.02,
"payer_paid_amount": 500.02,
"payer_bank_provider": "KBANK",
"payer_paid_currency": "THB",
"payer_bank_account_name": "นางสาว XXXXX XXXXX",
"payer_bank_account_number": "0401586148",
"order_user_reference": "HH123456789"
},
"transaction": {
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"fee": 1.4,
"type": "RECEIVE",
"amount": 500.02,
"status": "COMPLETED",
"to_bank": "SCB",
"tx_date": "16/01/2026 14:02",
"currency": "THB",
"order_id": "MERCHANT ORDER ID",
"from_bank": "KBANK",
"from_name": "นางสาว XXXXX XXXXX",
"reference": "35690374",
"source_id": "payment",
"created_at": "2026-01-16T07:02:31.142Z",
"fee_amount": 7.000279999999999,
"payment_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"updated_at": "2026-01-16T07:04:20.621Z",
"from_address": "0401586148",
"realized_amount": 493.01972,
"order_user_reference": "HH123456789"
}
}
}