Migrer vers les scénarios de paiement flexibles les plus récents

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.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d payment_method=pm_card_debit_incrementalAuthAuthorized \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]"=latest_charge \
  -d "payment_method_options[card][request_incremental_authorization_support]"=true

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d payment_method=pm_card_debit_incrementalAuthAuthorized \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]"=latest_charge \
  -d "payment_method_options[card][request_incremental_authorization]"=if_available

// 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"
            }
          }
        }
        ...
      }
  }
}

curl https://api.stripe.com/v1/payment_intents/pi_ANipwO3zNfjeWODtRPIg/increment_authorization \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1500

Choisir comment capturer un montant supérieur à celui initialement autorisé

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.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d payment_method=pm_card_visa \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]"=latest_charge \
  -d "payment_method_options[card][request_incremental_authorization]"=if_available \
  -d "payment_method_options[card][request_overcapture]"=if_available

// 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é :

1. Effectuer une surcapture si le montant souhaité est inférieur ou égal à maximum_capturable_amount.
2. Exécuter une autorisation complémentaire jusqu’au montant souhaité, puis effectuer une capture.