Incrémenter une autorisation

Vous pouvez utiliser le paramètre request_incremental_authorization pour spécifier les PaymentIntents que vous prévoyez d’augmenter.

Utilisez les paramètres if_available ou never pour déterminer quand commencer à augmenter un PaymentIntent :

• if_available : le PaymentIntent créé autorise des incréments ultérieurs basés sur la disponibilité incrémentielle de la prise en charge des autorisations.

• never : le PaymentIntent créé n’autorise pas les incréments ultérieurs.

Vous ne pouvez effectuer des autorisations complémentaires sur des paiements non capturés qu’après confirmation du PaymentIntent. Pour ajuster le montant d’un paiement avant confirmation, utilisez plutôt la méthode de mise à jour.

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

Dans la réponse de confirmation de PaymentIntent, le champ payment_method_details dans latest_charge contient les valeurs available ou unavailable en fonction du moyen de paiement du client et des critères de disponibilité mentionnés ci-dessus, qui déterminent si un PaymentIntent est éligible ou non à une autorisation complémentaire. Si vous n’avez pas demandé d’autorisation complémentaire dans votre demande de confirmation de PaymentIntent, celle-ci sera définie sur unavailable.

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

}

Pour augmenter le montant autorisé sur un PaymentIntent, utilisez l’endpoint increment_authorization et fournissez le total mis à jour du montant d’autorisation à ajouter. Ce montant doit être supérieur au montant initialement autorisé. Vous tentez ainsi d’autoriser un montant plus élevé sur la carte de votre client. Un même PaymentIntent peut appeler cet endpoint plusieurs fois pour augmenter à nouveau le montant autorisé.

Vous disposez au maximum de 10 tentatives d’autorisation complémentaire par PaymentIntent.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/increment_authorization \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1500

Si l’autorisation complémentaire aboutit, elle renvoie l’objet PaymentIntent avec le montant mis à jour. Si l’autorisation échoue, une erreur card_declined est alors renvoyée. L’objet PaymentIntent peut toujours être capturé pour le montant précédemment autorisé. Toute modification éventuelle d’autres champs du PaymentIntent (par exemple, application_fee_amount, transfer_data, metadata, description et statement_descriptor) ne sera pas enregistrée en cas d’échec de l’autorisation complémentaire.

L’autorisation complémentaire est plafonnée à 500 USD (ou la somme équivalente dans la devise locale) au-dessus ou à 500 % du montant précédemment autorisé (selon le montant le plus élevé) pour chaque complément.

Vous devez capturer les fonds avant que l’autorisation initiale n’expire, que vous augmentiez ou non le montant autorisé d’un PaymentIntent avec une autorisation complémentaire. Les autorisations complémentaires ne prolongent pas la période de validité. Pour capturer le montant autorisé sur un PaymentIntent avec des autorisations complémentaires antérieures, utilisez l’endpoint capture de la manière habituelle.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Si l’autorisation complémentaire aboutit, elle renvoie l’objet PaymentIntent capturé avec le montant mis à jour. Si l’autorisation échoue, une erreur card_declined est alors renvoyée. Le PaymentIntent n’est pas capturé, mais il peut toujours être capturé pour le montant précédemment autorisé. Toute modification éventuelle d’autres champs du PaymentIntent (par exemple, application_fee_amount, transfer_data, metadata, description et statement_descriptor) ne sera pas enregistrée en cas d’échec de l’autorisation complémentaire.

Utilisez la carte de test d’autorisation complémentaire avec n’importe quel CVC, code postal et date d’expiration postérieure à la date du jour pour déclencher des autorisations complémentaires pendant le test :

1. Commencez par créer le PaymentIntent à l’aide de la carte de test utilisée à l’étape Créer et confirmer le PaymentIntent ci-dessus.

1. Exécutez l’autorisation complémentaire avec les paramètres spécifiés dans l’étape Exécuter l’autorisation complémentaire, puis utilisez la carte de test pour déclencher l’autorisation complémentaire.