Travel Rule webhooks are delivered to the /tx endpoint appended to your Webhook URL (the same TRANSACTION channel as transaction status updates). Filter on the type field. The required-action webhook is sent immediately when the hold is placed.

Deposit Hold Webhooks

When an incoming deposit is placed on a Travel Rule hold, a single webhook is sent whose type reflects the required action — one of COUNTERPARTY_DECLARATION_REQUIRED, WALLET_VERIFICATION_REQUIRED, VASP_COUNTERPARTY_USER_INFO_REQUIRED, BLOCKED_DUE_TO_TRAVEL_RULE, or TRAVEL_RULE_ERROR_OCCURRED. The payload shape is identical across these types; counterpartyId is present only when a counterparty record already exists for the source address.

For example, the notification below is sent when the source address has not been declared for the user -

{
  "uid": "37edf199-dcd1-4b95-8ddc-160e86d3b874",
  "type": "COUNTERPARTY_DECLARATION_REQUIRED",
  "txHash": "0x7dc24b5316767f4269bbba3e9fb01a4af8af14d5e46e867d47dde3055cbbb262",
  "sourceAddress": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
  "destinationAddress": "0xd9f344019a5f2f26755f02a41548b4310be8F8fE",
  "syncedOwnerId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "userId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "currency": "USDC",
  "network": "ETH",
  "amountInSmallestUnit": "10000000",
  "ts": 1779773742601
}

For example, the notification below is sent when a declared OWNED wallet at or above the threshold still needs a wallet-ownership signature -

{
  "uid": "8d2f0a1c-4b77-4a90-9d2e-2a6f1c9b7e10",
  "type": "WALLET_VERIFICATION_REQUIRED",
  "txHash": "0x7dc24b5316767f4269bbba3e9fb01a4af8af14d5e46e867d47dde3055cbbb262",
  "sourceAddress": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
  "destinationAddress": "0xd9f344019a5f2f26755f02a41548b4310be8F8fE",
  "syncedOwnerId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "userId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "counterpartyId": "9808388e-bd29-4110-b5d3-b183b59ca49e",
  "currency": "USDC",
  "network": "ETH",
  "amountInSmallestUnit": "10000000",
  "ts": 1779773742601
}

For example, the notification below is sent when a deposit is blocked (e.g. a third-party self-hosted wallet at or above the threshold) -

{
  "uid": "b7c1a2d3-9e44-4f12-8a7b-1c2d3e4f5a6b",
  "type": "BLOCKED_DUE_TO_TRAVEL_RULE",
  "txHash": "0x7dc24b5316767f4269bbba3e9fb01a4af8af14d5e46e867d47dde3055cbbb262",
  "sourceAddress": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
  "destinationAddress": "0xd9f344019a5f2f26755f02a41548b4310be8F8fE",
  "syncedOwnerId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "userId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "counterpartyId": "9808388e-bd29-4110-b5d3-b183b59ca49e",
  "currency": "USDC",
  "network": "ETH",
  "amountInSmallestUnit": "10000000",
  "ts": 1779773742601
}

Counterparty User Info Required (VASP)

The following webhook is sent when an incoming deposit from a declared VASP counterparty needs per-transaction originator (counterparty user info) created and linked to that transaction. For a Lightning deposit, counterpartyAddress and txHash are replaced by paymentHash.

{
  "uid": "9b895d1e-b4b3-4baa-a247-8423b7019232",
  "type": "VASP_COUNTERPARTY_USER_INFO_REQUIRED",
  "txId": "bf4dbe08-2cb6-43c2-9892-a887e8f4937f",
  "txHash": "0x7dc24b5316767f4269bbba3e9fb01a4af8af14d5e46e867d47dde3055cbbb262",
  "counterpartyAddress": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
  "syncedOwnerId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "userId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "counterpartyId": "9808388e-bd29-4110-b5d3-b183b59ca49e",
  "currency": "USDC",
  "network": "ETH",
  "amountInSmallestUnit": "10000000",
  "memo": "Travel Rule VASP counterparty user info required for transaction(txId: bf4dbe08-2cb6-43c2-9892-a887e8f4937f) to be completed.",
  "ts": 1779773900313
}

