Migrate to latest flexible payment scenarios
Adapt your beta advanced payment scenarios to the general release.
Stripe now supports several flexible payment scenarios for non-card-present transactions. If you’ve already integrated the private beta version of any of these features, this guide provides details to upgrade to the general release. For new integrations, use the following guides for the features that interest you:
- Increment an Authorisation
- Capture more than the Authorised Amount
- Place an Extended Hold on an Online Card Payment
- Capture a Payment Multiple Times
We’ve incorporated the following feedback-driven improvements to these features:
- Detailed control over the features at the PaymentIntent level.
- Clearer expectations regarding feature availability and usage after a confirmation phase.
Each of the flexible payment features has different requirements from its private beta integration. Choose the feature you need to upgrade and refer to the note at the top for changes and requirements specific to that feature.
Choose how to capture more than initially authorised amount![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Two of the flexible payment features allow you to capture an amount larger than initially authorised:
- Over capture up to a certain limit (Capture more than the authorised amount on a payment)
- Increment the existing authorisation and then capture the newly authorised amount (Increment an authorisation)
The example below showcases how these features can complement each other in the generally available version.
// PaymentIntent Response { "object": "payment_intent", "amount": 1000, ... // if latest_charge is expanded { "latest_charge": { "payment_method_details": { "card": { "incremental_authorization": { "status": "available" // or "unavailable" }, "overcapture": { "status": "available", // or "unavailable" "maximum_capturable_amount": 1200 } } } ... } } }
Upon confirmation of the PaymentIntent, if both features are available, you have options on the next steps to capture a larger amount than initially authorised:
- Overcapture if the desired amount is equal to or below the
maximum_
.capturable_ amount - Perform an incremental authorisation to the desired amount, then capture.