1. Reference
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Balances & History
      • Get Balances
      • Get Balance History
    • Crypto Deposits
      • Get Crypto Deposit Details
      • Add Travel Rule
    • Crypto Withdrawals
      • Get Whitelisted Wallets
      • Add Whitelisted Wallet
      • Delete Whitelisted Wallet
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
    • SEPA Deposits
      • Get SEPA Payment Details
      • Get SEPA Deposit Details
    • SEPA Withdrawals
      • Create SEPA Withdrawal
      • Get SEPA Withdrawal Details
    • Currency Exchange
      • Get Rates
      • Create Lock
      • Create Exchange
      • Get Exchange Details
  • Integration
    • Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • Crypto Deposit Webhook
      • Crypto Withdrawal Webhook
      • SEPA Deposit Webhook
      • SEPA Withdrawal Webhook
      • Exchange Webhook
  • Reference
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Reference

Fees

This guide explains the fees applied in the Fintegence Partner API and how to calculate the amounts of withdrawals and exchanges before you execute them.

Overview#

Fee levels are commercial terms defined in your partnership agreement. The fees that apply to your account are always returned by Get Balances, so you can read them at any time instead of hard-coding them.
OperationFeeWhere to find it
Crypto withdrawalFixed amount per networkcryptoBalances[].networks[].withdrawal.feeAmount
SEPA withdrawalFixed amountfiatBalances[].withdrawal.feeAmount
ExchangePercentage of the converted amountexchange.feePercent of the destination balance
DepositNo fee-
For the list of supported currencies and networks, see Supported Currencies.

Withdrawal Fees#

The withdrawal fee is a fixed amount in the currency of the balance. It is included in the requested amount - the balance is debited with amount, and the recipient receives amount - fee. The fee covers the blockchain network fee, so no additional network fee is charged.
withdrawal.minAmount also includes the fee - it is the smallest amount you can request.

Example: DOGE withdrawal#

With withdrawal.feeAmount: "10" and withdrawal.minAmount: "20":
Requested amountDebited from balanceFeeRecipient receives
2020 DOGE10 DOGE10 DOGE
100100 DOGE10 DOGE90 DOGE
Because the fee is included in amount, you can withdraw the full balance - the recipient receives the balance minus the fee.
To send an exact amount to the recipient, request amount = recipientAmount + feeAmount.

Exchange Fees#

The exchange fee is defined by exchange.feePercent of the destination balance. It is a fraction - 0.1 means 10%, 0 means no fee. The fee is calculated from the converted amount and charged in the destination currency.
totalDestinationAmount = sourceAmount * rate   (rounded down to the destination precision)
fee                    = totalDestinationAmount * feePercent
destinationAmount      = totalDestinationAmount - fee
You do not need to calculate this yourself - Create Lock returns the exact fee, totalDestinationAmount and destinationAmount before you execute the exchange.

Example: DOGE to EUR#

With sourceAmount: "10", rate: "0.0725" and feePercent of the EUR balance "0.1":
FieldValue
totalDestinationAmount0.72 EUR
fee0.07 EUR
destinationAmount0.65 EUR

Deposit Fees#

Deposits are free. The balance is credited with the full deposited amount, and the fee field of deposits is always 0.

Read fees close to execution
Fees and minimum amounts can change according to your commercial terms. Read them from Get Balances shortly before creating a withdrawal or an exchange, instead of storing them permanently.

Related Documentation#

Crypto Withdrawals
SEPA Withdrawals
Currency Exchange
Supported Currencies
Previous
Supported Currencies
Next
FAQ
Built with