🔒Request crypto withdrawal

Request crypto withdrawal

post

An endpoint for initiating cryptocurrency withdrawals. The amount can be selected either in fiat or crypto which is defined by the targetAmountPolicy. 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)

Authorizations

Body

businessIdstring · uuidrequired

ID of the business from which the withdrawal should be executed.

clientWithdrawalIdstringrequired

Withdrawal identifier provided by the merchant.

recipientAddressstringrequired

Wallet address of the recipient.

destinationTagstringoptional

XLM/XRP destination tag.

networkstring · enumoptional

Specifies the network that should be used in this withdrawal.

For ERC20 Tokens you can choose between ETH, TRX and BSC as values for the network field. ETH stands for Ethereum network. This will be set as the default value when none is provided. TRX stands for TRON network. Before executing any withdrawals through this network, please make sure your address supports it. BSC stands for Binance Smart Chain. Before executing any withdrawals through this network, please make sure your address supports it.

Available options:

withdrawCurrencystring · enumrequired

Cryptocurrency that will be withdrawn.

Available options:

displayCurrencystring · enumrequired

Fiat currency.

Available options:

targetAmountPolicystring · enumrequired

Specifies if the targetAmount will be requested in fiat or crypto.

Available options:

targetAmountstringrequired

The requested amount to be withdrawn in fiat or crypto, depending on the provided targetAmountPolicy.

withdrawalAccountstring · enum · default: "the organisation's default setting"optional

Specifies which balance account should be charged for the withdrawal.

Available options:

blockchainFeePaidBystring · enum · default: "the business' default setting"optional

Specifies who pays the blockchain fee for the withdrawal.

Available options:

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/withdrawals' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "businessId": "407710f4-de33-454b-a47f-dda792e272c8",
    "clientWithdrawalId": "test-withdrawal-23-12-19-2",
    "recipientAddress": "0x5CF631Db2eB6be3eecB5E9fD0f31a19AC0F4C504",
    "network": "BSC",
    "withdrawCurrency": "USDC",
    "displayCurrency": "EUR",
    "targetAmount": "21",
    "targetAmountPolicy": "FIAT",
    "withdrawalAccount": "FIAT"
  }'

Initiate with display amount.Initiate with deposit amount.

201

202

201

Initiate with display amount.

Initiate with deposit amount.

Initiate with display amount.

{
  "withdrawId": "5724d752-6084-3822-9590-a6ccdf91f603",
  "clientWithdrawId": "test-withdrawal-23-12-19-2",
  "recipientAddress": "0x5CF631Db2eB6be3eecB5E9fD0f31a19AC0F4C504",
  "network": "BSC",
  "initiatedBy": "[e-mail]",
  "status": "PENDING",
  "displayCurrency": "EUR",
  "estimatedDisplayAmount": "21",
  "displayServiceFee": "0.25",
  "withdrawCurrency": "USDC",
  "estimatedWithdrawAmount": "23.01742298",
  "settlementCurrency": "EUR",
  "settlementDeductedAmount": "21.25",
  "settlementServiceFee": "0.25",
  "uniformCurrency": "EUR",
  "uniformAmount": "21",
  "uniformServiceFee": "0.25",
  "createdAt": 1702999367
}

Withdrawal request created successfully.