Skip to main content

Fees and how amounts are calculated

A transfer can carry three fees: Nodu's service fee, your developer fee and a network fee. Nodu deducts them from the amount that funds the transfer.

The three fees​

FeeWho sets itCurrencyWhen it applies
serviceFeeNodu, as your agreement with Nodu defines it.The source currency.When your agreement sets one.
developerFeeYou. You send it in the quote or in the transfer, as a fixed amount and not as a percentage. It is your fee for the transfer.The source currency.When you send it, or when the transfer uses a quote containing it. Without either, the fee is 0.
networkFeeNodu, for the blockchain network's cost of the payout.The destination currency.On a payout to a crypto wallet. A payout to a bank account or to a Nodu wallet has no network fee.

From the amount paid to the amount received​

These are the steps of the breakdown of a quote. The amounts are decimal strings.

  1. initialAmount is the amount that funds the transfer.
  2. Nodu adds developerFee and serviceFee, and rounds the sum up to the decimal places of the source currency.
  3. subtotalAmount is initialAmount minus the fees, rounded down to the decimal places of the source currency.
  4. exchangedAmount is subtotalAmount multiplied by exchangeRate, rounded down to the decimal places of the destination currency. When no conversion is needed, exchangeRate=1.
  5. finalAmount is exchangedAmount minus networkFee, rounded down to the decimal places of the destination currency. Without a network fee, finalAmount equals exchangedAmount. The recipient receives finalAmount.

A fiat currency has the decimal places of its ISO 4217 definition, for example 2 for eur. A stablecoin has the decimal places of its token, for example 6 for usdc.

A worked example​

The customer pays 1000.00 EUR by SEPA. Nodu pays USDC to a crypto wallet. The fees and the rate are an illustration, not Nodu's prices.

StepFieldCalculationResult
1initialAmountThe amount that funds the transfer.1000.00 EUR
2developerFeeThe fee you set.5.00 EUR
2serviceFeeNodu's fee.3.50 EUR
3subtotalAmount1000.00 − 5.00 − 3.50991.50 EUR
4exchangeRateThe rate of the quote.1.0835
4exchangedAmount991.50 × 1.08351074.29025 USDC
5networkFeeThe fee for the payout on the blockchain network.0.05 USDC
5finalAmount1074.29025 − 0.051074.24025 USDC

The quote returns the same example in its breakdown:

"breakdown": {
"initialAmount": "1000.00",
"developerFee": "5.00",
"serviceFee": "3.50",
"subtotalAmount": "991.50",
"exchangeRate": "1.0835",
"exchangedAmount": "1074.29025",
"networkFee": "0.05",
"finalAmount": "1074.24025"
}

After the payout, the transfer's receipt carries the same amounts. It has no exchangedAmount. For a payout to a crypto wallet, it adds the transaction hash of the payout in destinationTxHash:

"receipt": {
"initialAmount": "1000.00",
"developerFee": "5.00",
"serviceFee": "3.50",
"subtotalAmount": "991.50",
"exchangeRate": "1.0835",
"networkFee": "0.05",
"finalAmount": "1074.24025",
"destinationTxHash": "0x0e2ada4c313e01de57cde340f15f77dd6ddc4cbd5a3ae84bfaaf719a07409685"
}

For incoming crypto, sourceTxHash identifies the funding transaction. Use both hashes for reconciliation; Retrieve a transfer returns the latest receipt.

Rounding shows in an off-ramp to a bank account. For example, an exchangedAmount of 457.626825 EUR becomes 457.62 EUR, because eur has two decimal places.

When the customer chooses the amount received​

When you create a quote with destination.amount, Nodu calculates the steps in reverse. It adds networkFee to finalAmount, divides by exchangeRate, then adds the fees. Nodu rounds up at each of these steps. The result is the quote's source.amount, which is the amount of the transfer. See Quotes and exchange rates.

The fees in a quote and in a transfer​

  • A quote returns all the fields of the calculation in breakdown. Show them to the customer before the customer confirms. Do not calculate the fees yourself: the quote returns them.
  • A transfer with a quote takes the fees, the exchange rate and the network fee from the quote. The fees stay as quoted. Nodu holds the exchange rate and the network fee for 15 minutes: see How long a transfer keeps the quoted rate.
  • A transfer without a quote calculates serviceFee when you create it. The exchange rate and the network fee are known only after Nodu converts the funds and sends the payout.

The transfer's receipt shows the amounts that apply to the transfer: initialAmount, developerFee, serviceFee, subtotalAmount, exchangeRate, networkFee and finalAmount. A field that is not known yet is absent.

If the amount does not cover the fees, Nodu refuses the quote or the transfer with a business rule violation. The error has rule=insufficient_transfer_amount. The detail field of the error states the amounts.

Next steps​