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.
Deposit network fee
Section titled “Deposit network fee”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.
Deposit commission
Section titled “Deposit commission”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.
Withdrawal network fee
Section titled “Withdrawal network fee”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
Section titled “Conversions”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.
Where to check exact amounts
Section titled “Where to check exact amounts”GET /currencies—depositNetworkFee,depositCommission,minDepositAmount,minWithdrawalAmountper crypto currencysettlementon a completed deposit or paid invoice (API and webhooks) —amountPaid,commissionAmount, andnetAmount(amountPaidminus the withheld deposit network fee andcommissionAmount).networkFeeAmountthere is the fee of the payer’s own inbound transaction, paid by their wallet, and is informationalPOST /withdrawal/quoteresponse —feebreakdown andtotalDeductionfor a specific withdrawal, andautoConvert.commissionAmountwhen 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