Webhooks

Stay in sync with on-chain events and update your order status in real-time.

Event Lifecycle

TriBridge emits webhooks when a payment's status changes. The most important event for most merchants is `payment.forwarded`.

payment.createdA new payment address has been generated.

payment.confirmedThe transaction has reached finality on its native chain.

payment.forwardedFunds have been successfully sent to your linked wallet.

payment.failedThe payment timed out or was cancelled.

Payload Structure

All webhook payloads share a common structure, including a timestamp and the payment object.

{
  "id": "evt_98123ns",
  "type": "payment.forwarded",
  "created_at": 1706184572,
  "data": {
    "payment_id": "pay_5502",
    "amount": "99.00",
    "currency": "USDC",
    "chain": "SOLANA",
    "tx_hash": "6p2m...y81z"
  }
}