Autorisations complémentaires

Lorsque vous créez un PaymentIntent, vous pouvez demander à capturer les incréments du paiement. Définissez le champ request_incremental_authorization_support sur true et le champ capture_method sur manual. Ainsi le texte sur l’écran de collecte des paiements passe de Total à Pre-authorization.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d capture_method=manual \
  -d "payment_method_options[card_present][request_incremental_authorization_support]"=true

Pour déterminer si le PaymentIntent est admissible pour une autorisation complémentaire, vérifiez le champ incremental_authorization_supported contenu dans la réponse de confirmation.

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

async () => {
  const result = await terminal.processPayment(paymentIntent);
  if (result.error) {
    // Placeholder for handling result.error
  } else if (result.paymentIntent) {
    // Now you're ready to increment the authorization using your backend
  }
}

Pour augmenter le montant autorisé d’un paiement, utilisez l’endpoint increment_authorization et indiquez le montant total modifié, qui doit être supérieur au montant autorisé initial. Vous tentez ainsi d’autoriser un ajout correspondant à la différence entre le montant initial et le montant incrémenté. Chaque PaymentIntent peut être soumis à un maximum de 10 tentatives d’autorisation complémentaire (refus compris).

Un même PaymentIntent peut appeler cet endpoint plusieurs fois pour augmenter à nouveau le montant autorisé.

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

Une autorisation peut :

• Aboutir : renvoie le PaymentIntent avec le montant modifié.
• Échouer : renvoie une erreur card_declined, et le PaymentIntent reste autorisé à capturer le montant d’origine. Les modifications portant sur d’autres champs du PaymentIntent (par exemple, application_fee_amount) ne sont pas enregistrées.

Pour capturer le montant autorisé sur un PaymentIntent associé à des autorisations complémentaires antérieures, utilisez l’endpoint capture. Pour augmenter le montant autorisé et capturer simultanément ce montant modifié, vous pouvez fournir un nouveau montant dans amount_to_capture.

Fournir un amount_to_capture supérieur au montant actuellement autorisé n’aboutira pas à une tentative automatique d’autorisation complémentaire.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=2000

Voici les résultats possibles auxquels une tentative d’autorisation complémentaire peut aboutir :

• Aboutir : renvoie le PaymentIntent captured avec le montant modifié.
• Échouer : renvoie une erreur card_declined, et le PaymentIntent reste autorisé à capturer le montant d’origine. Les modifications portant sur d’autres champs du PaymentIntent (par exemple, application_fee_amount) ne sont pas enregistrées.

Dans tous les cas, nous vous recommandons de toujours vérifier la présence de défaillances lorsque vous utilisez le paramètre amount_to_capture.