Guides

IBAN Withdraw

Suggest Edits

To withdraw funds from an IBAN account, you can use one of the following options:

  • Buying cryptocurrency from an IBAN account.
  • Transfer funds to an external IBAN.

Option 1. Buying cryptocurrency from IBAN

Endpoint:

POST /wallet/direct-exchange

Use this endpoint to initiate a request to exchange funds on your IBAN account for cryptocurrency. dryRun request parameter allows to simulate an operation without actually executing or persisting any changes.

Query Parameters:

NameTypeRequiredDescription
dryRunboolean➖This parameter allows to check resulting rate and fee amount without executing any operation. If true, the API simulates the operation without executing it. This allows you to preview exchange rates, fees, and other details before committing. The actual operation will only proceed if dryRun is omitted or explicitly set to false.

Body Parameters:

NameTypeRequiredDescription
fromAccountstring✅Identifies the BANK_ACCOUNT_VIRTUAL type of account initiating the exchange. All accounts can be retrieved using List all accounts endpoint.
fromCurrencystring➖The original currency of the amount before conversion. Defaults to EURO
toAccountstring➖Identifies destination CHECKING type of account for the exchange. All accounts can be retrieved using List all accounts endpoint.
toCurrencystring✅The destination currency after conversion.
fromAmountstring➖The amount in the source currency.
toAmountstring➖The amount in the target currency.

Response Example:

   {
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "fromAccount": "string",
  "toAccount": "string",
  "fromCurrency": "USDT",
  "toCurrency": "EPI",
  "fromAmount": "10.2",
  "toAmount": "9.87",
  "signedRate": {
    "rateRequest": {
      "fromCurrency": "string",
      "toCurrency": "string",
      "amount": "string",
      "account": "string",
      "partner": "string"
    },
    "rate": "1.12",
    "validUntil": "string",
    "signature": "string"
  },
  "feeAmount": "0.01",
  "feeCurrency": "USDT",
  "status": "SUCCESS",
  "note": "string",
  "createdAt": "2025-07-23T17:29:45.507Z",
  "updatedAt": "2025-07-23T17:29:45.507Z"
}

Option 2. Transferring funds to an external IBAN

Endpoint:

POST /wallet/withdraw

Use this endpoint to submit a withdrawal request.

Query Parameters:

NameTypeRequiredDescription
dryRunboolean➖This parameter allows to check resulting rate and fee amount without executing any operation. If true, the API simulates the operation without executing it. This allows you to preview exchange rates, fees, and other details before committing. The actual operation will only proceed if dryRun is omitted or explicitly set to false.
autoConversionboolean➖Enables automatic currency conversion.

Body Parameters:

FieldTypeRequiredDescription
currencystring✅The currency in which the transfer is made. Defaults to EURO
amountstring✅The amount of money to transfer.
typestring✅The type of withdrawal: bank transfer.
fromAccountstring✅Identifies the BANK_ACCOUNT_VIRTUAL type of account initiating the transfer. All accounts can be retrieved using List all accounts endpoint.
ibanstring➖IBAN number for the bank transfer.
bicOrSwiftCodestring➖BIC or SWIFT code of the bank.

Response Example:

   {
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "currency": "string",
  "amount": "10.2",
  "type": "string",
  "fromAccount": "string",
  "feeAmount": "10.2",
  "status": "PROCESSED",
  "createdAt": "2025-07-24T09:51:16.197Z",
  "updatedAt": "2025-07-24T09:51:16.197Z"
}

📘

Remarks

  • All withdrawals require email confirmation. A verification email will be sent upon successful API call and will be valid for 30 minutes.
  • A fee may be charged on all withdrawal and exchange operations if configured.
  • All transactions connected with the target BANK_ACCOUNT_VIRTUAL type of account can be filtered and retrieved by the Get Crypto and IBAN Transactions History endpoint.
  • Exchange pairs, minimum and maximum limits and rates can be retrieved via the Get Exchange Pair List endpoint.

Updated 3 days ago