Migrer vers les derniers scénarios de paiement flexibles

Stripe prend désormais en charge plusieurs scénarios de paiement flexibles pour les transactions sans présentation de la carte. Si vous avez déjà intégré la version bêta privée de l’une de ces fonctionnalités, ce guide vous explique comment passer à la version générale. Pour les nouvelles intégrations, consultez les guides suivants concernant les fonctionnalités qui vous intéressent :

• 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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.