Example Webhook Payloads
View sample webhook payloads for different event types
Idempotency Required
Webhook อาจถูกส่งซ้ำหลายครั้ง โปรดออกแบบระบบให้รองรับการส่งซ้ำ (Idempotent) เพื่อป้องกันการประมวลผลข้อมูลซ้ำ
Event Types
PAYMENT_PAID
{
"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"
}
}
}