Changelog

Crypto Deposit/Withdrawal Webhooks

These webhooks are sent when your users deposit/withdraw funds on-chain

Blockchain Transaction Webhooks

For example, the notification below is sent for a pending blockchain transaction to an enriched crypto account

{
  "type": "ON_CHAIN_DEPOSIT_PENDING",
  "id": "223e055a-97a0-4015-a6c2-77017f1b7c79",
  "accountId": "302dc2769973a52c15990b1e981cca04",
  "syncedOwnerId": "7ea299d5-ffa8-4782-8331-2b7d61c0c730",
  "sourceSyncedOwnerId": "7ea299d5-ffa8-4782-8331-2b7d61c0c730",
  "timestamp": "2023-11-06T15:54:16.173Z",
  "txType": "ON_CHAIN_DEPOSIT_PENDING",
  "memo": "58 USDT PENDING_BLOCKCHAIN_CONFIRMATIONS 0x4e8ed90b07dee1209024dd3d11b8f0239ae0526853c8a8b1ec952e55a7e6ad7e",
  "currency": "USDT",
  "exchangeRate": "0.94",
  "balanceBefore": {
    "amount": "4847",
    "balance": "4847",
    "currency": "cents"
  },
  "balanceAfter": {
    "amount": "4847",
    "balance": "4847",
    "currency": "cents"
  },
  "blockchainSourceAddress": "0x712073F86D2ad7EEd23a3F7683aa6145042B81Cf",
  "txHash": "0x4e8ed90b07dee1209024dd3d11b8f0239ae0526853c8a8b1ec952e55a7e6ad7e",
  "blockchainDepositAddress": "0x918d015d3E465aB78c50BF8ec0b2549A343aD920",
  "blockchainConfirmations": 1,
  "blockchainTransactionAmount": "5800"
}

For example, the notification below is sent for a confirmed blockchain transaction to an enriched crypto account

{
  "type": "ON_CHAIN_DEPOSIT_CONFIRMED",
  "id": "223e055a-97a0-4015-a6c2-77017f1b7c79",
  "accountId": "302dc2769973a52c15990b1e981cca04",
  "syncedOwnerId": "7ea299d5-ffa8-4782-8331-2b7d61c0c730",
  "sourceSyncedOwnerId": "7ea299d5-ffa8-4782-8331-2b7d61c0c730",
  "credit": "5800",
  "timestamp": "2023-11-06T15:54:17.142Z",
  "txType": "ON_CHAIN_DEPOSIT_CONFIRMED",
  "memo": "58 USDT CONFIRMED 0x4e8ed90b07dee1209024dd3d11b8f0239ae0526853c8a8b1ec952e55a7e6ad7e",
  "currency": "USDT",
  "exchangeRate": "0.94",
  "balanceBefore": {
    "amount": "4847",
    "balance": "4847",
    "currency": "cents"
  },
  "balanceAfter": {
    "amount": "10647",
    "balance": "10647",
    "currency": "cents"
  },
  "blockchainSourceAddress": "0x712073F86D2ad7EEd23a3F7683aa6145042B81Cf",
  "txHash": "0x4e8ed90b07dee1209024dd3d11b8f0239ae0526853c8a8b1ec952e55a7e6ad7e",
  "blockchainDepositAddress": "0x918d015d3E465aB78c50BF8ec0b2549A343aD920",
  "blockchainConfirmations": 1,
  "blockchainTransactionAmount": "5800",
  "feeEstimate": {
    "totalFee": "89",
    "networkFee": "0",
    "ourFee": "0",
    "theirFee": "89",
    "feeCurrency": "USDT",
    "fixedFeeDetails": {
      "amount": "57",
      "exchangeRate": "0.95",
      "appliedFeeCents": "55"
    },
    "percentageFeeDetails": {
      "amount": "32",
      "appliedFeeBps": "55"
    }
  }
}

On Chain Withdrawal Webhooks

The following webhook is sent for an on chain withdrawal that has been initiated -

