Dépannage et questions fréquentes
Cette section contient des suggestions et des solutions aux problèmes éventuellement liés à votre intégration.
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 risque ou de blocage 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 code de sécurité de la carte | INVALID_CSC |
Code de sécurité 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 code de sécurité de la carte | DECLINED_CSC |
Transaction refusée en raison du code de sécurité de la carte |
V | Échec de la vérification d'adresse et du code de sécurité de la carte | DECLINED_AVS_CSC |
Échec de la transaction en raison de la vérification d'adresse et du code de sécurité 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 |
O | 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 | CSC valide ou correspondant | MATCHED |
Valide ou correspondant |
S | Le commerçant indique un CSC non présent sur la carte | NOT_PRESENT |
Le commerçant indique un CSC non présent sur la carte |
P | CSC 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 prestataire de services de paiement 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 réseau de carte 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 |