Autorisations complémentaires

Augmentez le montant autorisé avant la capture d'un paiement.

Les autorisations complémentaires vous permettent d’augmenter le montant autorisé sur un PaymentIntent confirmé avant de le capturer. Cette fonction s’avère très utile si le tarif total change ou si le client ajoute des biens ou des services et que vous devez mettre à jour le montant pour le paiement.

Selon le fonctionnement de la banque émettrice, les titulaires de cartes peuvent voir le montant de l’autorisation en attente initiale augmenter, ou bien chaque incrément faire l’objet d’une autorisation supplémentaire en attente. Après la capture, le montant total capturé apparaît sous la forme d’une seule entrée.

Disponibilité

Lorsque vous utilisez des autorisations complémentaires, veuillez prêter attention aux restrictions suivantes :

Elles sont uniquement disponibles avec Visa, Mastercard et Discover.
Certaines marques de cartes bancaires imposent des restrictions sur des catégories de marchand (voir ci-dessous).
Vous pouvez uniquement incrémenter une transaction effectuée avec le PDV et le lecteur entièrement en ligne.
Vous disposez au maximum de 10 tentatives par paiement.

Disponibilité par réseau de cartes et catégorie de marchand

Utilisez les autorisations complémentaires sur les paiements qui répondent aux critères ci-dessous. Vous trouverez votre catégorie d’utilisateur dans le Dashboard.

Toute tentative d’autorisation complémentaire sur un paiement qui ne remplit pas les critères ci-dessous génère une erreur.

Marque de carte bancaire	Catégorie de marchand
Visa	Toutes les catégories d’utilisateurs
Mastercard	Toutes les catégories d’utilisateurs
Discover	Location de voitures, hôtels, transport local/suburbain, transport de passagers, y compris les ferrys, lignes ferroviaires de passagers, lignes d’autobus - charters, cars touristiques, compagnies de bateaux à vapeur/de croisières, services de location et de crédit-bail de bateaux, magasins d’alimentation et supermarchés, chargement de véhicules électriques, lieux de restauration et restaurants, lieux servant des boissons (alcoolisées), hôtels, motels, complexes touristiques, parcs pour caravanes et campings, services de location et de crédit-bail d’équipements, d’outils, de meubles et d’appareils électroménagers, agence de location de voitures, location de camions et de remorques utilitaires, location de camping-cars, parkings, parcmètres et garages, parcs d’attractions, cirques, voyance et cartomancie, services de loisirs (non classés)

Demander la prise en charge des autorisations complémentaires
Côté serveur
Côté client

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.

Confirmer le PaymentIntent
Côté client

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
  }
}

Not all PaymentIntents are eligible for incremental authorizations. To determine whether a PaymentIntent is eligible based on the restrictions listed in the Availability section, check the incremental_authorization_supported field on the PaymentIntent’s latest charge after a successful confirmation.

Exécuter une autorisation complémentaire
Côté serveur

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é.

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.

Capturer le PaymentIntent
Côté serveur

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.

Remarque

Si vous êtes admissible à la collecte des pourboires à l’encaissement, l’utilisation d’un amount_to_capture supérieur au montant actuellement autorisé n’aboutira pas à une tentative automatique d’autorisation complémentaire. Les demandes de capture aboutissent systématiquement.

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.

Autorisations complémentaires

Augmentez le montant autorisé avant la capture d'un paiement.

Disponibilité

Disponibilité par réseau de cartes et catégorie de marchand

Demander la prise en charge des autorisations complémentairesCôté serveurCôté client

Confirmer le PaymentIntentCôté client

Exécuter une autorisation complémentaireCôté serveur

Capturer le PaymentIntentCôté serveur

Remarque

Demander la prise en charge des autorisations complémentaires
Côté serveur
Côté client

Confirmer le PaymentIntent
Côté client

Exécuter une autorisation complémentaire
Côté serveur

Capturer le PaymentIntent
Côté serveur