{
  "type": "ON_CHAIN_WITHDRAWAL_INITIATED",
  "id": "20a7cc2a-98d9-458d-b8ac-c390b1418609",
  "accountId": "56f839fa6bf58216b64a9070d11b2eac",
  "syncedOwnerId": "b2ccf978-2da7-4ac9-9db7-5398c4c6b212",
  "sourceSyncedOwnerId": "b2ccf978-2da7-4ac9-9db7-5398c4c6b212",
  "debit": "4941",
  "timestamp": "2023-08-31T09:34:05.389Z",
  "txType": "ON_CHAIN_WITHDRAWAL_INITIATED",
  "currency": "USDC",
  "memo": "ON_CHAIN_WITHDRAWAL_INITIATED 49.41 USDC 20a7cc2a-98d9-458d-b8ac-c390b1418609",
  "exchangeRate": "0.92",
  "balanceBefore": {
    "amount": "9793",
    "balance": "9793",
    "currency": "cents"
  },
  "balanceAfter": {
    "amount": "4852",
    "balance": "4852",
    "currency": "cents"
  }
}

The following webhook is sent for an on chain withdrawal that is pending -

{
  "type": "ON_CHAIN_WITHDRAWAL_PENDING",
  "id": "20a7cc2a-98d9-458d-b8ac-c390b1418609",
  "accountId": "56f839fa6bf58216b64a9070d11b2eac",
  "syncedOwnerId": "b2ccf978-2da7-4ac9-9db7-5398c4c6b212",
  "sourceSyncedOwnerId": "b2ccf978-2da7-4ac9-9db7-5398c4c6b212",
  "timestamp": "2023-08-31T09:34:17.816Z",
  "txType": "ON_CHAIN_WITHDRAWAL_PENDING",
  "currency": "USDC",
  "memo": "USDC ON_CHAIN_WITHDRAWAL_PENDING BROADCASTING",
  "exchangeRate": "0.92",
  "balanceBefore": {
    "amount": "4793",
    "balance": "4793",
    "currency": "cents"
  },
  "balanceAfter": {
    "amount": "4793",
    "balance": "4793",
    "currency": "cents"
  },
  "blockchainSourceAddress": "",
  "txHash": "0x8f1855cd033a688f883b71320d6de346938f17e0a2a1aad0dfba2e88cc29cb9c",
  "blockchainDepositAddress": "0x712073F86D2ad7EEd23a3F7683aa6145042B81Cf",
  "blockchainConfirmations": 0
}

The following webhook is sent for an on chain withdrawal that has been completed -

{
  "type": "ON_CHAIN_WITHDRAWAL_CONFIRMED",
  "id": "20a7cc2a-98d9-458d-b8ac-c390b1418609",
  "accountId": "56f839fa6bf58216b64a9070d11b2eac",
  "syncedOwnerId": "b2ccf978-2da7-4ac9-9db7-5398c4c6b212",
  "sourceSyncedOwnerId": "b2ccf978-2da7-4ac9-9db7-5398c4c6b212",
  "timestamp": "2023-08-31T09:35:06.682Z",
  "txType": "ON_CHAIN_WITHDRAWAL_CONFIRMED",
  "currency": "USDC",
  "memo": "USDC ON_CHAIN_WITHDRAWAL_CONFIRMED COMPLETED",
  "exchangeRate": "0.92",
  "balanceBefore": {
    "amount": "4793",
    "balance": "4793",
    "currency": "cents"
  },
  "balanceAfter": {
    "amount": "4793",
    "balance": "4793",
    "currency": "cents"
  },
  "blockchainSourceAddress": "0x606baDb2A7145FFC443575635Bb07fd23AE14478",
  "txHash": "0x8f1855cd033a688f883b71320d6de346938f17e0a2a1aad0dfba2e88cc29cb9c",
  "blockchainDepositAddress": "0x712073F86D2ad7EEd23a3F7683aa6145042B81Cf",
  "blockchainConfirmations": 1
}

The following webhook is sent for the fees collected from a user on your behalf for on chain withdrawals, and credited to your account -

{
  "type": "APPLICATION_FEE",
  "id": "20a7cc2a-98d9-458d-b8ac-c390b1418609",
  "accountId": "56f839fa6bf58216b64a9070d11b2eac",
  "syncedOwnerId": "b2ccf978-2da7-4ac9-9db7-5398c4c6b212",
  "sourceSyncedOwnerId": "b2ccf978-2da7-4ac9-9db7-5398c4c6b212",
  "debit": "50",
  "timestamp": "2023-08-31T09:34:06.109Z",
  "txType": "APPLICATION_FEE",
  "txSubType": "THEIR_FEE",
  "memo": "Application VA Withdrawal fee for 20a7cc2a-98d9-458d-b8ac-c390b1418609",
  "exchangeRate": "0.92",
  "balanceBefore": {
    "amount": "4843",
    "balance": "4843",
    "currency": "cents"
  },
  "balanceAfter": {
    "amount": "4793",
    "balance": "4793",
    "currency": "cents"
  }
}

