Webhook Events

Event Types

transaction.created
deposit.detected
deposit.confirmed
transaction.completed
transaction.failed
transaction.expired
transaction.cancelled
transaction.refunded
payout.settled

Common `data` Fields

Most events include:

id / transaction_id
status
crypto_currency
crypto_amount
rate
amount
network
merchant_reference
merchant_id
terminal_id
expires_at

Event-Specific Fields

transaction.created: includes deposit_address.
deposit.detected: includes deposit_id.
deposit.confirmed: includes deposit_id.
payout.settled: includes payout_amount, payout_currency.

Payload Examples

transaction.created

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "transaction.created",
  "data": {
    "transaction_id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "status": "awaiting_deposit",
    "crypto_currency": "usdt",
    "crypto_amount": "100.00",
    "rate": "1615.00",
    "amount": "161500.00",
    "network": "trc20",
    "deposit_address": "TXyz1234567890abcdef1234567890abcd",
    "merchant_reference": "order-4551",
    "merchant_id": "mrc_001",
    "terminal_id": "term_01",
    "expires_at": "2026-02-12T12:30:00Z"
  }
}

deposit.detected

{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "type": "deposit.detected",
  "data": {
    "transaction_id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "status": "deposit_confirming",
    "crypto_currency": "usdt",
    "crypto_amount": "100.00",
    "rate": "1615.00",
    "amount": "161500.00",
    "network": "trc20",
    "deposit_id": "dep_abc123",
    "merchant_reference": "order-4551",
    "merchant_id": "mrc_001",
    "terminal_id": "term_01"
  }
}

deposit.confirmed

{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "type": "deposit.confirmed",
  "data": {
    "transaction_id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "status": "selling_crypto",
    "crypto_currency": "usdt",
    "crypto_amount": "100.00",
    "rate": "1615.00",
    "amount": "161500.00",
    "network": "trc20",
    "deposit_id": "dep_abc123",
    "merchant_reference": "order-4551",
    "merchant_id": "mrc_001",
    "terminal_id": "term_01"
  }
}

transaction.completed

{
  "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
  "type": "transaction.completed",
  "data": {
    "transaction_id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "status": "completed",
    "crypto_currency": "usdt",
    "crypto_amount": "100.00",
    "rate": "1615.00",
    "amount": "161500.00",
    "network": "trc20",
    "merchant_reference": "order-4551",
    "merchant_id": "mrc_001",
    "terminal_id": "term_01"
  }
}

transaction.failed

{
  "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
  "type": "transaction.failed",
  "data": {
    "transaction_id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "status": "failed",
    "crypto_currency": "usdt",
    "crypto_amount": "100.00",
    "rate": "1615.00",
    "amount": "161500.00",
    "network": "trc20",
    "merchant_reference": "order-4551",
    "merchant_id": "mrc_001",
    "terminal_id": "term_01"
  }
}

transaction.expired

{
  "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
  "type": "transaction.expired",
  "data": {
    "transaction_id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "status": "expired",
    "crypto_currency": "usdt",
    "crypto_amount": "100.00",
    "rate": "1615.00",
    "amount": "161500.00",
    "network": "trc20",
    "merchant_reference": "order-4551",
    "merchant_id": "mrc_001",
    "terminal_id": "term_01",
    "expires_at": "2026-02-12T12:30:00Z"
  }
}

transaction.cancelled

{
  "id": "a7b8c9d0-e1f2-3456-abcd-567890123456",
  "type": "transaction.cancelled",
  "data": {
    "transaction_id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "status": "cancelled",
    "crypto_currency": "usdt",
    "crypto_amount": "100.00",
    "rate": "1615.00",
    "amount": "161500.00",
    "network": "trc20",
    "merchant_reference": "order-4551",
    "merchant_id": "mrc_001",
    "terminal_id": "term_01"
  }
}

transaction.refunded

{
  "id": "b8c9d0e1-f2a3-4567-bcde-678901234567",
  "type": "transaction.refunded",
  "data": {
    "transaction_id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "status": "refunded",
    "crypto_currency": "usdt",
    "crypto_amount": "100.00",
    "rate": "1615.00",
    "amount": "161500.00",
    "network": "trc20",
    "merchant_reference": "order-4551",
    "merchant_id": "mrc_001",
    "terminal_id": "term_01"
  }
}

payout.settled

{
  "id": "c9d0e1f2-a3b4-5678-cdef-789012345678",
  "type": "payout.settled",
  "data": {
    "transaction_id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "status": "completed",
    "crypto_currency": "usdt",
    "crypto_amount": "100.00",
    "rate": "1615.00",
    "amount": "161500.00",
    "network": "trc20",
    "payout_amount": "161500.00",
    "payout_currency": "NGN",
    "merchant_reference": "order-4551",
    "merchant_id": "mrc_001",
    "terminal_id": "term_01"
  }
}

Notes for Consumers

Do not assume every field is always present; handle optional fields safely.
Use transaction_id + merchant_reference for reconciliation joins.
payout.settled is emitted for payout-enabled partner share settlements.

Get Started

Transactions

Webhooks

Reconciliation

Event Types

Common `data` Fields

Event-Specific Fields

Payload Examples

transaction.created

deposit.detected

deposit.confirmed

transaction.completed

transaction.failed

transaction.expired

transaction.cancelled

transaction.refunded

payout.settled

Notes for Consumers

​Event Types

​Common data Fields

​Event-Specific Fields

​Payload Examples

​transaction.created

​deposit.detected

​deposit.confirmed

​transaction.completed

​transaction.failed

​transaction.expired

​transaction.cancelled

​transaction.refunded

​payout.settled

​Notes for Consumers

Event Types

Common `data` Fields

Event-Specific Fields

Payload Examples

transaction.created

deposit.detected

deposit.confirmed

transaction.completed

transaction.failed

transaction.expired

transaction.cancelled

transaction.refunded

payout.settled

Notes for Consumers