Fiat deposit

Fiat deposit completed

This webhook is sent when a fiat deposit is completed and funds are transferred in the receiver's bank account. This would update the fiat balance for the user.

{
  "event": {
    "orgId": 16351,
    "entity": "BankTransfers",
    "eventType": "DEPOSIT_WORKFLOW",
    "numRetries": 1,
    "createdAt": "2026-01-27T18:16:49.859Z",
    "updatedAt": "2026-01-27T18:16:50.221Z"
  },
  "data": {
    "from": {
      "counterPartyId": "dr.watson.1769536884",
      "accountId": "beeab5cb-bbc3-457b-8f5d-3724d2ada6b1"
    },
    "to": {
      "orgUserId": "lestrade.1769536339",
      "currency": "AED",
      "amount": 1
    },
    "referenceId": "FZ-16350-8337-1769537712043",
    "transferId": "c43f1537-bcf4-403d-be43-d45752b27edb",
    "status": "COMPLETED",
    "type": "DEPOSIT",
    "createdAt": "2026-01-27T18:15:12.344Z",
    "updatedAt": "2026-01-27T18:15:49.422Z"
  }
}

Fiat withdrawal

Fiat withdrawal completed

This webhook is sent when a fiat withdrawal is completed and the funds are transferred to the receiver's bank account.

{
  "event": {
    "orgId": 16351,
    "entity": "BankTransfers",
    "eventType": "WITHDRAWAL_WORKFLOW",
    "numRetries": 2,
    "createdAt": "2026-01-27T18:10:45.278Z",
    "updatedAt": "2026-01-27T18:15:03.456Z"
  },
  "data": {
    "from": {
      "orgUserId": "lestrade.1769536339"
    },
    "to": {
      "counterPartyId": "dr.watson.1769536884",
      "accountId": "beeab5cb-bbc3-457b-8f5d-3724d2ada6b1",
      "currency": "AED",
      "amount": 1
    },
    "referenceId": "FZ-16350-8433-1769537082668",
    "transferId": "17a30d9c-8f54-49b0-beb6-999e14923171",
    "status": "COMPLETED",
    "type": "WITHDRAW",
    "createdAt": "2026-01-27T18:04:42.796Z",
    "updatedAt": "2026-01-27T18:09:44.560Z"
  }
}

Crypto deposit

Crypto deposit completed

This webhook is sent when a crypto deposit is completed on the blockchain. This would update the crypto balance for the user.

{
  "event": {
    "orgId": 16350,
    "entity": "UserTxns",
    "eventType": "NOTIFICATION",
    "numRetries": 0,
    "createdAt": "2026-01-27T18:19:15.174Z",
    "updatedAt": "2026-01-27T18:19:15.174Z"
  },
  "data": {
    "from": {
      "walletId": "1e332c53-a123-4504-9600-3e3672b8f5d8",
      "blockchainAddress": "0x5A047dAc44Da3fd4dc7C038aCFD952C70D41781b"
    },
    "to": {
      "orgUserId": "lestrade.1769536339",
      "currency": "USDT",
      "amount": 0.123,
      "blockchainAddress": "0xC60Ea23B17F197D6C5b61b2e4ccf166F82Ad5B51"
    },
    "txHash": "0xda1aa8f637a21a2691c1900c42bea4910b163091cc990d678abfb4ef557fe57a",
    "chain": "ETHEREUM",
    "transferId": "9b2a2bac-fc6e-4203-ad16-61ca5ec6fe51",
    "status": "COMPLETED",
    "type": "DEPOSIT",
    "createdAt": "2026-01-27T18:15:11.854Z",
    "updatedAt": "2026-01-27T18:18:14.652Z"
  }
}

Crypto withdrawal

Lifecycle

flowchart TD
    A[Created]
    B[<a href="#crypto_withdrawal_cancelled">Cancelled</a>] 
    C[<a href="#crypto_withdrawal_processing">Processing</a>] 
    D[<a href="#crypto_withdrawal_completed">Completed</a>]
    
    A --> C --> D
    A --> B

