Expired Invoices
An invoice expires in one of two ways:- The
expiresInMinutestime limit is reached without full payment - The invoice is manually cancelled via
POST /api/v1/invoices/:invoiceId/cancel
The invoice.expired event
Handling expiry in your webhook
Giving the customer a second chance
To let the customer retry, create a new invoice and redirect them to it:Recommended expiry times
Bitcoin blocks can take 10–60 minutes. Set a minimum of 60 minutes for any invoice that may be paid with BTC to give customers enough time to complete the transaction.
Manually cancelling an invoice
Cancel a pending invoice before its natural expiry:expired and fires the invoice.expired webhook.
Checkout countdown timer
Always show a countdown so customers know how long they have:Late payments after expiry
If a customer sends funds to an expired invoice’s deposit address:- The payment is detected on-chain
- It is not automatically settled — the invoice is closed
- Contact Settlx support to manually process the payment