Skip to content

Fees and commissions

Cryptonly applies fees at a few distinct points in the payment flow. Rates can be organization-specific — always read the actual rate from the API response rather than hardcoding it.

Every deposit gets its own on-chain address. Once the deposit completes, Cryptonly moves the funds from that address to its own wallet, and that transfer costs a network fee. The payer covers it:

  • Invoices: the fee is added on top of the invoice amount when the customer picks a currency. The payment page shows it in the invoice’s fiat currency (for example, “Fee ~0.42 $ · Approx. 2 min”). The crypto amount to send already includes it.
  • Deposits: the fee is withheld from the received amount. The deposit page shows a “You pay network fee” badge.

The fee is fixed when the deposit is created, so later gas price changes don’t affect it. It is taken before the commission is calculated, so you don’t pay commission on it.

The current fee per currency is returned as depositNetworkFee on GET /currencies and refreshes every few minutes. While it is null, new deposits and invoice payments in that currency are temporarily refused (503, code exceptions.depositFee.quoteUnavailable), and the currency is hidden from the payment page.

Every completed deposit — standalone or invoice-linked — has a commission deducted before the remainder is credited to your balance. The commission is calculated on the received amount minus the deposit network fee. The effective rate for your organization is returned as depositCommission on GET /currencies.

POST /withdrawal/quote returns a fee breakdown with the real on-chain network fee, in both the network’s base currency (feeNative/feeCurrency) and the withdrawal currency. This fee, plus the withdrawal amount, is debited from your balance when the quote is committed — see Withdrawals lifecycle.

Conversions between USDT and USDC are free and convert at 1:1. Every other pair has a 0.05% commission.

The commission is in the source asset and is included in the amount debited. For example, converting 1 BTC to USDT debits 1 BTC: 0.0005 BTC is the commission, and the remaining 0.9995 BTC converts at the current rate.

The same rule applies to conversions in the Cryptonly Merchant Dashboard, deposit auto-conversion, and auto-converting on a withdrawal. See Balances, transfers, and conversions.

  • GET /currencies — depositNetworkFee, depositCommission, minDepositAmount, minWithdrawalAmount per crypto currency
  • settlement on a completed deposit or paid invoice (API and webhooks) — amountPaid, commissionAmount, and netAmount (amountPaid minus the withheld deposit network fee and commissionAmount). networkFeeAmount there is the fee of the payer’s own inbound transaction, paid by their wallet, and is informational
  • POST /withdrawal/quote response — fee breakdown and totalDeduction for a specific withdrawal, and autoConvert.commissionAmount when a conversion covers a shortfall
  • Conversion quote in the Cryptonly Merchant Dashboard — the commission before you confirm
  • Transaction History detail drawer (Accounts → History) — commission and net credited amount for any past deposit, and the commission on a conversion