Skip to main content
POST
Calculate fees for an invoice
Before creating an invoice, you can use this endpoint to calculate the precise service fees that would apply to a proposed financing transaction. The fee calculation takes into account the buyer’s credit facility terms, the requested payment term, the invoice amount, and your platform’s configured fee structure. Calling this endpoint at checkout lets you display exact fee amounts to the buyer before they confirm their payment term selection – improving transparency and reducing disputes.
Call this endpoint for each payment term option you display to the buyer at checkout. Showing a breakdown of fees per term (e.g., “30 days – €5.95 fee / 60 days – €9.50 fee”) helps buyers make informed decisions and reduces post-purchase confusion.
Fee calculations are estimates against the fee configuration in force now. Creating a financing service pins that configuration: a configuration you publish afterwards does not change the fees for a service already created. The estimate can still differ from the accepted fee when the payout date moves at acceptance, because the daily rate is applied to the number of days between payout and due date. advance and security use the same range shape as the fees, and the same names as a financing service.

Authorizations

Authorization
string
header
required

Your Tilta API key, sent as Bearer <key>.

Body

application/json
amount
integer
required

Total amount of the invoice in cents.

due_at
number
required

Timestamp indicating when the invoice should be paid.

Example:

1582896122

buyer_external_id
string
required

Unique identifier of a related buyer.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
paid_out_at
number | null

Timestamp indicating when the invoice is actually paid.

Example:

1582896122

merchant_external_id
string

Unique identifier of a merchant. Optional only for Single-merchant platforms.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$

Response

fees
object
required
advance
object
required

Advance amount that would be paid out to the merchant for this invoice. Each number is a range across configured risk bands.

security
object
required

Holdback on this financing preview.

amount
integer
required

Total amount of the invoice in cents.

due_at
number
required

Timestamp indicating when the invoice should be paid.

Example:

1582896122

buyer_external_id
string
required

Unique identifier of a related buyer.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
merchant_external_id
string
required

Unique identifier of a related merchant.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
paid_out_at
number | null

Timestamp indicating when the invoice is actually paid.

Example:

1582896122