Deposit callbacks
To authenticate the callback, CryptoProcessing API signs the request with your API and secret keys:- X-Processing-Key – Your public key
- X-Processing-Signature – POST body, signed by your secret key HMAC-SHA512
Confirmed
- BTC
- ETH
- ERC-20
- Deposit BTC with exchange to EUR
{
"id": 1,
"end_user_reference": "12345",
"type": "deposit",
"crypto_address": {
"id": 1,
"currency": "BTC",
"address": "39mFf3X46YzUtfdwVQpYXPCMydc74ccbAZ",
"foreign_id": "user-id:2048",
"tag": null
},
"currency_sent": {
"currency": "BTC",
"amount": "6.53157512"
},
"currency_received": {
"currency": "BTC",
"amount": "6.53157512",
"amount_minus_fee": "6.5119800"
},
"transactions": [
{
"id": 1,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "deposit",
"address": "39mFf3X46YzUtfdwVQpYXPCMydc74ccbAZ",
"tag": null,
"amount": "6.53157512",
"txid": "3950ad8149421a850d01dff88f024810e363ac18c9e8dd9bc0b9116e7937ad93",
"riskscore": "0.5",
"confirmations": 3
}
],
"fees": [
{
"type": "deposit",
"currency": "BTC",
"amount": "0.01959472"
}
],
"error": "",
"status": "confirmed"
}
{
"id": 2686563,
"end_user_reference": "12345",
"type": "deposit",
"crypto_address": {
"id": 381738,
"currency": "ETH",
"address": "0xd61180ff0cf74dc3ee8e264751f18c47060729b9",
"tag": null,
"foreign_id": "991904"
},
"currency_sent": {
"currency": "ETH",
"amount": "0.01000000"
},
"currency_received": {
"currency": "ETH",
"amount": "0.01000000",
"amount_minus_fee": "0.00939500"
},
"transactions": [
{
"id": 714657,
"currency": "ETH",
"transaction_type": "blockchain",
"type": "deposit",
"address": "0xd61180ff0cf74dc3ee8e264751f18c47060729b9",
"tag": null,
"amount": "0.01000000",
"txid": "0x6b353da88a8ba2df4926c1ccc58991f484a683ba57ec3dde70e812b5c8c7fa1d",
"confirmations": "9"
}
],
"fees": [
{
"type": "transfer",
"currency": "ETH",
"amount": "0.00010500"
},
{
"type": "deposit",
"currency": "ETH",
"amount": "0.00050000"
}
],
"error": "",
"status": "confirmed"
}
{
"id": 2686567,
"end_user_reference": "12345",
"type": "deposit",
"crypto_address": {
"id": 382357,
"currency": "NNM",
"address": "0x19722627885da3fff134dd36de0a14898c8e053b",
"tag": null,
"foreign_id": "31"
},
"currency_sent": {
"currency": "NNM",
"amount": "0.06000000"
},
"currency_received": {
"currency": "NNM",
"amount": "0.06000000",
"amount_minus_fee": "0.05910000"
},
"transactions": [
{
"id": 714662,
"currency": "NNM",
"transaction_type": "blockchain",
"type": "deposit",
"address": "0x19722627885da3fff134dd36de0a14898c8e053b",
"tag": null,
"amount": "0.06000000",
"txid": "0x835c9f286a311bc9df8c94c2771cadf1d91e6967039358a44e24c56115dc59a1",
"confirmations": "7"
}
],
"fees": [
{
"type": "transfer",
"currency": "ETH",
"amount": "0.00037336"
},
{
"type": "deposit",
"currency": "NNM",
"amount": "0.00090000"
}
],
"error": "",
"status": "confirmed"
}
{
"id": 2686510,
"end_user_reference": "12345",
"type": "deposit_exchange",
"crypto_address": {
"id": 382270,
"currency": "BTC",
"convert_to": "EUR",
"address": "31vnLqxVJ1iShJ5Ly586q8XKucECx12bZS",
"tag": null,
"foreign_id": "13a"
},
"currency_sent": {
"currency": "BTC",
"amount": "0.01000000"
},
"currency_received": {
"currency": "EUR",
"amount": "84.17070222",
"amount_minus_fee": "79.96216711"
},
"transactions": [
{
"id": 714576,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "deposit",
"address": "31vnLqxVJ1iShJ5Ly586q8XKucECx12bZS",
"tag": null,
"amount": "0.01000000",
"txid": "3a491da90a1ce5a318d0aeff6867ab98a03219abae29ed68d702291703c3538b",
"riskscore": "0.42",
"confirmations": "1"
},
{
"id": 714577,
"currency": "BTC",
"currency_to": "EUR",
"transaction_type": "exchange",
"type": "exchange",
"amount": "0.01000000",
"amount_to": "84.17070222"
}
],
"fees": [
{
"type": "exchange",
"currency": "EUR",
"amount": "4.20853511"
}
],
"error": "",
"status": "confirmed"
}
Your risk score is used for coin compliance analysis and to reveal and track malicious behavior. Available for deposits and deposits with exchange in BTC, BCH, ETH.
Additional deposit callbacks
You can optionally enable callbacks for these cases:- deposits below the minimum allowed amount
- deposits received in a currency different from the currency assigned to the crypto address
- In the merchant dashboard, go to Settings and switch to the Callbacks tab.
- Under Additional callbacks, click Manage.

