🔒Request crypto withdrawal
Initiate withdrawal request
POST
https://payments.finrax.com/api/v1/withdrawals
An endpoint for initiating cryptocurrency withdrawals. The amount can be selected either in fiat
or crypto
which is being defined by the targetAmountPolicy
Request Body
Name | Type | Description |
---|---|---|
businessId* | string | ID of the business from which the withdrawal should be executed. |
clientWithdrawalId* | string | Withdrawal identifier provided by you |
recipientAddress* | string | Wallet address of the recipient |
destinationTag | string | Applicable for |
network | string | Specifies the network that should be used in this withdrawal. For ERC20 Tokens you can choose between
For cryptocurrencies, other than ERC20 ones, the available network are To see the network values that are available for any currency, please check the table at the bottom of this page. |
withdrawCurrency* | string | Cryptocurrency abbreviation that should be withdrawn e.g. |
displayCurrency* | string | Fiat currency abbreviation for pairing e.g. |
blockchainFeePaidBy | string | Determine who will pay the blockchain fee for this withdrawal. Available options are |
targetAmountPolicy* | string | Specifies if the |
targetAmount* | string | The requested amount to be withdrawn in |
withdrawalAccount | string | Specifies which balance account should be charged for the withdrawal. One of |
Response bodies:
If the request was successful and there are no withdrawal rules configured, then we will send a 201 status code. In case a withdrawal rule was triggered and the withdrawal requires approval, we will send a 202 status code and the response as seen on the second tab below.
What is targetAmountPolicy?
targetAmountPolicy?
The targetAmountPolicy
field provides the means for specifying the withdrawal amount either in FIAT
currency or CRYPTO
currency. When FIAT
is selected as policy the resulting amount of the withdrawal in crypto will be calculated according to the fiat amount passed in targetAmount
field. When CRYPTO
is selected as policy the resulting amount of the withdrawal will be exactly the same as the amount passed in targetAmount
field (subject to a negligible difference due to market conditions i.e. market step size)
List of currencies and their supported withdrawal networks
Currency | Supported networks |
---|---|
BTC | BTC |
BCH | BCH |
ETH | ETH, BSC |
LINK | ETH |
LTC | LTC |
USDC | ETH, BSC, SOL |
XLM | XLM |
XRP | XRP |
SOL | SOL |
Last updated