Crypto withdrawal processing

This webhook is sent when the crypto withdrawal is approved and a blockchain transfer is initiated.

{
  "event": {
    "orgId": 16350,
    "entity": "UserTxns",
    "eventType": "NOTIFICATION",
    "numRetries": 0,
    "createdAt": "2026-01-27T18:27:21.144Z",
    "updatedAt": "2026-01-27T18:27:21.144Z"
  },
  "data": {
    "from": {
      "orgUserId": "lestrade.1769536339",
      "blockchainAddress": ""
    },
    "to": {
      "walletId": "1cf09ad9-c4d9-42fd-bf9a-34746817c8a7",
      "counterPartyId": "dr.watson.1769536884",
      "currency": "USDT",
      "amount": 0.1,
      "blockchainAddress": "0x5A047dAc44Da3fd4dc7C038aCFD952C70D41781b"
    },
    "txHash": "",
    "chain": "ETHEREUM",
    "transferId": "37d4e8c2-a0c5-4db3-8660-08f3776231c0",
    "status": "PROCESSING",
    "type": "WITHDRAWAL",
    "createdAt": "2026-01-27T18:26:10.407Z",
    "updatedAt": "2026-01-27T18:26:50.629Z"
  }
}

Crypto withdrawal completed

This webhook is sent when the blockchain transfer for a crypto withdrawal is completed.

{
  "event": {
    "orgId": 16350,
    "entity": "UserTxns",
    "eventType": "NOTIFICATION",
    "numRetries": 0,
    "createdAt": "2026-01-27T18:28:30.946Z",
    "updatedAt": "2026-01-27T18:28:30.946Z"
  },
  "data": {
    "from": {
      "orgUserId": "lestrade.1769536339",
      "blockchainAddress": "0x90566065390dD1A6c6c0c56b9eFCB8F015C70E5F"
    },
    "to": {
      "walletId": "1cf09ad9-c4d9-42fd-bf9a-34746817c8a7",
      "counterPartyId": "dr.watson.1769536884",
      "currency": "USDT",
      "amount": 0.1,
      "blockchainAddress": "0x5A047dAc44Da3fd4dc7C038aCFD952C70D41781b"
    },
    "txHash": "0x263a6c9cecb3e3c1a12007b012bfd4a83ec00219402d946f3489698cb3552821",
    "chain": "ETHEREUM",
    "transferId": "37d4e8c2-a0c5-4db3-8660-08f3776231c0",
    "status": "COMPLETED",
    "type": "WITHDRAWAL",
    "createdAt": "2026-01-27T18:26:10.407Z",
    "updatedAt": "2026-01-27T18:27:28.885Z"
  }
}

Crypto withdrawal cancelled

This webhook is sent when the withdrawal gets cancelled by Fuze. Further communication to Fuze takes place through alternative channels like email.

{
  "event": {
    "orgId": 16350,
    "entity": "UserTxns",
    "eventType": "DELETE",
    "numRetries": 0,
    "createdAt": "2026-01-28T08:35:02.845Z",
    "updatedAt": "2026-01-28T08:35:02.845Z"
  },
  "data": {
    "from": {
      "orgUserId": "lestrade.1769536339",
      "blockchainAddress": ""
    },
    "to": {
      "walletId": "1cf09ad9-c4d9-42fd-bf9a-34746817c8a7",
      "counterPartyId": "dr.watson.1769536884",
      "currency": "USDT",
      "amount": 0.1,
      "blockchainAddress": "0x5A047dAc44Da3fd4dc7C038aCFD952C70D41781b"
    },
    "txHash": "",
    "chain": "ETHEREUM",
    "transferId": "78f79704-63c8-4a59-8948-e468175145ab",
    "status": "CANCELLED",
    "type": "WITHDRAWAL",
    "createdAt": "2026-01-28T08:33:39.393Z",
    "updatedAt": "2026-01-28T08:34:02.591Z"
  }
}