Dépannage et questions fréquentes
Cette rubrique contient des suggestions et des solutions aux problèmes éventuellement liés à votre intégration.
La fonctionnalité de surcoût sur la passerelle Mastercard permet à un commerçant d'appliquer un surcoût sur une transaction en fonction des paramètres suivants :
- Point d'entrée de passerelle tel que Hosted Checkout ou API.
- Mode de paiement tel que Mastercard, Visa ou American Express.
- Méthode de financement telle que crédit ou débit.
- Devise
Oui, vous pouvez configurer les règles de filtrage sur les IP des pays dans Merchant Administration. Votre prestataire de services de paiement peut configurer des règles pour vous dans Merchant Manager, en plus des règles qui s'appliquent à tous ses commerçants. Cela vous permettra de rejeter ou d'examiner les transactions provenant d'adresses IP associées à des pays à haut risque.
Les remboursements ne peuvent être effectués que lorsqu'un transfert de fonds a été effectué via une transaction Pay (Payer) ou Capture (Collecter).
Les annulations 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.
Oui, vous pouvez définir un paiement récurrent avec un montant variable, par exemple le paiement de factures post-payées. Vous devez mettre à jour la valeur du paramètre amountVariability en fonction des exigences. Pour plus d'informations, voir Transactions avec informations d'identification stockées.
Les principales différences entre les deux versions du SDK sont les suivantes :
| SDK version 1 | SDK version 2 |
|---|---|
| Aucune expérience native dans l'application | Expérience native dans l'application, sans redirections |
| Flux d'authentification avec redirections | Plusieurs flux d'authentification, tels que par mot de passe à usage unique, par sélection unique et multiple, ou basée sur une réponse, sont pris en charge. |
| Flux d'authentification de l'émetteur via un navigateur Web sur un appareil mobile | Flux plus intelligent et sans friction qui entraîne moins de problèmes pour le payeur |
Cela dépend de l'organisme financier qui a émis la carte du payeur. Chaque émetteur de carte définit la période d'expiration de l'autorisation pendant laquelle les fonds sont conservés sur le compte du payeur, en attendant l'arrivée de la transaction Capture (Collecter). Cela correspond généralement à 5 à 8 jours de traitement, avant la suppression de l'autorisation sur le compte du payeur et le rétablissement de l'accès aux fonds pour le payeur.
Vous pouvez utiliser les champs suivants pour intercepter les erreurs de validation :
Le champ error.explanation [REST][NVP] contiendra un texte d'erreur lisible donnant des informations supplémentaires sur l'erreur, par exemple la longueur minimale ou attendue, etc. N'analysez pas ces informations car le format de ce texte ne peut être garanti.
Les intégrations avec le client de paiement et le client de paiement virtuel retournent des codes de réponse différents des énumérations retournées pour DirectAPI. Les tableaux ci-dessous indiquent le mappage entre les deux types de réponses retournées par Mastercard Gateway.
| Client de paiement/Client de paiement virtuel | DirectAPI | ||
|---|---|---|---|
| Code de réponse | Description | response.gatewayCode |
Description |
| 0 | Transaction réussie | APPROVED |
Transaction approuvée |
| 1 | Impossible de traiter la transaction | UNSPECIFIED_FAILURE |
Impossible de traiter la transaction |
| 2 | Transaction refusée - Contacter la banque émettrice | DECLINED |
L'opération demandée a échoué. Par exemple, un paiement a été refusé par l'émetteur ou l'authentification du payeur a échoué |
| 3 | Transaction refusée - Pas de réponse de la banque | TIMED_OUT |
Dépassement de délai pour la réponse |
| 4 | Transaction refusée - Carte arrivée à expiration | EXPIRED_CARD |
Transaction refusée en raison de l'expiration de la carte |
| 5 | Transaction refusée - Crédit insuffisant | INSUFFICIENT_FUNDS |
Transaction refusée en raison de fonds insuffisants |
| 6 | Transaction refusée - Erreur système de la banque | ACQUIRER_SYSTEM_ERROR | Une erreur système de l'acquéreur s'est produite au cours du traitement de la transaction |
| 7 | Erreur de traitement du serveur de paiement. Due en général à des données saisies non valides, par exemple un numéro de carte de crédit. Des erreurs de traitement peuvent également se produire. | SYSTEM_ERROR |
Une erreur système interne s'est produite au cours du traitement de la transaction |
| 8 | Transaction refusée - Type de transaction non pris en charge | NOT_SUPPORTED |
Type de transaction non pris en charge |
| 9 | La banque a refusé la transaction (ne pas contacter la banque) | DECLINED_DO_NOT_CONTACT |
Transaction refusée - Ne pas contacter l'émetteur |
| A | Transaction abandonnée | ABORTED |
Transaction abandonnée par le titulaire de la carte |
| B | Transaction bloquée - Renvoyé lorsque : - Le niveau de sécurité de vérification a la valeur « 07 ». - Le blocage 3D-Secure est activé pour le commerçant. - Le résultat global de l'évaluation des risques renvoie « Reject » (Refus) ou « System Reject » (Refus système). |
BLOCKED |
Transaction bloquée en raison des règles de risques ou de blocages 3-D Secure |
| C | Transaction annulée | CANCELLED |
Transaction annulée par le titulaire de la carte |
| D | Transaction différée | DEFERRED_TRANSACTION_RECEIVED |
Transaction différée reçue et en attente de traitement |
| E | Transaction refusée - Contacter l'émetteur de la carte | REFERRED |
Transaction refusée - Contacter l'émetteur |
| F | Échec de l'authentification 3-D Secure | AUTHENTICATION_FAILED |
Échec de l'authentification 3-D Secure |
| I | Échec du cryptogramme visuel de la carte | INVALID_CSC |
Cryptogramme visuel de la carte non valide |
| L | Transaction d'achat bloquée. Cela indique qu'une autre transaction d'achat utilisant le même numéro de transaction d'achat est en cours. | LOCK_FAILURE |
Commande bloquée - Une autre transaction est en cours pour cette commande |
| M | Transaction soumise (la transaction a été dirigée vers l'acquéreur, mais le serveur de paiement ne l'a pas encore reçue pour la mener à bien) | SUBMITTED |
Transaction soumise - La réponse n'a pas été encore reçue |
| N | Titulaire de la carte non inscrit à 3-D Secure (authentification uniquement) | NOT_ENROLLED_3D_SECURE |
Le titulaire de la carte n'est pas inscrit à 3-D Secure |
| P | Transaction en attente | PENDING |
Transaction en attente |
| R | Limite de tentatives dépassée, transaction non traitée | EXCEEDED_RETRY_LIMIT |
Limite de tentatives de transaction dépassée |
| S | Transaction refusée - Batch en double | DUPLICATE_BATCH |
Transaction refusée en raison d'un batch en double |
| T | Échec de la vérification d'adresse | DECLINED_AVS |
Transaction refusée en raison de la vérification d'adresse |
| U | Échec du cryptogramme visuel de la carte | DECLINED_CSC |
Transaction refusée en raison du cryptogramme visuel de la carte |
| V | Échec de la vérification d'adresse et du cryptogramme visuel de la carte | DECLINED_AVS_CSC |
Échec de la transaction en raison de la vérification d'adresse et du cryptogramme visuel de la carte |
| W | Transaction refusée - Échéancier de paiement non pris en charge | DECLINED_PAYMENT_PLAN |
Transaction refusée en raison de l'échéancier de paiement |
| X | Règlement approuvé en attente - Approuvé par un système de règlement de batches, mais toujours en attente de détails complémentaires de l'acquéreur | APPROVED_PENDING_SETTLEMENT |
Transaction approuvée - Règlement de batch en attente |
| ? | Réponse inconnue | UNKNOWN |
Réponse inconnue |
| Client de paiement/Client de paiement virtuel | DirectAPI | ||
|---|---|---|---|
| Code de réponse | Description | response.cardholderVerification.avs.gatewayCode |
Description |
| X | Correspondance exacte – Adresse et code postal à 9 chiffres | ADDRESS_ZIP_MATCH |
L'adresse et le code postal ont été mis en correspondance. |
| Y | Correspondance exacte – Adresse et code postal à 5 chiffres | ||
| D | Correspondance de l'adresse et du code postal pour la transaction internationale | ||
| M | Correspondance de l'adresse et du code postal pour la transaction internationale | ||
| F | Correspondance de l'adresse et du code postal. Applicable au Royaume-Uni uniquement. | ||
| W | Correspondance du code postal à 9 chiffres, non-correspondance de l'adresse | ZIP_MATCH |
Correspondance du code postal Non-correspondance de l'adresse |
| P | Correspondance des codes postaux pour la transaction internationale, mais adresse non vérifiée en raison de formats incompatibles. | ||
| Z | Correspondance du code postal à 5 chiffres, non-correspondance de l'adresse | ||
| A | Correspondance de l'adresse uniquement | ADDRESS_MATCH |
Correspondance de l'adresse |
| B | Correspondance de l'adresse pour la transaction internationale. Code postal non vérifié en raison de formats incompatibles. | ||
| S | Service actuellement non pris en charge. | SERVICE_NOT_SUPPORTED |
Service non pris en charge actuellement par l'acquéreur ou le commerçant. |
| G | Transaction internationale, informations d'adresse indisponibles. | NOT_VERIFIED |
Impossible de vérifier l'AVS pour une transaction internationale |
| C | Adresse et code postal non vérifiés pour une transaction internationale en raison de formats incompatibles. | ||
| I | Visa uniquement. Adresse non vérifiée pour une transaction internationale. | ||
| R | Système de l'émetteur indisponible. Réessayer. | SERVICE_NOT_AVAILABLE_RETRY |
Système de l'émetteur indisponible. Nouvelle tentative possible |
| U | Adresse indisponible, aucune donnée de l'émetteur. | NOT_AVAILABLE |
Aucune donnée de l'émetteur disponible ou données AVS non prises en charge pour la transaction |
| E | N'est pas une commande par courrier/téléphone. | ||
| N | Non-correspondance de l'adresse et du code postal | NO_MATCH |
Pas de correspondance |
| 0 (Zéro) | Aucun AVS demandé. (Utilisé par VisaII.) | NOT_REQUESTED |
AVS non demandé. |
| K | Correspondance du nom du titulaire de la carte uniquement. | NAME_MATCH |
Correspondance du nom du titulaire de la carte |
| Y | Correspondance du nom du titulaire de la carte et de l'adresse | NAME_ADDRESS_MATCH |
Correspondance du nom du titulaire de la carte et de l'adresse |
| L | Correspondance du nom du titulaire de la carte et du code postal | NAME_ZIP_MATCH |
Correspondance du nom du titulaire de la carte et du code postal |
| Client de paiement/Client de paiement virtuel | DirectAPI | ||
|---|---|---|---|
| Code de réponse | Description | response.cardSecurityCode.gatewayCode |
Description |
| M | Cryptogramme visuel valide ou correspondant | MATCHED |
Valide ou correspondant |
| S | Le commerçant indique un cryptogramme visuel non présent sur la carte | NOT_PRESENT |
Le commerçant indique un cryptogramme visuel non présent sur la carte |
| P | Cryptogramme visuel non traité | NOT_PROCESSED |
Non traité |
| U | L'émetteur de la carte n'est pas enregistré et/ou certifié | NOT_SUPPPORTED |
L'émetteur de la carte n'est pas enregistré et/ou certifié |
| N | Code non valide ou non correspondant | NO_MATCH |
Non valide ou non correspondant. |
Oui, vous pouvez en toute sécurité resoumettre une demande avec exactement les mêmes détails, la passerelle prenant en charge les opérations idempotentes. Lorsqu'appelées à plusieurs reprises, les opérations idempotentes produisent le même résultat. Si la passerelle a déjà reçu votre demande, elle retourne la réponse initiale ; sinon, elle traite la demande et retourne la réponse.
Généralement, vous pouvez faire correspondre les demandes et les réponses à l'aide des champs order.id et transaction.id, ces champs étant fournis dans les demandes et retournés dans les réponses. Cependant, si votre application ne prend pas en charge de modèle d'intégration synchrone ou si la source et la cible d'une demande diffèrent, vous pouvez utiliser le champ correlationId pour identifier la demande et la réponse correspondante. correlationId est un identifiant temporaire, sa valeur n'est pas conservée sur la passerelle et cet ID est retourné comme fourni dans la réponse à la demande. Vous pouvez utiliser correlationId avec toutes les demandes DirectAPI.
No merchant acquirer link (Aucun lien commerçant-acquéreur) s'affiche-elle pour un acquéreur pour lequel mon système est configuré ?Veuillez contacter votre your payment service provider afin de vous assurer que votre lien commerçant-acquéreur sur la passerelle est configuré pour les combinaisons requises de type de carte et de devise.
Merchant Administration est une interface basée sur le Web qui permet aux commerçants de consulter et gérer très facilement leurs commandes. Les commerçants peuvent rechercher les détails de leur commandes/transactions, télécharger des rapports CSV, vérifier les résultats 3-D Secure, définir les contrôles du risque, créer manuellement des commandes, gérer les remboursements, et bien plus encore. Pour plus d'informations, reportez-vous au Guide de l'utilisateur Merchant Administration.
Les commerçants doivent être enregistrés sur la passerelle et leur profil de commerçant doit être configuré correctement afin de pouvoir accéder à Merchant Administration.
L'émetteur ou le système de cartes peut fournir des informations supplémentaires sous la forme d'un code d'avertissement du commerçant, qui vous aidera à comprendre la raison du refus de la transaction. Lorsqu'une transaction est refusée pour fonds insuffisants, le code d'avertissement peut recommander un laps de temps avant toute nouvelle tentative aux commerçants dans lequel une approbation d'autorisation est susceptible de réussir.
Le tableau suivant propose une description des différents codes d'avertissement de commerçant renvoyés par les systèmes.
| Code d'avertissement du commerçant | Recommandation de système |
|---|---|
| 01 | Nouvelles informations sur le compte disponibles |
| 02 | Approbation impossible pour le moment, réessayez ultérieurement |
| 03 | Ne pas réessayer |
| 04 | Exigences en matière de jeton non remplies pour ce type de jeton |
| 05 | Valeur négociée non approuvée |
| 21 | Annulation du paiement |
| 22 | Le commerçant n'a pas droit au code de produit |
| 24 | Réessayer après 1 heure |
| 25 | Réessayer après 24 heures |
| 26 | Réessayer après 2 jours |
| 27 | Réessayer après 4 jours |
| 28 | Réessayer après 6 jours |
| 29 | Réessayer après 8 jours |
| 30 | Réessayer après 10 jours |
| R0 | Ordre d'opposition au paiement |
| R1 | Ordre d'annulation de l'autorisation |
| R3 | Ordre d'annulation de toutes les autorisations |