Extended authorizations

Extended authorizations allow you to capture a confirmed PaymentIntent up to 31 days later, depending on the card brand and whether your business is in an eligible category. This is helpful if you need more than 48 hours between authorization and payment capture. For example, a hotel authorizes a payment in full when a guest checks in, but captures the payment when the guest checks out.

Request extended authorization support

When you create a PaymentIntent, you can request to extend the capture window of the payment. Set the request_extended_authorization field to true and the capture_method to manual.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d capture_method=manual \
  -d "payment_method_options[card_present][request_extended_authorization]"=true

In the response, the capture_before field indicates the time when the authorization expires. Failure to capture the payment by this time cancels the authorization and releases the funds. When this happens, the PaymentIntent status transitions to canceled.

Authorization validity

Every card network and card brand has a different rule for how long an authorization is valid. With Terminal, an authorization for in-person payments is valid for at least two days. Because authorization rules can change without prior notice, use the capture_before field to determine the validity window for an authorization.