Skip to main content
WEBHOOK
transaction.status
{
  "event": {
    "id": "2632ebb1-55ab-470a-9b24-accdb50aeb75",
    "event_reference_id": "ca9a04d8-4e68-4557-b9c6-3881e9d6b26d",
    "type": "transaction.status",
    "created_at": "2025-12-01T09:14:34.651913Z",
    "sandbox_mode": true
  },
  "data": {
    "beneficiary_id": "47fcb2ca-9ed2-4188-a154-c83a04d9d34d",
    "created_at": "2025-12-01T09:14:34.623187982Z",
    "developer_fee": 1.7836,
    "developer_fee_fixed": 1.75,
    "developer_fee_percentage": 0.56,
    "from_amount": 6,
    "from_currency": "USDC",
    "fx_rate": 1.3177,
    "hash": "0x3a282c0d2364632bdf9224eadf06b463190795bce24e46d3235e44d22f953461",
    "id": "ca9a04d8-4e68-4557-b9c6-3881e9d6b26d",
    "payout_amount": 5.55595028,
    "payout_currency": "CAD",
    "processing_amount": 4.2164,
    "status": "FUNDS_RECEIVED",
    "transaction_ref_id": "c494ac07-becd-4840-9",
    "transaction_type": "ONRAMP",
    "updated_at": "2025-12-01T09:14:34.623187982Z"
  }
}
This webhook event is triggered when a transaction’s status changes. It provides real-time updates as transactions progress through different stages, including when funds are received, when processing begins, and if a transaction fails. Common status values include:
  • FUNDS_RECEIVED - Initial funds have been received from the sender
  • PROCESSING - Transaction is being processed
  • COMPLETED - Transaction has completed successfully
  • FAILED - Transaction has failed and will not complete
  • REFUNDED - Failed transaction has been successfully refunded to the prefunded wallet
Security: All webhook requests include HMAC signatures for verification. Learn how to verify webhook signatures to ensure requests are authentic.

Body

application/json

Webhook triggered when a transaction's status changes

​
event
object
required
​
data
object
required

Transaction data in webhook payload

Response

200

Webhook received successfully