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": "f5bafa2d-f676-48b2-aa80-c69ebc2501ce",
"accountId": "b1b6055babf12d7b18cbbe458248dfcb",
"syncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"sourceSyncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"timestamp": "2024-07-02T13:11:05.057Z",
"txType": "ON_CHAIN_DEPOSIT_PENDING",
"memo": "0.2 MATIC_POLYGON PENDING_BLOCKCHAIN_CONFIRMATIONS 0x3bd204792087f218130b2dd5231a8b004af0e10e33f64dd962bdc563c5a353fa",
"currency": "MATIC_POLYGON",
"exchangeRate": "1",
"balanceBefore": {
"amount": "6603773584905660377",
"balance": "6603773584905660377"
},
"balanceAfter": {
"amount": "6603773584905660377",
"balance": "6603773584905660377"
},
"blockchainSourceAddress": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
"txHash": "0x3bd204792087f218130b2dd5231a8b004af0e10e33f64dd962bdc563c5a353fa",
"blockchainDepositAddress": "0x61EdbEb64D6358935aC7bd1f56fD6c9D9F2e0cD7",
"blockchainConfirmations": 1,
"blockchainTransactionAmount": "200000000000000000",
"blockchainNetwork": "Polygon Testnet Amoy"
}
For example, the notification below is sent for a confirmed blockchain transaction to an enriched crypto account
{
"type": "ON_CHAIN_DEPOSIT_CONFIRMED",
"id": "f5bafa2d-f676-48b2-aa80-c69ebc2501ce",
"accountId": "b1b6055babf12d7b18cbbe458248dfcb",
"syncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"sourceSyncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"credit": "200000000000000000",
"timestamp": "2024-07-02T13:11:05.873Z",
"txType": "ON_CHAIN_DEPOSIT_CONFIRMED",
"memo": "0.2 MATIC_POLYGON CONFIRMED 0x3bd204792087f218130b2dd5231a8b004af0e10e33f64dd962bdc563c5a353fa",
"currency": "MATIC_POLYGON",
"exchangeRate": "1",
"balanceBefore": {
"amount": "6603773584905660377",
"balance": "6603773584905660377"
},
"balanceAfter": {
"amount": "6803773584905660377",
"balance": "6803773584905660377"
},
"blockchainSourceAddress": "0x54d03EC0C462e9a01F77579C090cdE0FC2617817",
"txHash": "0x3bd204792087f218130b2dd5231a8b004af0e10e33f64dd962bdc563c5a353fa",
"blockchainDepositAddress": "0x61EdbEb64D6358935aC7bd1f56fD6c9D9F2e0cD7",
"blockchainConfirmations": 1,
"blockchainTransactionAmount": "200000000000000000",
"blockchainNetwork": "Polygon Testnet Amoy",
"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": "358f5e37-4e15-424e-9479-3037cf68989a",
"accountId": "b1b6055babf12d7b18cbbe458248dfcb",
"syncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"sourceSyncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"debit": "99957978999580000",
"timestamp": "2024-07-02T13:14:06.715Z",
"txType": "ON_CHAIN_WITHDRAWAL_INITIATED",
"memo": "ON_CHAIN_WITHDRAWAL_INITIATED 0.09995797899958 MATIC_POLYGON 358f5e37-4e15-424e-9479-3037cf68989a",
"currency": "MATIC_POLYGON",
"exchangeRate": "1",
"balanceBefore": {
"amount": "6803773584905660377",
"balance": "6803773584905660377"
},
"balanceAfter": {
"amount": "6703815605906080377",
"balance": "6703815605906080377"
},
"feeEstimate": {
"totalFee": "42021000420000",
"networkFee": "42021000420000",
"ourFee": "42021000420000",
"theirFee": "0",
"feeCurrency": "MATIC_POLYGON",
"gasLimit": "21000",
"gasPrice": "2.002",
"fixedFeeDetails": {
"amount": "0",
"exchangeRate": "0"
},
"percentageFeeDetails": {
"amount": "0"
}
},
"blockchainNetwork": "Polygon Testnet Amoy"
}
The following webhook is sent for an on chain withdrawal that is pending -
{
"type": "ON_CHAIN_WITHDRAWAL_PENDING",
"id": "358f5e37-4e15-424e-9479-3037cf68989a",
"accountId": "b1b6055babf12d7b18cbbe458248dfcb",
"syncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"sourceSyncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"timestamp": "2024-07-02T13:14:18.918Z",
"txType": "ON_CHAIN_WITHDRAWAL_PENDING",
"memo": "MATIC_POLYGON ON_CHAIN_WITHDRAWAL_PENDING BROADCASTING",
"currency": "MATIC_POLYGON",
"exchangeRate": "1",
"balanceBefore": {
"amount": "6703773584905660377",
"balance": "6703773584905660377"
},
"balanceAfter": {
"amount": "6703773584905660377",
"balance": "6703773584905660377"
},
"blockchainSourceAddress": "",
"txHash": "0x8f67cdecba971a40ab9ec59972efb8130e31c011a8e6c909aadfee00223a9b4e",
"blockchainDepositAddress": "0xd1257B051c3CB9d26A7f3b2073b542241dE470b1",
"blockchainConfirmations": 0,
"feeEstimate": {
"totalFee": "42021000420000",
"networkFee": "42021000420000",
"ourFee": "42021000420000",
"theirFee": "0",
"feeCurrency": "MATIC_POLYGON",
"gasLimit": "21000",
"gasPrice": "2.002",
"fixedFeeDetails": {
"amount": "0",
"exchangeRate": "0"
},
"percentageFeeDetails": {
"amount": "0"
}
},
"blockchainNetwork": "Polygon Testnet Amoy"
}
The following webhook is sent for an on chain withdrawal that has been completed -
{
"type": "ON_CHAIN_WITHDRAWAL_CONFIRMED",
"id": "358f5e37-4e15-424e-9479-3037cf68989a",
"accountId": "b1b6055babf12d7b18cbbe458248dfcb",
"syncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"sourceSyncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"timestamp": "2024-07-02T13:14:44.829Z",
"txType": "ON_CHAIN_WITHDRAWAL_CONFIRMED",
"memo": "MATIC_POLYGON ON_CHAIN_WITHDRAWAL_CONFIRMED COMPLETED",
"currency": "MATIC_POLYGON",
"exchangeRate": "1",
"balanceBefore": {
"amount": "6703773584905660377",
"balance": "6703773584905660377"
},
"balanceAfter": {
"amount": "6703773584905660377",
"balance": "6703773584905660377"
},
"blockchainSourceAddress": "0x606baDb2A7145FFC443575635Bb07fd23AE14478",
"txHash": "0x8f67cdecba971a40ab9ec59972efb8130e31c011a8e6c909aadfee00223a9b4e",
"blockchainDepositAddress": "0xd1257B051c3CB9d26A7f3b2073b542241dE470b1",
"blockchainConfirmations": 1,
"feeEstimate": {
"totalFee": "42021000420000",
"networkFee": "42021000420000",
"ourFee": "42021000420000",
"theirFee": "0",
"feeCurrency": "MATIC_POLYGON",
"gasLimit": "21000",
"gasPrice": "2.002",
"fixedFeeDetails": {
"amount": "0",
"exchangeRate": "0"
},
"percentageFeeDetails": {
"amount": "0"
}
},
"blockchainNetwork": "Polygon Testnet Amoy"
}
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": "358f5e37-4e15-424e-9479-3037cf68989a",
"accountId": "b1b6055babf12d7b18cbbe458248dfcb",
"syncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"sourceSyncedOwnerId": "25fb7453-67e8-4f4a-b741-f7cab0eac57d",
"debit": "42021000420000",
"timestamp": "2024-07-02T13:14:07.367Z",
"txType": "NETWORK_FEE",
"txSubType": "TOTAL_WITHDRAWAL_FEE",
"memo": "NETWORK_FEE of 0.00004202100042 MATIC_POLYGON 358f5e37-4e15-424e-9479-3037cf68989a",
"currency": "MATIC_POLYGON",
"exchangeRate": "1",
"balanceBefore": {
"amount": "6703815605906080377",
"balance": "6703815605906080377"
},
"balanceAfter": {
"amount": "6703773584905660377",
"balance": "6703773584905660377"
},
"feeEstimate": {
"totalFee": "42021000420000",
"networkFee": "42021000420000",
"ourFee": "42021000420000",
"theirFee": "0",
"feeCurrency": "MATIC_POLYGON",
"gasLimit": "21000",
"gasPrice": "2.002",
"fixedFeeDetails": {
"amount": "0",
"exchangeRate": "0"
},
"percentageFeeDetails": {
"amount": "0"
}
},
"blockchainNetwork": "Polygon Testnet Amoy"
}
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
}