{
  "type": "APPLICATION_FEE",
  "id": "20a7cc2a-98d9-458d-b8ac-c390b1418609",
  "accountId": "ec080168771a370bc89478b42e229549",
  "syncedOwnerId": "2d57625c-cd8c-4949-a380-326711b04337",
  "sourceSyncedOwnerId": "StrigaFeeHoldAccount",
  "destinationSyncedOwnerId": "718c703a-dc08-4e80-85e1-f96003fa868b",
  "credit": "50",
  "timestamp": "2023-08-31T09:35:07.537Z",
  "txType": "APPLICATION_FEE",
  "txSubType": "THEIR_FEE",
  "memo": "Application VA Withdrawal fee for 20a7cc2a-98d9-458d-b8ac-c390b1418609",
  "exchangeRate": "0.92",
  "balanceBefore": {
    "amount": "207",
    "balance": "207",
    "currency": "cents"
  },
  "balanceAfter": {
    "amount": "257",
    "balance": "257",
    "currency": "cents"
  }
}

The following webhook is sent for the fees collected from a user after an on chain withdrawal has been initiated, to pay for network fees -

{
  "type": "NETWORK_FEE",
  "id": "20a7cc2a-98d9-458d-b8ac-c390b1418609",
  "accountId": "56f839fa6bf58216b64a9070d11b2eac",
  "syncedOwnerId": "b2ccf978-2da7-4ac9-9db7-5398c4c6b212",
  "sourceSyncedOwnerId": "b2ccf978-2da7-4ac9-9db7-5398c4c6b212",
  "debit": "9",
  "timestamp": "2023-08-31T09:34:06.107Z",
  "txType": "NETWORK_FEE",
  "txSubType": "TOTAL_WITHDRAWAL_FEE",
  "memo": "NETWORK_FEE 0.09 USDC 20a7cc2a-98d9-458d-b8ac-c390b1418609",
  "exchangeRate": "0.92",
  "balanceBefore": {
    "amount": "4852",
    "balance": "4852",
    "currency": "cents"
  },
  "balanceAfter": {
    "amount": "4843",
    "balance": "4843",
    "currency": "cents"
  }
}

The following webhook is sent when funds and the corresponding fees are refunded when an on chain withdrawal fails

{
  "type": "ON_CHAIN_WITHDRAWAL_FAILED",
  "id": "ee9e8733-3e1a-4ced-9bb3-7600b64d2a69",
  "accountId": "7cb14c21eb7283745ba629d5dc8e6c7d",
  "syncedOwnerId": "50febc83-6118-419e-82e1-886f8c7ffd59",
  "credit": "22310983910888449318",
  "timestamp": "2022-11-30T16:21:15.187Z",
  "txType": "ON_CHAIN_WITHDRAWAL_FAILED",
  "memo": "BNB_TEST_FAILED",
  "balanceBefore": {
    "amount": "1144927556020485960",
    "currency": "wei"
  },
  "balanceAfter": {
    "amount": "3376025947109330892752",
    "currency": "wei"
  },
  "blockchainSourceAddress": "",
  "txHash": "",
  "blockchainDepositAddress": "",
  "blockchainConfirmations": null
}

{
  "type": "FEE_REFUND",
  "id": "ee9e8733-3e1a-4ced-9bb3-7600b64d2a69",
  "accountId": "7cb14c21eb7283745ba629d5dc8e6c7d",
  "syncedOwnerId": "50febc83-6118-419e-82e1-886f8c7ffd59",
  "credit": "22536559696857019513",
  "timestamp": "2022-11-30T16:21:15.441Z",
  "txType": "FEE_REFUND",
  "txSubType": "TOTAL_WITHDRAWAL_FEE",
  "memo": "BNB_TEST_FAILED",
  "balanceBefore": {
    "amount": "3376025947109330892752",
    "currency": "wei"
  },
  "balanceAfter": {
    "amount": "3398562506806187912265",
    "currency": "wei"
  },
  "blockchainSourceAddress": "",
  "txHash": "",
  "blockchainDepositAddress": "",
  "blockchainConfirmations": null
}