- Directives d'intégration
- Fonctionnalités prises en charge (Opérations de paiement)
- Opérations de transaction
Opérations de transaction
Si vous disposez d'une intégration avec la passerelle via API, vous pouvez utiliser API pour traiter des transactions, récupérer des détails de transaction, stocker des détails de carte, etc. Pour effectuer une opération, vous devez disposer du privilège requis sur votre profil de commerçant auprès de la passerelle. Pour vérifier les opérations disponibles pour vous, contactez votre your payment service provider.
Opérations de transaction initiales
Cette rubrique décrit les opérations que vous pouvez utiliser pour lancer une transaction.
L'opération Authorize (Autoriser) vérifie que les détails de la carte de votre payeur, contrôle que le payeur a des fonds suffisants disponibles par rapport à sa ligne de crédit et tente de réserver les fonds demandés. La limite de la carte de crédit du payeur est diminuée du montant autorisé et les fonds sont réservés pour une période prédéterminée (dans la plupart des cas, 5 à 8 jours), définie par le système de cartes et les règles d'émission de la carte du payeur.
L'autorisation ne débite pas les fonds du compte du payeur, mais réserve le montant total de la commande, qui est alors prêt pour que l'opération Capture (Collecter) débite la carte et transfère les fonds vers votre compte. Les transactions Authorize (Autoriser) n'apparaissent pas sur le relevé de compte du payeur, contrairement aux transactions Capture (Collecter).
Pour une autorisation réussie, la passerelle renvoie result=SUCCESS dans la réponse de la transaction. Vous ne pouvez effectuer une opération Authorize (Autoriser) que si la transaction initiale est Verify (Vérifier) et que les détails de la carte de la demande Authorize (Autoriser) et de la transaction Verify (Vérifier) correspondent.
L'opération Authorize (Autoriser) est également appelée « Auth », « Autorization ».
Garantie de commande
Vous pouvez indiquer un niveau de garantie pour le montant d'autorisation à collecter en renseignant le champ order.certainty dans la demande Authorize (Autoriser). Pour ce faire, le privilège « Modifier la garantie de commande » doit être activé par votre your payment service provider sur votre profil de commerçant. Vous pouvez définir le champ avec l'une des valeurs suivantes :
- FINAL : montant autorisé complet devant être collecté à l'aide d'une ou de plusieurs collectes dans le délai fixé (généralement, 7 jours). La commande n'est annulée que dans ces circonstances exceptionnelles (par exemple, le payeur a annulé son achat). Le fait d'indiquer cette valeur sur votre transaction peut qualifier celle-ci pour des frais de traitement inférieurs.
- ESTIMATED : le montant autorisé est une estimation du montant qui sera collecté dans le délai fixé (généralement 30-31 jours). Il est possible que le montant collecté soit inférieur ou qu'aucun montant ne soit collecté, ou que l'autorisation ait été annulée. Le fait d'indiquer cette valeur sur votre transaction peut entraîner des frais de traitement supérieurs.
Si vous ne disposez pas du privilège de modification de la garantie de commande et si la valeur indiquée dans ce champ ne correspond pas à la valeur de garantie de commande par défaut configurée sur votre profil de commerçant, la demande est rejetée.
Référence de l'API Authorize (Autoriser) [REST][NVP]
Annulations d'autorisation
La passerelle peut annuler les montants d'autorisation en suspens pour les autorisations non collectées, partiellement collectées ou expirées, lorsqu'elles sont prises en charge pour l'acquéreur. Cela vous permet de vous conformer aux exigences du système de cartes pour les annulations totales et partielles.
Autorisations non collectées
Si vous ne souhaitez pas collecter le montant autorisé après avoir soumis une demande Authorize (Autoriser), vous devez annuler votre autorisation en soumettant une demande Void (Annuler). Indiquez l'ID de transaction pour l'autorisation à annuler dans le champ transaction.targetTransactionId.
Autorisations partiellement collectées
Lors de la soumission d'une demande Capture (Collecter) pour une commande, vous pouvez indiquer un montant de collecte inférieur au montant autorisé pour la commande (order.AuthorizedAmount). Si vous n'avez pas l'intention de collecter le montant autorisé restant, vous pouvez annuler le montant autorisé en suspens, lorsque cela est pris en charge par votre acquéreur.
Vous pouvez tenter d'invalider/annuler le montant de l'autorisation en suspens de deux manières :
- Soumettez une demande Void (Annuler) avec l'ID de transaction pour l'autorisation à annuler dans le champ
transaction.targetTransactionId. - Indiquez le nombre prévu de collectes pour la commande dans le champ
order.expectedNumberOfCapturesdans la demande Capture (Collecter) ou via Merchant Administration. Dans l'éventualité où le nombre total de collectes pour la commande (y compris la collecte en cours) est supérieur ou égal au nombre total prévu de demandes Capture (Collecter), la passerelle déclenche automatiquement une annulation du montant autorisé en suspens, lorsque cela est pris en charge par votre acquéreur. Pour ce faire, le privilège « Annuler automatiquement les montants d'autorisation en suspens » doit être activé par votre your payment service provider sur votre profil de commerçant.
Par exemple, si vous indiquezorder.expectedNumberOfCaptures= 2 dans la première demande Capture (Collecter), la passerelle annule automatiquement le montant autorisé restant lors du traitement de la deuxième demande Capture (Collecter).
Si vous diminuez le nombre prévu de collectes dans les demandes Capture (Collecter) suivantes, c'est-à-dire, vous mettez à jourorder.expectedNumberOfCaptures=1 dans la deuxième demande Capture (Collecter), la passerelle annule automatiquement le montant autorisé restant lors du traitement de la deuxième demande Capture (Collecter). En effet, 2 (nombre total de transactions CAPTURE (Collecter) pour la commande, y compris la transaction CAPTURE (Collecter) actuelle) est supérieur à 1 (nombre attendu de transactions CAPTURE (Collecter)). Cependant, si vous augmentez le nombre prévu de collectes dans les demandes Capture (Collecter) suivantes, c'est-à-dire, vous mettez à jourorder.expectedNumberOfCaptures= 3 dans la deuxième demande Capture (Collecter), la passerelle ne annulera pas le montant en suspens jusqu'à la réception de la troisième demande Capture (Collecter).
order.expectedNumberOfCaptures ne peut être soumis qu'à compter de la version 44 de API.Autorisations expirées
Les autorisations ont une période de validité, après laquelle elles expirent. La période de validité de l'autorisation peut être configurée sur la passerelle pour une combinaison de l'acquéreur, du type de carte et de la garantie de commande.
Lorsque vous soumettez une demande Authorize (Autoriser) à la passerelle, celle-ci détermine la date et l'heure d'expiration de l'autorisation en fonction de la période de validité de l'autorisation configurée (à l'aide de la combinaison de l'acquéreur, du type de carte et de la garantie de commande). En cas de prise en charge pour l'acquéreur, l'expiration de l'autorisation est retournée dans le champ authorizationResponse.autoExpiry de la réponse de l'opération Retrieve Transaction (Extraire la transaction). Ce champ contient la date et l'heure auxquelles la passerelle détermine automatiquement l'expiration de l'autorisation.
Lorsque la période de validité de l'autorisation expire, la passerelle :
- Tente automatiquement d'annuler l'autorisation et de retourner les fonds au payeur (lorsque pris en charge pour l'acquéreur). Pour ce faire, le privilège « Annuler automatiquement les autorisations expirées » doit être activé par votre your payment service provider sur votre profil de commerçant.
Si la commande a déjà été partiellement collectée et si votre acquéreur prend en charge l'annulation d'autorisations pour les collectes partielles, la passerelle essaie d'invalider/annule le montant d'autorisation en suspens.
- Rejette toute demande Capture (Collecter) pour la commande.
Mises à jour de l'autorisation
La passerelle vous permet de prolonger la période d'autorisation et éventuellement d'augmenter ou de diminuer le montant d'autorisation pour les autorisations valides lorsque cela est pris en charge pour l'acquéreur. Pour ce faire, le privilège « Mettre à jour l'autorisation » doit être activé par votre your payment service provider sur votre profil de commerçant. Pour plus d'informations, voir Update Authorization (Mettre à jour l'autorisation).
Reports d'autorisation
La passerelle vous permet de différer une autorisation si vous ne pouvez pas soumettre une transaction Authorize (Autoriser) ou Pay (Payer) au moment où l'autorisation a été réalisée avec le payeur. L'échec peut être dû à des problèmes de connectivité ou de système, ou à d'autres limitations qui vous obligent à différer la soumission jusqu'à ce que le système soit de nouveau en ligne. L'identification des autorisations différées est obligatoire pour vous conformer aux exigences du système Visa.
Vous trouverez ci-dessous différents scénarios dans lesquels vous devez indiquer l'autorisation en tant qu'autorisation différée pour des paiements par carte Visa :
- Si vous êtes un commerçant qui accepte les paiements par carte sur un terminal de point de vente et le système d'autorisation du point de vente est hors ligne, l'autorisation que vous soumettez en aval, lorsque le système est de nouveau en ligne, doit être marquée comme différée.
- Si vous êtes un commerçant de détail qui accepte les paiements via des commandes téléphoniques et le système d'autorisation de point de vente est hors ligne, l'autorisation que vous soumettez en aval, lorsque le système est de nouveau en ligne, doit être marquée comme différée.
Pour différer une autorisation, indiquez le champ transaction.deferredAuthorization dans la demande Authorize (Autoriser), Pay (Payer) ou Standalone Capture (Collecte autonome) et définissez sa valeur sur TRUE. Si vous n'indiquez pas ce champ, la valeur par défaut sera définie sur FALSE.
Pour les commerçants en matière de transport, l'autorisation que vous soumettez pour le montant cumulé à la fin de la période du trajet pour tous les paiements au cours d'une période de trajet doit être marquée comme différée. Pour plus d'informations, voir Paiements agrégés des titres de transport.
Questions fréquentes
Pour collecter plus que le montant autorisé pour votre commande, le privilège Collecte excessive doit être activé sur votre profil de commerçant sur la passerelle. Voir Collectes excessives.
Oui, cela s'appelle une demande Standalone Capture (Collecte autonome) et, lorsque cela est pris en charge par l'acquéreur, vous pouvez soumettre simplement une demande Capture (Collecter) avec le code d'autorisation retourné par votre acquéreur (dans la réponse de l'autorisation).
L'opération Pay (Payer) combine une transaction Authorize (Autoriser) et une transaction Capture (Collecter) dans un message. Une seule transaction autorise le paiement et transfère les fonds du compte de votre payeur sur votre compte.
Si vous voulez soumettre une transaction Pay (Payer) comme opération suivante, une transaction Verify (Vérifier) doit avoir lieu avec succès et que les détails de la carte de la demande Pay (Payer) et de la transaction Verify (Vérifier) doivent correspondre.
Le niveau de garantie de commande pour une transaction Pay (Payer) est défini avec la valeur FINAL. Pour plus d'informations, voir Garantie de commande.
La transaction Pay (Payer) est également appelée « Sale (Vente) », « Purchase (Achat) ».
Initiate Browser Payment (Lancer un paiement avec redirection). Pour plus d'informations, voir Mise en œuvre d'une intégration des paiements avec redirection.Référence de l'API Pay (Payer) [REST][NVP]
Auto-capture (Collecte automatique)
L'opération Auto-capture (Collecte automatique) est une variante de l'opération Pay (Payer) qui permet à un commerçant doté du privilège requis pour exécuter une transaction Pay (Payer) et utilisant un acquéreur qui ne prend en charge que les transactions Authorize (Autoriser)/Capture (Collecter) d'effectuer une autorisation suivie d'une opération Capture (Collecter) auto-déclenchée. Avec ce type de transaction, une demande Pay (Payer) est transformée en opérations Authorize (Autoriser) et Capture (Collecter).
Cette opération peut être effectuée à l'aide des modèles d'intégration Direct Payment, Hosted Session ou Batch.
L'identifiant de transaction pour les demandes Authorize (Autoriser) et Capture (Collecter) sera l'identifiant de transaction indiqué par vous dans la demande Pay (Payer) d'origine. Dans la réponse Pay (Payer), le champ transaction.type indique la dernière transaction tentée pour satisfaire la demande, c'est-à-dire Authorize (Autoriser) ou Capture (Collecter).
Vous pouvez utiliser l'opération Retrieve (Extraire) pour extraire les résultats d'une opération Auto-capture (Collecte automatique). Les résultats de la dernière transaction tentée pour répondre à la demande sont retournés.
Vous pouvez annuler une transaction Pay (Payer) collectée automatiquement à l'aide de l'opération Void Pay (Annuler le paiement). Lorsque vous effectuez cette opération, Mastercard Gateway :
- tente l'opération « Void Capture (Annuler la collecte) » pour la transaction Capture (Collecter) ;
- si l'opération « Void Capture (Annuler la collecte) » réussit, l'opération « Void Authorization (Annuler l'autorisation) » est tentée pour l'autorisation ; si l'opération « Void Capture (Annuler la collecte) » échoue, la réponse indique que l'annulation a échoué ; l'opération Void Authorization (Annuler l'autorisation) n'est pas tentée.
Reports d'autorisation
Vous pouvez fournir un indicateur dans la demande Pay (Payer) pour différer l'autorisation. Pour plus d'informations, voir Reports d'autorisation.
L'opération Verify (Vérifier) vous permet de vérifier les détails du compte du payeur avant d'effectuer une transaction Pay (Payer) ou Authorize (Autoriser). Elle vérifie les détails du paiement selon la méthode de vérification prise en charge par l'acquéreur. Ainsi, si l'acquéreur prend en charge le service de vérification d'adresse (AVS), l'opération Verify (Vérifier) envoie une transaction AVS uniquement avec un montant de transaction égal à zéro et les informations d'adresse du payeur.
Une transaction Standalone Capture (Collecte autonome) est une transaction Capture (Collecter) pour laquelle l'autorisation a été effectuée en dehors de la passerelle. Lorsque vous soumettez une transaction Standalone Capture (Collecte autonome) à la passerelle, vous devez indiquer le code d'autorisation généré en externe dans champ transaction.authorizationCode et les autres champs obligatoires.
Vous pouvez soumettre des transactions Standalone Capture (Collecte autonome) si le privilège Collecter est activé sur votre profil de commerçant.
Référence de l'API Standalone Capture (Collecte autonome) [REST][NVP]
Reports d'autorisation
Vous pouvez fournir un indicateur dans la demande Standalone Capture (Collecte autonome) pour différer l'autorisation. Pour plus d'informations, voir Reports d'autorisation.
Une opération Standalone Refund (Remboursement autonome) est une transaction Refund (Rembourser) qui vous permet de transférer des fonds de votre compte au payeur, sans achat préalable. Vous pouvez effectuer des opérations Standalone Refund (Remboursement autonome) lorsque vous souhaitez créditer le compte du payeur sans associer le crédit à une transaction antérieure.
Référence de l'API Standalone Refund (Remboursement autonome) [REST][NVP]
L'opération Disbursement (Décaissement) vous permet d'envoyer des fonds sur le compte de la carte d'un payeur lorsque cela est nécessaire, par exemple pour des gains de jeux ou de paris ou lors d'un paiement sur la facture de carte de crédit d'un payeur. Lors de l'exécution d'une opération Disbursement (Décaissement), les détails de facturation et d'expédition du payeur ne sont pas requis et la validation du cryptogramme visuel de la carte (CSC) ne s'applique pas. Une opération Disbursement (Décaissement) peut être effectuée sans transactions préalables ou après vérification des détails du compte du payeur.
Opérations ultérieures
Cette rubrique décrit les opérations que vous pouvez effectuer sur les transactions initiales, (Authorize [Autoriser] ou Pay [Payer]).
Pour vérifier les opérations configurées sur votre profil de commerçant, contactez votre your payment service provider.
L'opération Update Authorization (Mettre à jour l'autorisation) vous permet de :
- prolonger la période de validité d'une autorisation existante,
- augmenter ou diminuer éventuellement le montant de l'autorisation.
Si vous souhaitez uniquement prolonger la période d'autorisation, ne soumettez pas transaction.amount dans la demande. La date et l'heure d'expiration de l'autorisation mises à jour sont renvoyées dans le champ authorizationResponse.autoExpiry de la réponse Retrieve Transaction (Extraire la transaction). Il est recommandé de soumettre la demande Update Authorization (Mettre à jour l'autorisation) dans la période de validité de l'autorisation initiale.
Si vous indiquez un montant de transaction supérieur au montant de l'autorisation existante, le montant de l'autorisation est mis à jour avec le nouveau montant. Par exemple, si le montant de l'autorisation existante est de 100 USD et vous indiquez 120 USD comme montant de la transaction dans la demande Update Authorization (Mettre à jour l'autorisation), le nouveau montant d'autorisation disponible pour collecte sera de 120 USD.
Si vous indiquez un montant de transaction inférieur au montant de l'autorisation existante, le montant de l'autorisation est mis à jour avec le nouveau montant. Par exemple, si le montant de l'autorisation existante est de 100 USD et vous indiquez 80 USD comme montant de la transaction dans la demande Update Authorization (Mettre à jour l'autorisation), le nouveau montant d'autorisation disponible pour collecte sera de 80 USD. La passerelle traite automatiquement une demande d'annulation pour le montant d'autorisation restant de 20 USD (si cette option est prise en charge pour l'acquéreur).
Notez que la passerelle ne peut mettre à jour une autorisation existante que si les conditions suivantes sont satisfaites :
- Le privilège « Mettre à jour l'autorisation » doit être activé par votre your payment service provider sur votre profil de commerçant sur la passerelle.
- La devise de la commande doit correspondre à celle figurant sur l'autorisation existante.
- L'autorisation existante doit être valide, réussie et entièrement approuvée.
Totaux de commande
Après une demande Update Authorization (Mettre à jour l'autorisation) réussie (pour une carte ou pour PayPal), le montant de la commande (order.amount) et le montant total autorisé (order.totalAuthorizedAmount) sont mis à jour avec le montant de la transaction (transaction.amount) de la transaction Update Authorization (Mettre à jour l'autorisation). Ces mises à jour s'appliquent que la transaction Update Authorization (Mettre à jour l'autorisation) ait été soumise à l'acquéreur ou automatiquement approuvée par la passerelle (response.gatewayCode=APPROVED_AUTO). Cependant, si vous choisissez d'ignorer la mise à jour de l'autorisation pour une demande Capture (Collecter) excessive (en soumettant transaction.authorizationAdjustmentActions=NO_ACTION, voir Collectes excessives) et la passerelle soumet une demande Capture (Collecter) excessive à l'acquéreur, les totaux de la commande ne sont PAS mis à jour.
response.gatewayCode=APPROVED_AUTO) n'est applicable que lorsque le montant indiqué est supérieur au montant de l'autorisation existante. Sous-totaux de commande
Vous pouvez indiquer les montants de sous-total suivants dans la demande Update Authorization (Mettre à jour l'autorisation) pour les paiements par carte ou PayPal :
order.itemAmountorder.shippingAndHandlingAmountorder.taxAmountorder.discount.amount(paiements par carte uniquement)order.gratuityAmount(paiements par carte uniquement)
order.cashbackAmount dans la demande Update Authorization (Mettre à jour l'autorisation) n'est pas prise en charge.Remarque : la passerelle ne valide PAS si les montants des sous-totaux s'additionnent à transaction.amount(c'est-à-dire, order.amount) ; cependant, vous devez vous en assurer pour les paiements PayPal.
Surcoût
Vous pouvez mettre à jour un montant de surcoût dans la demande Update Authorization (Mettre à jour l'autorisation) en utilisant l'un des champs suivants :
order.surchargeAmount: utilisez ce champ si vous indiquez un montant de surcoût pré-calculé.order.netAmount: utilisez ce champ si la passerelle calcule le montant de surcoût (en fonction de vos règles de surcoût).
order.surchargeAmount n'est pas pris en charge et les demandes avec ce champ seront rejetées. Si vous indiquez order.netAmount sur un paiement PayPal, la transaction sera traitée sans surcoût.Référence de l'API Update Authorization (Mettre à jour l'autorisation) [REST][NVP]
L'opération Capture (Collecter) utilise l'autorisation obtenue après l'opération Authorize (Autoriser) initiale pour transférer les fonds du compte du payeur sur votre compte. Une opération Capture (Collecter) doit toujours être précédée d'une opération Authorize (Autoriser) réussie et, au minimum, l'ID d'autorisation doit être envoyé avec la demande Capture (Collecter). La devise utilisée lors de la collecte d'un montant doit correspondre à celle utilisée dans la transaction Autorize (Autoriser).
Les opérations Capture (Collecter) sont normalement regroupées en batches par la passerelle ou par l'hôte de l'acquéreur, si bien que les fonds ne sont effectivement transférés qu'à la fermeture du batch et au moment du règlement.
L'opération Capture (Collecter) est également appelée « Bill (Facturer) » ou « Complete (Terminer) ».
Le montant total que vous collectez peut dépasser le montant initialement autorisé si le privilège de collecte excessive est activé sur votre profil de commerçant.
L'opération Excessive Capture (Collecte excessive) est une variante de l'opération Capture (Collecter) dans laquelle vous effectuez des collectes pour des montants supérieurs au montant autorisé. Le dépassement autorisé est spécifié sous forme de pourcentage du montant initialement autorisé, et est déterminé par votre your payment service provider. Vous ne pouvez effectuer qu'une seule collecte excessive par commande non partiellement collectée si la collecte atteint ou dépasse le montant autorisé à l'origine.
Lorsque vous soumettez une demande Capture (Collecter) excessive, la passerelle essaie automatiquement de mettre à jour le montant d'autorisation avec le montant que vous voulez collecter. Si l'acquéreur prend en charge la mise à jour des autorisations, la passerelle lui soumet une demande Update Authorization (Mettre à jour l'autorisation). Dans le cas contraire, la passerelle approuve automatiquement une mise à jour d'autorisation (jusqu'à la limite de collecte excessive configurée pour votre profil de commerçant).
Si vous ne voulez pas que la passerelle essaie de mettre à jour l'autorisation avant de soumettre la demande Capture (Collecter) à l'acquéreur, indiquez transaction.authorizationAjustmentAction=NO_ACTION dans la demande Capture (Collecter). Notez que, lorsque la valeur d'autorisation ne correspond pas à la collecte, la commande peut ne pas avoir de protection contre la rétrofacturation.
Si vous souhaitez collecter partiellement une autorisation, ainsi que pour toute autre information, voir Questions fréquentes.
L'opération Refund (Rembourser) vous permet de recréditer les fonds pour une commande existante sur le compte du payeur. Les opérations Refund (Rembourser) ne peuvent être effectuées que lorsqu'un transfert de fonds a été réalisé via une transaction Pay (Payer) ou Capture (Collecter). Vous pouvez effectuer un nombre quelconque de transactions Refund (Rembourser) sur la transaction initiale, mais vous ne pouvez pas rembourser plus que le total obtenu via toutes les transactions d'achat ou de collecte associées à la commande.
Les opérations Refund (Rembourser) sont effectuées pour de nombreuses raisons, par exemple en cas de retour de marchandises non souhaitées, incorrectes ou défectueuses.
Autorisation de remboursement
Avant de soumettre votre demande Refund (Rembourser) à l'acquéreur pour compensation et règlement, la passerelle tente automatiquement par défaut d'autoriser votre remboursement auprès de l'émetteur (s'il est pris en charge par l'acquéreur). Cela permet aux émetteurs de vérifier les détails de la carte indiqués dans la demande Refund (Rembourser) pour s'assurer que le remboursement sera réussi.
L'autorisation de remboursement est effectuée en ligne et retourne une réponse en temps réel. Cela présente de nombreux avantages :
- Vous recevez immédiatement une notification de la part des émetteurs de cartes indiquant si le remboursement aboutira ou non. Cela vous permet de prendre les mesures appropriées lorsque l'émetteur répond par un refus. Par exemple, si la carte utilisée pour la transaction Refund (Rembourser) n'est plus valide, l'émetteur rejette l'autorisation de remboursement. Vous pouvez contacter le payeur pour organiser le remboursement via un autre mode de paiement.
- L'émetteur de la carte reçoit immédiatement une notification de la demande Refund (Rembourser), ce qui permet aux émetteurs d'afficher instantanément des informations sur le remboursement au payeur. Cela leur permet également de gérer efficacement les requêtes / plaintes des payeurs.
Si vous ne souhaitez pas que la passerelle soumette une demande d'autorisation pour les remboursements, le privilège « Activer les remboursements sans autorisation » doit être activé. Même lorsque ce privilège est activé, vous pouvez demander une autorisation sur les remboursements en définissant le champ action.refundAuthorization = true dans la demande de l'API Refund (Rembourser).
Si l'autorisation de remboursement aboutit, le serveur de paiement procède au remboursement ; sinon le remboursement est refusé. Le résultat de la transaction Refund (Rembourser) est retourné dans la réponse de transaction. Le code d'autorisation reçu de l'émetteur sera affiché dans Merchant Administration.
Remboursement d'une collecte spécifique
Vous devez sélectionner la collecte ciblée dans la rubrique Remboursement, puis saisir le montant du remboursement. S'il y a plusieurs collectes, la nouvelle interface utilisateur s'affichera, sinon, s'il n'y a qu'une seule collecte, l'interface utilisateur existante s'affichera. Lors de la transition avec l'API, transaction.targetTransactionld est obligatoire uniquement lorsqu'il y a plusieurs collectes.
Le montant total remboursé pour une commande peut dépasser le montant collecté pour cette commande si le privilège de remboursement excessif est activé sur votre profil de commerçant.
Le montant excessif autorisé par rapport au montant collecté pour les transactions API peut être configuré pour chaque devise dans Paramètres d'intégration dans Merchant Administration. Si vous ne définissez pas de limite de remboursement excessif pour une devise, les remboursements excessifs pour les commandes passées dans cette devise sont rejetés.
Lorsque vous soumettez une opération Refund (Rembourser), le montant total remboursé pour la commande (y compris la tentative de remboursement) ne doit pas dépasser le montant total collecté pour cette commande de plus du dépassement maximal autorisé. Par exemple, si vous soumettez une opération Excessive Refund (Remboursement excessif) via API pour une commande dont le total collecté est de 100 EUR et que vous avez fixé la limite de remboursement excessif à 20 EUR pour les transactions API, vous pouvez rembourser jusqu'à 120 EUR.
L'opération Disbursement (Décaissement) vous permet d'envoyer des fonds sur le compte de la carte d'un payeur lorsque cela est nécessaire, par exemple pour des gains de jeux ou de paris ou lors d'un paiement sur la facture de carte de crédit d'un payeur. Lors de l'exécution d'une opération Disbursement (Décaissement), les détails de facturation et d'expédition du payeur ne sont pas requis et la validation du cryptogramme visuel de la carte (CSC) ne s'applique pas. Une opération Disbursement (Décaissement) peut être effectuée sans transactions préalables ou après vérification des détails du compte du payeur.
L'opération Retrieve Transaction (Extraire la transaction) vous permet de récupérer les détails d'une transaction en utilisant l'ID de commande et l'ID de transaction. Les deux sont requis car l'ID de transaction identifie une transaction dans une commande.
Référence de l'API Retrieve Transaction (Extraire la transaction) [REST][NVP]
L'opération Retrieve Order (Extraire la commande) vous permet de récupérer les détails d'une commande et toutes les transactions associées.
Référence de l'API Retrieve Order (Extraire la commande) [REST][NVP]
L'opération Void (Annuler) tente d'invalider/annuler immédiatement une demande de transaction. Les opérations Void (Annuler) ne sont possibles que sur les transactions qui n'ont pas encore été envoyées à la banque par l'acquéreur pour traitement en fin de la journée. Une fois qu'une transaction a été envoyée par l'acquéreur pour traitement, vous devez effectuer une opération Refund (Rembourser) au lieu d'une opération Void (Annuler).
Vous pouvez annuler les transactions Authorize (Autoriser), Capture (Collecter), Pay (Payer) ou Refund (Rembourser). Une opération Void (Annuler) effectuée sur une transaction Authorize (Autoriser) libérera immédiatement les fonds réservés. Dans tous les autres types de transactions, l'opération Void (Annuler) empêchera le transfert de fonds d'avoir lieu.
L'opération Referral (Renvoyer) resoumet une transaction initiale retournée (transaction Authorization [Autorisation] ou Pay [Payer] qui a reçu de l'acquéreur une réponse « Refer to Issuer » [Renvoyer à l'émetteur]) sous forme de nouvelle transaction Authorization (Autorisation) ou Pay (Payer) avec un code d'autorisation obtenu de l'émetteur.
Le payeur peut être tenu de fournir des informations complémentaires pour que l'émetteur approuve la transaction et fournisse un code d'autorisation/ID d'autorisation manuelle.
Référence de l'API Referral Transaction (Transaction Referral [Renvoyer])[REST][NVP]
Une rétrofacturation a lieu lorsqu'un payeur conteste un paiement qui vous a été fait. Par exemple, les marchandises n'ont pas été reçues ou le payeur n'a pas autorisé le paiement qui vous a été fait. Votre Your payment service provider peut choisir d'importer les détails des transactions Chargeback (Rétrofacturation) sur la passerelle afin que vous les ayez à disposition pour toute recherche et génération de rapports. Votre Your payment service provider peut choisir d'enregistrer chaque transaction Chargeback (Rétrofacturation) par rapport à la commande d'origine ou de créer une nouvelle commande avec une transaction Chargeback (Rétrofacturation) distincte.
La passerelle peut créer plusieurs transactions Chargeback (Rétrofacturation) pour une même commande. Vous pouvez effectuer d'autres transactions sur une commande comportant une transaction Chargeback (Rétrofacturation), par exemple des annulations ou des remboursements.
Une transaction Chargeback (Rétrofacturation) enregistrée avec succès retourne les champs suivants dans la réponse Retrieve Transaction/Retrieve Order :
order.status=CHARGEBACK_PROCESSEDouDISPUTED: lorsqu'une transaction Chargeback (Rétrofacturation) est créée, le statut de la commande correspondante est mis à jour pour indiquer qu'un litige a été soulevé par le payeur.order.status=DISPUTEDindique qu'un litige a été soulevé mais qu'aucun fonds n'a encore été transféré.order.status=CHARGEBACK_PROCESSEDindique qu'une demande de rétrofacturation a été traitée et que les fonds seront transférés depuis ou vers le compte du commerçant.
order.chargeback.amountorder.chargeback.currency- Groupe de paramètres
transaction.dispute: informations sur le litige de rétrofacturation, par exemple, événement de litige, date, etc. transaction.type=CHARGEBACKtransaction.source=SERVICE_PROVIDERgatewayEntryPoint=SERVICE_PROVIDER_API
Référence de l'API Chargeback Transaction (Transaction Chargeback [Rétrofacturation])[REST][NVP]