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"
    }
  }
}