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 non-binding estimates based on current configuration. The actual fees applied when you create the invoice may differ if the buyer’s credit facility terms or your platform’s fee configuration changes between the calculate-fees call and invoice creation.

Authorizations

Authorization
string
header
required

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

Body

application/json
amount
number
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
amount
number
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