Withdrawal broadcast notification

Currently, we support 9 cryptocurrencies as a payout option. Once you initiate a withdrawal we need to take care of a couple of things before we successfully broadcast it to the network. Withdrawals take on average 10 minutes to be broadcast on the designated blockchain network. Upon completion, you'll receive a callback notification.

If our initial attempt to send a notification fails, we will retry sending it every 2 minutes for up to 24 hours. Once the notification is successfully delivered, all retries will stop. If unsuccessful after 24 hours, retry attempts will cease.

This callback notification is sent on your withdrawalCallbackUrl endpoint.

Success

{
    "status": "COMPLETED",
    "clientWithdrawalId": "Example-Withdrawal",
    "businessId": "19dee3c4-4dc9-4bcc-b8ed-92e3d4f256bd",
    "withdrawalId": "9b479a98-99ed-4bf9-87e0-4a05dbb012b6",
    "displayCurrency": "TRY",
    "withdrawCurrency": "XRP",
    "settlementCurrency": "USDC",
    "expectedDisplayAmount": "200.00000000",
    "actualDisplayAmount": "200.00000000",
    "estimatedWithdrawAmount": "119.63196400",
    "actualWithdrawAmount": "119.66467800",
    "deductedSettlementAmount": "35.28559158",
    "withdrawFee": "0.25000000",
    "displayFee": "0.42000000",
    "displayRateDepegLossAmount":"0.49",
    "settlementRateDepegLossAmount": "0.48",
    "toTxAddress": "rLsVuk4hgmGUtjQKj1ybpg1etnFodZ4CJ?dt=140",
    "transactionId": "1AABB14A963442246EC6252B6FDCC72223544B9BBB9E28C431DF2F1C B3545DB5",
    "txAddressOwner": {
        "name": "Coinbase",
        "category": "Exchange"
  }
}

Failure

{
  "status": "FAILED",
  "clientWithdrawalId": "Example-Withdrawal",
  "businessId": "4e1a3d4a-c8c4-48c6-8a26-d3520a543521",
  "withdrawalId": "77a01c0e-7983-4acd-83bf-0d43b29bdee6",
  "displayCurrency": "USD",
  "withdrawCurrency": "BTC",
  "settlementCurrency": "USDC",
  "expectedDisplayAmount": "60.00",
  "estimatedWithdrawAmount": "0.00113791",
  "toTxAddress": "bc1qu7fvyhtcyd7fjueup7azqrqakw5fxkfex7me92",
  "txAddressOwner": {
    "name": "Darknet Shop",
    "category": "Darknet"
  }
}

Blocked

{
  "status": "BLOCKED",
  "businessId": "407710f4-de33-454b-a44f-dda322q172a3",
  "displayFee": null,
  "toTxAddress": "ltc1qsv25klhsr4df87xqhe6rz0jyzark04khveuejq",
  "withdrawFee": null,
  "withdrawalId": "c76b2dca-1eff-37af-8646-3f5001165f9a",
  "transactionId": null,
  "txAddressOwner": {
    "name": "Unknown",
    "category": "Unknown"
  },
  "displayCurrency": "EUR",
  "withdrawCurrency": "LTC",
  "clientWithdrawalId": "client-withdrawal-1",
  "settlementCurrency": "EUR",
  "actualDisplayAmount": null,
  "actualWithdrawAmount": null,
  "settlementServiceFee": null,
  "expectedDisplayAmount": "20.07",
  "estimatedWithdrawAmount": "0.17659901",
  "deductedSettlementAmount": null,
  "displayRateDepegLossAmount": null,
  "settlementRateDepegLossAmount": null,
  "settlementMerchantTransactionFee": null
}

Schema

Parameter	Type	Description
status	string [required]	One ofCOMPLETED, FAILED or BLOCKED
clientWithdrawalId	string [required]	Unique withdrawal identifier provided by the merchant in the request body of POST /withdrawals
businessId	string [required]	Unique Finrax business identifier UUID
withdrawalId	string [required]	Unique Finrax withdrawal identifier UUID
displayCurrency	string [required]	The fiat currency chosen for display (denomination) purposes
withdrawCurrency	string [required]	Cryptocurrency to be withdrawn
settlementCurrency	string [required]	The currency in which the merchant's account was debited because of the withdrawal (can be either fiat or cryptocurrency)
expectedDisplayAmount	number [required]	Amount in displayCurrency requested for this payment
actualDisplayAmount	number [optional]	Actual amount withdrawn in displayCurrency currency (e.g.EUR, USD, GBP, TRY etc..)Can be different than expectedDisplayAmount
estimatedWithdrawAmount	number [required]	Estimated amount for this withdrawal. Can be different than actualWithdrawAmount
actualWithdrawAmount	number [optional]	Actual amount withdrawn in withdrawCurrencyCan be different than estimatedWithdrawAmount
deducedSettlementAmount	number [optional]	Amount debited from the merchant's balance in settlementCurrency
withdrawFee	number [optional]	Blockchain cost for this withdrawal in withdrawCurrency
displayFee	number [optional]	Blockchain cost for this withdrawal in displayCurrency
displayRateDepegLossAmount	number [optional]	Loss incurred from the pegging of withdrawal and display currencies market rate in displayCurrency.
settlementRateDepegLossAmount	number [optional]	Loss incurred from the pegging of withdrawal and display currencies market rate in settlementCurrency.
toTxAddress	string [required]	The address to which the actualWithdrawAmountwas sent
transactionId	string [optional]	Unique blockchain transaction ID of the withdrawal
txAddressOwner	object [required]	Address AML screening results
name	string [required]	Address owning entity name
category	string [required]	Address owning entity category