Currently, for card payments, you have the following default time thresholds to capture (or cancel) an authorized payment:
- 36 hours for in-person (card present) payments, where the card was swiped, dipped, or tapped using a card reader.
- 7 days for online (card not present) payments where the buyer used a card on file or typed the card number.
After the time period expires, if the payment is not in a terminal state (COMPLETED, CANCELED, or FAILED), Square cancels the payment. The delayed_until field provides the date and time on Square servers when Square cancels the payment.
You can change the preceding default thresholds by specifying the delay_duration field in a CreatePayment request. The time period you specify must be at least one minute and less than the preceding threshold values.
We’re constantly working to improve our features based on feedback like this, so I’ll be sure to share your request to the API product team. 