Skip to main content
POST
Refund an invoice
When a buyer returns goods, cancels an order after invoicing, or disputes a charge, you refund the invoice to reverse the financing obligation. Tilta handles the refund differently depending on the timing: if the merchant payout has not yet been disbursed, it is cancelled or reduced by the refund amount; if payout has already occurred, the refund amount is reversed and offset against future merchant payouts. Partial refunds are supported – provide an amount smaller than the invoice total to refund only part of the financed value.
A full refund releases the entire financed amount back to the buyer’s credit facility. A partial refund releases only the refunded portion, leaving the remaining balance active and due on the original due_at date.
Refunds cannot be undone. If you issue an incorrect refund, you must create a new order and invoice to re-finance the transaction.
For partial shipment scenarios where only some items are returned, calculate the refund amount as the sum of the returned line items including tax, then submit that value in the amount field.

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 refunded; paid_at reflects the refund timestamp.

paid_at
number
required

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

Example:

1712419200