Skip to main content
POST
Mark an invoice as paid
In some scenarios, a buyer may remit payment directly to the merchant rather than through Tilta’s standard collection flow – for example, via bank transfer or legacy payment channel. When this happens, you must notify Tilta by marking the invoice as paid so that the buyer’s credit facility is correctly updated and the invoice status reflects the settled state. This endpoint records the repayment event and closes out the financing obligation on Tilta’s side.
Only call this endpoint for out-of-band payments made directly to the merchant. Payments routed through Tilta’s collection process (e.g., via Tilta’s bank transfer reference) are recorded automatically – calling this endpoint for those payments may result in duplicate payment recording.
Marking an invoice as paid releases the financed amount back to the buyer’s credit facility, restoring their available limit for future orders.

Authorizations

Authorization
string
header
required

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

Path Parameters

external_id
string
required

Unique identifier of an invoice.

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

Response

The invoice was marked as paid; paid_at reflects that payment.

paid_at
number
required

Unix timestamp in seconds for the banking update recorded for this invoice.

Example:

1712419200