- Enable one or both of the following options, then click Save changes:
- Deposits less than minimum amount
- Deposits in a currency different from the original address currency
Cross-currency deposits
When a user makes a deposit in a currency different from the currency assigned to the original address, CryptoProcessing sends a callback to your configured callback URL. Example callback:{
"id": 2686510,
"end_user_reference": "12345",
"type": "deposit",
"expected_currency": "USDC",
"crypto_address": {
"id": 382270,
"currency": "ETH",
"address": "0xd61180ff0cf74dc3ee8e264751f18c47060729b9",
"tag": null,
"cross_currency": true,
"foreign_id": "13a"
},
"currency_sent": {
"currency": "ETH",
"amount": "0.01000000"
},
"currency_received": {
"currency": "ETH",
"amount": "0.01000000",
"amount_minus_fee": "0.00900000"
},
"transactions": [
{
"id": 714576,
"currency": "ETH",
"transaction_type": "blockchain",
"type": "deposit",
"address": "0xd61180ff0cf74dc3ee8e264751f18c47060729b9",
"tag": null,
"amount": "0.01000000",
"txid": "3a491da90a1ce5a318d0aeff6867ab98a03219abae29ed68d702291703c3538b",
"riskscore": "0.72",
"confirmations": "9"
},
],
"fees": [
{
"type": "transfer",
"currency": "ETH",
"amount": "0.00037336"
},
],
"error": "",
"status": "confirmed"
}
Deposits less than minimum amount
When a user sends less than the minimum allowed deposit amount for a currency, CryptoProcessing sends a callback to your configured callback URL. Example callback:{
"id": 2686563,
"end_user_reference": "12345",
"type": "deposit",
"crypto_address": {
"id": 381738,
"currency": "ETH",
"address": "0xd61180ff0cf74dc3ee8e264751f18c47060729b9",
"tag": null,
"foreign_id": "991904"
},
"transactions": [
{
"id": 714657,
"currency": "ETH",
"transaction_type": "blockchain",
"type": "deposit",
"address": "0xd61180ff0cf74dc3ee8e264751f18c47060729b9",
"tag": null,
"amount": "0.00100000",
"txid": "0x6b353da88a8ba2df4926c1ccc58991f484a683ba57ec3dde70e812b5c8c7fa1d",
"confirmations": "9"
}
],
"fees": [],
"error": "Transaction amount less than minimum deposit",
"status": "cancelled"
}
Withdrawal callbacks
- BTC
- ETH
- ERC-20
- Withdraw EUR with exchange to BTC
{
"id": 1,
"foreign_id": "10",
"end_user_reference": "12345",
"type": "withdrawal",
"crypto_address": {
"id": 1,
"currency": "BTC",
"address": "115Mn1jCjBh1CNqug7yAB21Hq2rw8PfmTA",
"tag": null
},
"currency_sent": {
"currency": "BTC",
"amount": "0.02000000"
},
"currency_received": {
"currency": "BTC",
"amount": "0.02000000"
},
"transactions": [
{
"id": 1,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "withdrawal",
"address": "115Mn1jCjBh1CNqug7yAB21Hq2rw8PfmTA",
"tag": null,
"amount": "0.02",
"txid": "bb040d895ef7141ea0b06b04227d8f5dd4ee12d5b890e6e5633f6439393a666b",
"confirmations": 3
}
],
"fees": [
{
"type": "mining",
"currency": "BTC",
"amount": "0.00007402"
},
{
"type": "withdrawal",
"currency": "BTC",
"amount": "0.00002000"
}
],
"error": "",
"status": "confirmed"
}
{
"id": 2686565,
"foreign_id": "23",
"end_user_reference": "12345",
"type": "withdrawal",
"crypto_address": {
"id": 381460,
"currency": "ETH",
"address": "0x2D6CA312567986C08CC4eF3F706136D1c9eF0321",
"tag": null
},
"currency_sent": {
"currency": "ETH",
"amount": "0.01000000"
},
"currency_received": {
"currency": "ETH",
"amount": "0.01000000"
},
"transactions": [
{
"id": 714660,
"currency": "ETH",
"transaction_type": "blockchain",
"type": "withdrawal",
"address": "0x2D6CA312567986C08CC4eF3F706136D1c9eF0321",
"tag": null,
"amount": "0.01000000",
"txid": "0x1ccb9fa0ef5e8cf7d4cc2a23fe8119170a2a3d08fba36036665a12c88d7bcccb",
"confirmations": "0"
}
],
"fees": [
{
"type": "mining",
"currency": "ETH",
"amount": "0.00010500"
},
{
"type": "withdrawal",
"currency": "ETH",
"amount": "0.00010000"
}
],
"error": "",
"status": "confirmed"
}
{
"id": 2686572,
"foreign_id": "5",
"end_user_reference": "12345",
"type": "withdrawal",
"crypto_address": {
"id": 381734,
"currency": "NNM",
"address": "0x2D6CA312567986C08CC4eF3F706136D1c9eF0321",
"tag": null
},
"currency_sent": {
"currency": "NNM",
"amount": "4.45600000"
},
"currency_received": {
"currency": "NNM",
"amount": "4.45600000"
},
"transactions": [
{
"id": 714670,
"currency": "NNM",
"transaction_type": "blockchain",
"type": "withdrawal",
"address": "0x2D6CA312567986C08CC4eF3F706136D1c9eF0321",
"tag": null,
"amount": "4.45600000",
"txid": "0x884ad10cc60dfe0d6fdc776b541c5c5efce6151886a88994bb4ba41aa9575563",
"confirmations": "0"
}
],
"fees": [
{
"type": "mining",
"currency": "ETH",
"amount": "0.00007480"
},
{
"type": "withdrawal",
"currency": "NNM",
"amount": "0.04456000"
}
],
"error": "",
"status": "confirmed"
}
{
"id": 1,
"foreign_id": "20",
"end_user_reference": "12345",
"type": "withdrawal_exchange",
"crypto_address": {
"id": 1,
"currency": "EUR",
"convert_to": "BTC",
"address": "1K2btnZ8cqNFBPhaq729Mdj8W6G3w2nBbL",
"tag": null
},
"currency_sent": {
"currency": "EUR",
"amount": "381"
},
"currency_received": {
"currency": "BTC",
"amount": "0.10882300"
},
"transactions": [
{
"id": 1,
"currency": "EUR",
"currency_to": "BTC",
"transaction_type": "exchange",
"type": "exchange",
"amount": 381,
"amount_to": 0.10882300
},
{
"id": 1,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "withdrawal",
"address": "1K2btnZ8cqNFBPhaq729Mdj8W6G3w2nBbL",
"tag": null,
"amount": 0.10882300,
"txid": "aa3345b96389e126f1ce88a670d1b1e38f2c3f73fb3ecfff8d9da1b1ce6964a6",
"confirmations": 3
}
],
"fees": [
{
"type": "exchange",
"currency": "EUR",
"amount": "3.04800000"
},
{
"type": "mining",
"currency": "EUR",
"amount": "0.04489780"
}
],
"error": "",
"status": "confirmed"
}
Exchange callbacks
- Buy BTC for EUR
- Sell BTC for USD
{
"id": 2686900,
"type": "exchange",
"currency_sent": {
"currency": "EUR",
"amount": "26.75248865"
},
"currency_received": {
"currency": "BTC",
"amount": "0.00300000"
},
"transactions": [
{
"id": 715072,
"currency": "EUR",
"currency_to": "BTC",
"transaction_type": "exchange",
"type": "exchange",
"amount": "26.75248865",
"amount_to": "0.00300000"
}
],
"fees": [
{
"type": "exchange",
"currency": "EUR",
"amount": "0.26752489"
}
],
"error": "",
"status": "confirmed"
}
{
"id": 2686901,
"type": "exchange",
"currency_sent": {
"currency": "BTC",
"amount": "0.00300000"
},
"currency_received": {
"currency": "USD",
"amount": "29.50408884"
},
"transactions": [
{
"id": 715072,
"currency": "BTC",
"currency_to": "USD",
"transaction_type": "exchange",
"type": "exchange",
"amount": "0.00300000",
"amount_to": "29.50408884"
}
],
"fees": [
{
"type": "exchange",
"currency": "USD",
"amount": "0.29504089"
}
],
"error": "",
"status": "confirmed"
}
Invoices
Invoice payment callbacks
- Successful payment
- Transaction is in the mempool
- Invoice payment by installments
- Timer expired
- Processing status for more than 24 hours
- Payment is lesser than invoice amount
{
"id": 588,
"foreign_id": "8FW1KI7LesB9yxWcK1K",
"end_user_reference": "12345",
"type": "invoice",
"crypto_address": {
"id": 386897,
"currency": "BTC",
"address": "2Mvo6FMduhHz1BTDHsQ5GyRoifcG3y4ycpk",
"tag": null
},
"currency_sent": {
"currency": "BTC",
"amount": "0.02000000",
"remaining_amount": "0.01000000"
},
"currency_received": {
"currency": "BTC",
"amount": "0.02000000"
},
"transactions": [
{
"id": 750294,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "deposit",
"address": "2Mvo6FMduhHz1BTDHsQ5GyRoifcG3y4ycpk",
"tag": null,
"amount": "0.01000000",
"txid": "528dcda13270f8590853405600bf5634d53aa66d2ce5d3a873006a670f9da788",
"confirmations": "0"
}
],
"fees": [
{
"type": "fee_crypto_deposit",
"currency": "BTC",
"amount": "0.0008"
}
],
"error": "",
"status": "confirmed",
"fixed_at": 1592307241,
"expires_at": 1592308141
}
{
"id": 22,
"foreign_id": "229-hdsa",
"end_user_reference": "12345",
"type": "invoice",
"crypto_address": {
"id": 1845,
"currency": "BTC",
"convert_to": "EUR",
"address": "2N8pvnVKEFjVCP4TteJVCPTbg9Aqibfws8C",
"tag": null
},
"currency_sent": {
"currency": "BTC",
"amount": "0.00309556",
"remaining_amount": "0.00000000"
},
"currency_received": {
"currency": "EUR",
"amount": "26.00000000"
},
"transactions": [
{
"id": 1504,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "deposit",
"address": "2N8pvnVKEFjVCP4TteJVCPTbg9Aqibfws8C",
"tag": null,
"amount": "0.00309556",
"txid": "3e68744626ba23d591dc1b548b8b9b126ab0f49e6da020958f66ee64c38ec7ed",
"confirmations": "0"
}
],
"fees": [
{
"type": "fee_crypto_deposit",
"currency": "BTC",
"amount": "0.04179006"
}
],
"error": "",
"status": "processing",
"fixed_at": 1592308917,
"expires_at": 1592395375
}
{
"id": 588,
"foreign_id": "8FW1KI7LesB9yxWcK1K",
"end_user_reference": "12345",
"type": "invoice",
"crypto_address": {
"id": 386897,
"currency": "BTC",
"address": "2Mvo6FMduhHz1BTDHsQ5GyRoifcG3y4ycpk",
"tag": null
},
"currency_sent": {
"currency": "BTC",
"amount": "0.02000000",
"remaining_amount": "0.00000000"
},
"currency_received": {
"currency": "BTC",
"amount": "0.02000000"
},
"transactions": [
{
"id": 750294,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "deposit",
"address": "2Mvo6FMduhHz1BTDHsQ5GyRoifcG3y4ycpk",
"tag": null,
"amount": "0.01000000",
"txid": "6647cf5cae701507b7076b32ca12f19d8e9fe037407c02e09b04abdaede99fd0",
"confirmations": "1"
},
{
"id": 750384,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "deposit",
"address": "2Mvo6FMduhHz1BTDHsQ5GyRoifcG3y4ycpk",
"tag": null,
"amount": "0.01000000",
"txid": "528dcda13270f8590853405600bf5634d53aa66d2ce5d3a873006a670f9da788",
"confirmations": "1"
}
],
"fees": [
{
"type": "fee_crypto_deposit",
"currency": "BTC",
"amount": "0.0008"
}
],
"error": "",
"status": "confirmed",
"fixed_at": 1592307241,
"expires_at": 1592394104
}
{
"id": 23,
"foreign_id": "77xa2pd",
"end_user_reference": "12345",
"type": "invoice",
"crypto_address": {
"id": 1846,
"currency": "BTC",
"address": "2MyL2ftBdNsmpsx1EKggPzNVuoiZCWdVaLX",
"tag": null
},
"currency_sent": {
"currency": "BTC",
"amount": "0.02000000",
"remaining_amount": "0.02000000"
},
"currency_received": {
"currency": "BTC",
"amount": "0.02000000"
},
"transactions": [],
"fees": [],
"error": "Timer expired. User not paid.",
"status": "failed",
"fixed_at": 1592309817,
"expires_at": 1592310717
}
{
"id": 21,
"foreign_id": "88smaan2",
"end_user_reference": "12345",
"type": "invoice",
"crypto_address": {
"id": 1844,
"currency": "BTC",
"address": "2NCfH4keMq2SZj3H73VeQYtb8yBgTuUrACf",
"tag": null
},
"currency_sent": {
"currency": "BTC",
"amount": "0.01000000",
"remaining_amount": "0.00990000"
},
"currency_received": {
"currency": "BTC",
"amount": "0.01000000"
},
"transactions": [
{
"id": 1505,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "deposit",
"address": "2NCfH4keMq2SZj3H73VeQYtb8yBgTuUrACf",
"tag": null,
"amount": "0.00010000",
"txid": "6dd68265eb2b3a1be0dd4a40975345155d0fbbe244c84efcc7f6b910629a38f9",
"confirmations": "0"
}
],
"fees": [
{
"type": "fee_crypto_deposit",
"currency": "BTC",
"amount": "0.0008"
}
],
"error": "Timer expired. Transactions were in status processing too long.",
"status": "failed",
"fixed_at": 1592308709,
"expires_at": 1592309609
}
{
"id": 21,
"foreign_id": "88smaan2",
"end_user_reference": "12345",
"type": "invoice",
"crypto_address": {
"id": 1844,
"currency": "BTC",
"address": "2NCfH4keMq2SZj3H73VeQYtb8yBgTuUrACf",
"tag": null
},
"currency_sent": {
"currency": "BTC",
"amount": "0.01000000",
"remaining_amount": "0.00990000"
},
"currency_received": {
"currency": "BTC",
"amount": "0.01000000"
},
"transactions": [
{
"id": 1505,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "deposit",
"address": "2NCfH4keMq2SZj3H73VeQYtb8yBgTuUrACf",
"tag": null,
"amount": "0.00010000",
"txid": "6dd68265eb2b3a1be0dd4a40975345155d0fbbe244c84efcc7f6b910629a38f9",
"confirmations": "2"
}
],
"fees": [
{
"type": "fee_crypto_deposit",
"currency": "BTC",
"amount": "0.0008"
}
],
"error": "Timer expired. User paid less than requested.",
"status": "failed",
"fixed_at": 1592308709,
"expires_at": 1592309609
}
Callbacks with other statuses
- Not confirmed
- Cancelled
- Declined
{
"id": 2686579,
"end_user_reference": "12345",
"type": "deposit",
"crypto_address": {
"id": 381711,
"currency": "BTC",
"address": "2N9zXNdiT8ucZp7zZSrucqYGCD6xYF8F3di",
"tag": null,
"foreign_id": "991904"
},
"currency_sent": {
"currency": "BTC",
"amount": "0.01000000"
},
"currency_received": {
"currency": "BTC",
"amount": "0.01000000",
"amount_minus_fee": "0.01000000"
},
"transactions": [
{
"id": 714680,
"currency": "BTC",
"transaction_type": "blockchain",
"type": "deposit",
"address": "2N9zXNdiT8ucZp7zZSrucqYGCD6xYF8F3di",
"tag": null,
"amount": "0.01000000",
"txid": "998c4d9bb7145aafd88658b292f41fe05973c217f7adcd6052bcafe2309e7e02",
"confirmations": "0"
}
],
"fees": [],
"error": "",
"status": "not_confirmed"
}
{
"id": 2686580,
"foreign_id": "123",
"end_user_reference": "12345",
"type": "withdrawal",
"crypto_address": {
"id": 382362,
"currency": "ETH",
"address": "12345",
"tag": null
},
"transactions": [
{
"id": 714681,
"currency": "ETH",
"transaction_type": "blockchain",
"type": "withdrawal",
"address": "12345",
"tag": null,
"amount": "1.00000000",
"txid": null,
"confirmations": "0"
}
],
"fees": [],
"error": "Invalid params: expected a hex-encoded hash with 0x prefix.",
"status": "cancelled"
}
{
"id": 2686580,
"foreign_id": "123",
"type": "withdrawal",
"crypto_address": {
"id": 382362,
"currency": "ETH",
"address": "12345",
"tag": null
},
"transactions": [
{
"id": 714681,
"currency": "ETH",
"transaction_type": "blockchain",
"type": "withdrawal",
"address": "12345",
"tag": null,
"amount": "1.00000000",
"txid": null,
"riskscore": null,
"confirmations": "0"
}
],
"fees": [],
"error": "Declined by user ID:304",
"status": "declined"
}