Préautorisation incrémentale
La préautorisation incrémentale augmente le montant des fonds bloqués dans une preAuthorization (préautorisation) existante afin de permettre un règlement ultérieur par une seule preAuthorization Completion (finalisation de préautorisation).
1. Débuter avec la préautorisation incrémentale
La préautorisation incrémentale augmente le montant des fonds bloqués dans une preAuthorization (préautorisation) existante afin de permettre un règlement ultérieur par une seule preAuthorization Completion (finalisation de préautorisation). Il n’y a aucune limite au nombre de transactions de préautorisation incrémentale pouvant être effectuées à partir de l’autorisation estimée initiale, et chaque nouvelle préautorisation incrémentale augmente la retenue sur la carte de crédit du client.
Pour Mastercard uniquement, une préautorisation incrémentale peut être soumise avec une valeur de 0 $ pour le champ amount (montant) afin de prolonger la période permise pour la finalisation (par exemple, 30 jours).
2. Créer un paiement à l’aide d’une préautorisation incrémentale
Les préautorisations incrémentales peuvent être effectuées à l’aide de l’appel API Create Payment (Créer un paiement) (requête POST sur /payments). Voici quelques éléments clés à noter concernant une transaction de préautorisation incrémentale :
automaticCapture (Capture automatique – Booléen)
Ce champ doit être défini sur FALSE (valeur booléenne fausse) pour les transactions de préautorisation incrémentale.
incrementalAuthorization.incrementalAuthorizationIndicator (Indicateur de préautorisation incrémentale – Booléen)
Ce champ doit être défini sur TRUE (valeur booléenne vraie) pour les transactions de préautorisation incrémentale.
3. Incrémenter le paiement
L’appel API Increment Payment (Augmenter le paiement) peut être utilisé pour augmenter le montant des fonds bloqués dans une preAuthorization (préautorisation) existante qui a été effectuée avec incrementalAuthorizationIndicator (Indicateur de préautorisation incrémentale) défini sur TRUE (valeur booléenne vraie).
Cette opération peut être réalisée au moyen d’une requête POST sur /payments/{payment-id}/increment.
Voici quelques éléments clés à noter concernant l’appel API Increment Payment (Augmenter le paiement) :
amount (Montant – Objet)
Ce champ spécifie le montant à ajouter à la préautorisation existante.
amount (Montant) : valeur entière en cents (par exemple, 10,59 $ → 1059)
currency (Devise) : code de devise ISO (par exemple, CAD, USD)
4. Finaliser le paiement
L’appel API Complete Payment (Finaliser le paiement) peut être utilisé pour finaliser le montant des fonds bloqués associés à une préautorisation incrémentale (Incremental Pre-Authorization).
Cette opération peut être effectuée au moyen d’une requête POST sur /payments/{payment-id}/complete.
Voici quelques éléments clés à noter concernant l’appel API Complete Payment (Finaliser le paiement) :
amount (Montant – Objet)
Ce champ spécifie le montant à ajouter à la préautorisation existante.
amount (Montant) : valeur entière en cents (par exemple, 10,59 $ → 1059)
currency (Devise) : code de devise ISO (par exemple, CAD, USD)
Renseignements additionnels
Définitions de l’API
Consultez les endpoints (points de terminaison), les formats des demandes et des réponses, ainsi que les modes d’authentification de ce scénario.
.svg)