Buyer fees vs. merchant fees
Tilta supports two distinct fee directions. Each operates independently, and you can configure one, both, or neither depending on your business model.Buyer fee (agio)
A premium charged to the buyer on top of the gross invoice value. It increases the total amount the buyer must repay. Useful when you want buyers to bear the cost of deferred payment terms.
Merchant fee (disagio)
A discount deducted from the gross invoice value before paying out to the merchant. It reduces the net amount the merchant receives. Useful when you want sellers to fund the cost of offering payment terms.
Fee configuration modes
Flat fee
In Flat Fee mode, you define a single fee percentage for each payment term, applied uniformly to all buyers regardless of their credit profile.
Flat fees are the simplest configuration to operate and communicate to your merchants and buyers. Use them when you want a consistent, predictable fee structure across your platform.
Risk-based fee
In Risk-Based Fee mode, fees vary by the buyer’s risk tier – assigned by Tilta’s underwriting engine based on the buyer’s creditworthiness. Higher-risk buyers pay higher buyer fees, while merchant fees remain consistent across tiers. Risk tiers range fromA1 (lowest risk) to B2 (higher risk). The example below shows how fees scale across tiers for 30-, 60-, and 90-day terms:
Risk-based fees let you price risk accurately: lower-risk buyers receive more competitive terms, which can increase conversion among your best buyers, while higher-risk buyers pay a premium that reflects the additional credit exposure.
Fee calculation: Worked examples
Buyer fee calculation
Consider an order with the following parameters:- Order net value: €1,000.00
- VAT rate: 19%
- Gross invoice value: €1,000.00 × 1.19 = €1,190.00
- Buyer Fee rate: 2% (applied to gross)
€1,190.00 × 2% = €23.80Step 2: Calculate VAT on the fee
€23.80 × 19% = €4.52Step 3: Calculate the total buyer repayment obligation
€1,190.00 (invoice gross) + €23.80 (net fee) + €4.52 (fee VAT) = €1,218.32The buyer repays €1,218.32 in total on the due date.
Merchant fee calculation
Using the same base invoice:- Gross invoice value: €1,190.00
- Merchant Fee rate: 3% (applied to gross)
€1,190.00 × 3% = €35.70Step 2: Calculate VAT on the fee
€35.70 × 19% = €6.78Step 3: Calculate the merchant payout
€1,190.00 − €35.70 (net fee) − €6.78 (fee VAT) = €1,147.52The merchant receives €1,147.52 in their payout when the financing contract advances the full invoice face. A lower advance rate pays that fraction of the face instead, and holds the remainder back until the buyer pays. Fees, including VAT, come out of the face first. If they would leave nothing to hold back, the payout is capped at the face minus fees and the holdback is zero. Omitting the rate keeps the full-face payout above.
advance_rate belongs on invoice_services.financing only. It is a fraction greater than 0 and at most 1, so 0.9 pays 90% of the face. A rate on the insurance or collection block is rejected.
VAT on fees is handled by Tilta in accordance with applicable tax regulations. The VAT rates shown above use 19% (Germany) for illustration. The actual rate applied to the fee will match the VAT rate applicable to the invoice’s jurisdiction.
Calculating fees before invoice capture
Use thePOST /v1/invoices/calculate_fees endpoint to retrieve an exact fee breakdown before creating an invoice. This is useful for displaying the total repayment amount to the buyer at checkout or the net payout amount in merchant dashboards.
amount, due_at, and buyer_external_id are required. The response echoes the request and adds a fees object broken down by service type – financing, insurance, and collection – plus the advance the merchant would receive and the security held back until the buyer pays:
advance and security use the same names as a financing service. On this endpoint each of advance.value, advance.rate, and security.value is a { value, min, max } range, because the buyer’s risk band may still be unknown. A financing service returns those amounts as integers once the advance is locked. advance.value is the amount paid to the merchant and advance.rate is the share of the invoice face that amount represents. security.value is the holdback. On the face of 119000 above, fees of 2023 and an advance rate of 0.9 pay 107100 and hold back 9877. When the high fee bound reaches 15000, fees cap the payout: the advance falls to 104000, security is 0, and the effective rate is 0.87395.
Each number is an object rather than a bare number. When the buyer’s risk band is not yet known, value is null and min and max still bound the possible outcome across your configured risk bands – so a checkout UI can show a range before underwriting completes. The smallest fee total produces the largest advance and security, so those bounds sit at opposite ends of the fee range.
All monetary values in the API are expressed in the smallest currency unit. A
gross of 2023 represents €20.23.