User Action Completed

Sent when a Travel Rule user action completes. There are two payload shapes — transaction-scoped (a declaration or counterparty user info link settled a held transaction) and verification-scoped (a wallet ownership verification reached a terminal state).

The following transaction-scoped webhook is sent when the user's action for a held deposit is complete -

{
  "uid": "0c67d4c2-997d-491b-b90d-230182aa3f03",
  "type": "USER_ACTION_COMPLETED_FOR_TRAVEL_RULE",
  "txId": "bf4dbe08-2cb6-43c2-9892-a887e8f4937f",
  "txHash": "0x7dc24b5316767f4269bbba3e9fb01a4af8af14d5e46e867d47dde3055cbbb262",
  "counterpartyAddress": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
  "syncedOwnerId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "userId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "counterpartyId": "9808388e-bd29-4110-b5d3-b183b59ca49e",
  "currency": "USDC",
  "network": "ETH",
  "amountInSmallestUnit": "10000000",
  "memo": "Travel Rule user action completed for transaction(txId: bf4dbe08-2cb6-43c2-9892-a887e8f4937f).",
  "ts": 1779774080209
}

For a Lightning deposit the locator collapses to a single paymentHash (no counterpartyAddress / txHash) -

{
  "uid": "1f0aa2b3-5c61-49de-8a01-7b2c3d4e5f60",
  "type": "USER_ACTION_COMPLETED_FOR_TRAVEL_RULE",
  "txId": "bf4dbe08-2cb6-43c2-9892-a887e8f4937f",
  "paymentHash": "8ac740817d5f7794f550764945c3ac35f830364ea11e8427e36cf0319d0e3f71",
  "syncedOwnerId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "userId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "counterpartyId": "9808388e-bd29-4110-b5d3-b183b59ca49e",
  "currency": "BTC",
  "network": "BTC",
  "amountInSmallestUnit": "1500",
  "memo": "Travel Rule user action completed for transaction(txId: bf4dbe08-2cb6-43c2-9892-a887e8f4937f).",
  "ts": 1779774080209
}

The following verification-scoped webhook is sent when a wallet ownership verification reaches a terminal state. status is VERIFIED or REJECTED, and method is WALLET_SIGNATURE or SUMSUB_LIVENESS -

{
  "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "type": "USER_ACTION_COMPLETED_FOR_TRAVEL_RULE",
  "walletVerificationId": "b2808090-f12a-48fc-8a7e-ddc77adb3a9e",
  "address": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
  "blockchain": "Ethereum",
  "syncedOwnerId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "userId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "counterpartyId": "9808388e-bd29-4110-b5d3-b183b59ca49e",
  "method": "SUMSUB_LIVENESS",
  "status": "VERIFIED",
  "ts": 1779773900000
}

Wallet Verification In Review

The following webhook is sent when a wallet verification was submitted through Sumsub liveness and is awaiting review. Wait for the follow-up USER_ACTION_COMPLETED_FOR_TRAVEL_RULE with status VERIFIED or REJECTED. (Wallet-signature verification does not emit this event — it completes synchronously with USER_ACTION_COMPLETED_FOR_TRAVEL_RULE and status: VERIFIED.)

{
  "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "WALLET_VERIFICATION_IN_REVIEW",
  "walletVerificationId": "b2808090-f12a-48fc-8a7e-ddc77adb3a9e",
  "address": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
  "blockchain": "Ethereum",
  "syncedOwnerId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "userId": "104894c7-95fc-4dde-97dd-cb25b2587b91",
  "method": "SUMSUB_LIVENESS",
  "ts": 1779773800000
}