Migrer vers les scénarios de paiement flexibles les plus récents
Adaptez vos scénarios de paiement bêta avancés à la version générale.
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:
- Augmenter une autorisation
- Capturer un montant supérieur au montant autorisé
- Bloquer une somme sur une carte de paiement en ligne pour une période prolongée
- Capturer un paiement plusieurs fois
Nous avons intégré les améliorations suivantes à ces fonctionnalités suite aux retours d’informations :
- Contrôle détaillé des fonctionnalités au niveau du PaymentIntent.
- Attentes plus claires concernant la disponibilité et l’utilisation des fonctionnalités après une phase de confirmation.
Chaque fonctionnalité de paiement flexibles présente des exigences différentes de celles de son intégration en version bêta privée. Choisissez la fonctionnalité à mettre à niveau et reportez-vous à la note en haut de la page pour connaître les modifications et les exigences qui lui sont spécifiques.
Modifications par rapport à la version bêta
La première étape de cette intégration est désormais obligatoire.
Demander une autorisation complémentaire![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Votre PaymentIntent doit inclure une demande d’autorisation complémentaire avant la confirmation.
Avertissement
Cette étape auparavant facultative est désormais obligatoire.
La réponse renvoie désormais l’état de la demande d’autorisation complémentaire dans la propriété payment_
de latest_charge. Ses valeurs sont available
ou unavailable
selon le moyen de paiement du client.
// PaymentIntent Response { "id": "pi_ANipwO3zNfjeWODtRPIg", "object": "payment_intent", "amount": 1000, "amount_capturable": 1000, "amount_received": 0, ... // if latest_charge is expanded { "latest_charge": { "amount": 1000, "payment_method_details": { "card": { "incremental_authorization_supported": true // or false } } ... } } }
// PaymentIntent Response { "id": "pi_ANipwO3zNfjeWODtRPIg", "object": "payment_intent", "amount": 1000, "amount_capturable": 1000, "amount_received": 0, ... // if latest_charge is expanded { "latest_charge": { "amount": 1000, "payment_method_details": { "card": { "incremental_authorization": { "status": "available" // or "unavailable" } } } ... } } }
Modifier progressivement le montant autorisé![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Aucune modification n’a été apportée à cette étape par rapport à la version bêta.
Choisir comment capturer un montant supérieur à celui initialement autorisé![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Deux des fonctionnalités de paiement flexible permettent de capturer un montant supérieur à celui initialement autorisé :
- Surcapture jusqu’à une certaine limite (capturer un montant supérieur au montant autorisé d’un paiement)
- Augmenter le montant de l’autorisation existante, puis capturer le nouveau montant autorisé (Augmenter une autorisation)
L’exemple ci-dessous montre comment ces fonctionnalités peuvent se compléter dans la version généralement disponible.
// 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 } } } ... } } }
Après la confirmation du PaymentIntent, si les deux fonctionnalités sont disponibles, vous avez la possibilité de capturer un montant supérieur à celui initialement autorisé :
- Effectuer une surcapture si le montant souhaité est inférieur ou égal à
maximum_
.capturable_ amount - Exécuter une autorisation complémentaire jusqu’au montant souhaité, puis effectuer une capture.