Disposition Time Window
Once a payment reaches the AUTHORIZED state, you must capture the customer’s payment within a defined time period, referred to as the disposition time window.
The disposition time window is defined by PaysafeCard’s Terms & Conditions and can be configured between 60 seconds and a maximum of 10 minutes.
If the disposition time window is exceeded, the payment will automatically transition to the EXPIRED state. In this case, the reserved amount becomes available again to the customer on their PaysafeCard voucher, PaysafeCard account, or PaysafeCard account administration tool*.
Important:
Any payment that is either:
- not authorized by the customer within the allowed authorization timeframe (default: 30 minutes), or
- not captured by the merchant within the disposition time window
will be set to EXPIRED.
This expiration process is only active in the PaysafeCard production environment.
* PaysafeCard Account Administration Tool
The PaysafeCard account administration tool is an alternative to the classic PaysafeCard account and is only available in Australia, Canada, Lithuania, Mexico, New Zealand, and Uruguay.
The PaysafeCard account administration tool cannot be used for payouts or refunds.
Status before expiration
The status_before_expiration field is returned in the payment response when a payment transitions to the EXPIRED state.
It indicates the last payment status immediately before the payment expired and is used to distinguish between different expiration scenarios.
This is particularly useful to differentiate between:
- payments that were successfully authorized by the customer but not captured in time, and
- payments that were never authorized by the customer.
The field is only present when status is set to EXPIRED.
Possible Values
| Value | Description |
|---|---|
AUTHORIZED | The customer authorized the payment, but the merchant did not capture it within the disposition time window. |
REDIRECTED | The customer was redirected to the payment panel but did not complete the authorization process. |
INITIATED | The payment was created, but the customer was not redirected to the payment panel. |