Invoice Timeout

Every payment (invoice) stays OPEN for a limited time. If the customer does not complete the transfer before the timeout expires, the payment switches to EXPIRED and the deposit address is released.

Default Behavior

By default the invoice lifetime is defined by the platform — you do not need to configure anything. The effective lifetime of each payment is returned in the timeout field of the payment object (see Create Payment).

Custom Invoice Timeout

Merchants can override the platform default with a custom invoice timeout in their merchant settings.

When a custom value is set, every newly created payment uses it as the invoice lifetime. Payments created before the change keep the timeout they were created with.

How to Change It

The invoice timeout is managed in the merchant dashboard settings. Editing it yourself requires the invoice time edit permission on your account — if the setting is read-only for you, contact your account manager or support to change the value or to enable self-service editing.

API Impact

The response format of the payment endpoints is unchanged: the effective lifetime is exposed through the existing timeout field of the payment object. Integrations that already read timeout will automatically pick up the custom value.

{
	"id": "285d8dce-7663-4580-ba7f-8afb2f2d3292",
	"status": "OPEN",
	"timeout": 9000,
	"createdAt": "2025-05-20T12:34:56Z"
}

Tip: Do not hardcode the invoice lifetime on your side — always read timeout from the create-payment response, so a settings change never breaks your checkout countdown.