Aller au contenu principal
Sur cette page

American Express (AMEX) est un réseau de paiement mondial de premier plan connu pour ses titulaires de cartes de grande valeur et ses protocoles de sécurité avancés. En s'intégrant directement à AMEX via ISO 8583, les commerçants Deuna contournent les passerelles tierces pour réduire la latence, minimiser les coûts de traitement et obtenir un contrôle granulaire sur les données de transaction.

Opérations prises en charge

L'intégration d'AMEX dans votre stratégie de paiement avec DEUNA vous permet de réaliser les opérations suivantes :

FonctionnementNom AMEXDemande/Réponse MTI
AutorisationAutorisation1100/ 1110
Achat (Capture automatique à Deuna)Autorisation1100 / 1110
Remboursement complet-le lendemain/remboursement partielRemboursementDemande hors ligne
Capture complète/partielleCapturerDemande hors ligne
Remboursement intégral le jour mêmeAnnulation d'autorisation1420 / 1430
VideAnnulation d'autorisation1420 / 1430

Fonctionnalités prises en charge

  • 3DS (Deuna ou MPI externe)
  • Versements
  • MOTO
  • Informations sur la compagnie aérienne

Méthodes de paiement prises en charge

  • Cartes de débit et de crédit: Visa, Mastercard, AMEX

Processus de règlement

L'intégration AMEX nécessite un processus en deux étapes pour offrir un processus de rapprochement plus fiable et plus efficace. Au lieu de compenser chaque transaction une par une en temps réel, toutes les autorisations approuvées sont regroupées et envoyées ensemble en fin de journée dans un seul fichier batch. Cela rend la comptabilité, l’audit et la vérification des erreurs quotidiennes beaucoup plus faciles à gérer. La coupure a lieu à 23h00, heure CDMX.

Ce processus se reflète dans le statut du paiement dans Deuna, comme expliqué dans le tableau suivant :

FonctionnementNom AMEXDemande/Réponse MTIStatut Deuna avant règlementStatut Deuna après le règlement
AutorisationAutorisation1100/ 1110AutoriséAutorisé (aucun changement)
Achat (Capture automatique)Autorisation1100 / 1110TraitementTraité
Remboursement complet-le lendemain/remboursement partielRemboursementDemande hors ligneRemboursement / Remboursement partielRemboursé / Remboursé partiellement
Capture complète/partielleCapturerDemande hors ligneCapture / Capture partielleCapturé / Capturé partiellement
Remboursement intégral le jour mêmeAnnulation d'autorisation1420 / 1430RembourséRemboursé (pas de changement, annulation en ligne)
VideAnnulation d'autorisation1420 / 1430AnnuléAnnulé (pas de changement, annulation en ligne)

Intégrer AMEX#

En tant qu'orchestrateur de paiements et de fraudes, notre plateforme vous permet de connecter facilement votre compte marchand AMEX directement à votre flux de paiement. Cela vous permet de tirer parti des capacités de traitement d’AMEX dans le cadre d’une stratégie de paiement sophistiquée basée sur des règles, vous aidant ainsi à optimiser les taux d’acceptation et à réduire les coûts.

Ce guide vous guidera à travers les informations d'identification nécessaires pour connecter AMEX dans notre administration.

Conditions requises

Avant de pouvoir configurer AMEX dans notre administration, vous devez disposer d'un compte marchand actif chez eux. Lors de votre intégration, AMEX vous fournira un ensemble d'informations d'identification uniques pour votre intégration ISO directe.

Veuillez rassembler les champs obligatoires suivants auprès de votre responsable d'intégration AMEX ou des documents de bienvenue :

  • ID d'affiliation (ID de commerçant, numéro SE) : Votre identifiant unique à 10 chiffres pour votre compte marchand.
  • Terminal ID: un code unique qui identifie un terminal spécifique chez un commerçant.

Étapes de configuration

La connexion à AMEX est une configuration simple et unique dans notre portail d'administration.

  1. Connectez-vous à votre portail d'administration.

  2. Accédez à Connexions under Payments section**,** find AMEX et sélectionnez Connect.

    Exemple interactifUtilise des données fictives et n’effectue aucune requête API.
    Production
    Paiements

    Connexions

    Découvrez et gérez les intégrations de paiement, de portefeuille et antifraude.

    Acme LATAM · Production
    5 connexions fictivesMis à jour à l’instant
    ConnexionsTypeStatutAction
    AdyenPasserelle de paiementConnectée
    WorldpayPasserelle de paiementConnectée
    PayPalMoyen de paiementConnectée
    Mercado PagoMoyen de paiementNon connectée
    RiskifiedMoteur antifraudeNon connectée
  3. Un formulaire apparaîtra. Saisissez soigneusement les informations suivantes ainsi que les informations d'identification recueillies auprès d'AMEX et de votre conseiller Deuna.

    Nom

    Détail

    Devise

    Sélectionnez la devise du processeur de paiement

    Affiliation ID

    Votre identifiant unique à 10 chiffres pour votre compte marchand obtenu auprès d'AMEX

    ID de l'auteur (fourni par Deuna)

    Identifiant de l'auteur fourni par votre conseiller Deuna

    Acquirer Afiliation ID

    Utilisez les codes suivants en fonction de la région de votre compte marchand :

    • États-Unis : 10000000002
    • Canada : 10000000006
    • Mexique : 10000000005
    • Argentine : 10000000085
    • EMEA (Europe, Moyen-Orient, Afrique) : 10000000232
    • Japon : 10000000319

    ID du terminal (suggéré : "00000001")

    Utilisez « 00000001 » à moins qu'AMEX ou Deuna ne conseille une valeur différente.

    Code de données du point de vente (POS) (par défaut « 1000S0100010 »)

    Utilisez « 1000S0100010 » à moins qu'AMEX ou Deuna ne conseille une valeur différente.

    Code de catégorie de commerçant (4 chiffres)

    Votre code de catégorie à 4 chiffres : « 4511 »

    Longueur du code d'approbation (par défaut : "6")

    Utilisez « 6 » à moins qu'AMEX ou Deuna ne conseille une valeur différente.

    Nom du commerçant

    Nom commercial du commerçant

    Adresse du commerçant (rue, numéro, numéro intérieur)

    L'adresse du commerçant composée par rue, numéro et intérieur (le cas échéant).

    Ville marchande

    La ville où le commerçant est enregistré

    Code postal du commerçant (par exemple « 11510 »)

    Le code postal où les services sont fournis ou où le commerçant est inscrit

    Code de l'État marchand (3 chiffres)

    Le code d'État à 3 chiffres dans lequel les services sont fournis ou où le commerçant est enregistré. Pour les Etats composés de codes à 2 chiffres, vous devez ajouter un espace. Exemple : Floride -> "FL "

    Code du pays du commerçant (3 chiffres numériques)

    Le pays où les services sont fournis ou où le commerçant est enregistré, au format à 3 chiffres numériques.

    ID du vendeur (uniquement pour le mode agrégateur. Par défaut "0000000000")

    Utilisez « 0000000000 » à moins qu'AMEX ou Deuna ne conseille une valeur différente.

    E-mail du vendeur (Uniquement pour le mode agrégateur. Par défaut "merchant@merchant.com")

    Utilisez "merchant@merchant.com» À moins qu'AMEX ou Deuna ne conseille une valeur différente.

    Téléphone du vendeur (uniquement pour le mode agrégateur. Par défaut "55555555555")

    Utilisez « 55555555555 » à moins qu'AMEX ou Deuna ne conseille une valeur différente.

    Code motif du message (par défaut : "1900")

    Utilisez « 1900 » à moins qu'AMEX ou Deuna ne conseille une valeur différente.

    Code de traitement d'authentification ("004000" ou "004800" pour activer AAV)

    Si vous décidez d'utiliser le service de vérification d'adresse (AVV) d'AMEX, utilisez « 004800 », sinon, utilisez « 004000 ».

    Type de vérification automatisée des adresses (AAV) (« AD » ou « AE ». « AD » suggéré

    Si vous décidez d’utiliser l’AAV d’AMEX :

    Utilisez « AD » (suggéré) ou « AE » selon vos besoins :

    • Autorisation, Standard (AD) : elle est utilisée pour soumettre différents niveaux de données de titulaire de carte et d'expédition pour vérification.

    • Autorisation améliorée (AE) : prend en charge toutes les fonctionnalités du format AD tout en fournissant des options de vérification supplémentaires pour le numéro de téléphone de facturation du titulaire de la carte et l'adresse e-mail du client.

      Si vous n'utilisez pas l'AAV d'AMEX, utilisez « AD » dans ce champ. |

  4. Sélectionnez si vous souhaitez cette connexion en mode Vente (Achat) ou Pré-autorisation (Autorisation).

  5. Si nécessaire, vous pouvez activer 3DS géré par DEUNA pour les connexions AMEX compatibles en suivant les instructions Guide de configuration 3DS.

  6. Cliquez "Enregistrer".

  7. Notre système validera les informations d'identification et AMEX apparaîtra comme "Actif" dans votre liste de processeurs connectés.


Cartes de test#

AMEX s'appuie sur des PAN spécifiques et revient à approuver les transactions dans leur environnement Sandbox. Toute combinaison différente de PAN et de montant entraînera une transaction refusée avec des codes d'erreur génériques comme pick up card:

PANorder.total_amount (en centimes)ExpirationCVV (CID)
37395319235100452500N'importe quel dans le futurN'importe lequel
37395319235100453000N'importe quel dans le futurN'importe lequel
37395319235100456500N'importe quel dans le futurN'importe lequel
37395319235100457500N'importe quel dans le futurN'importe lequel
37395319235100458500N'importe quel dans le futurN'importe lequel
37395319235100459500N'importe quel dans le futurN'importe lequel
37395319235100461000N'importe quel dans le futurN'importe lequel

Détails techniques : Autorisation ISO 8583#

Notre intégration utilise le 1100 (Demande d'autorisation) et 1110 (Réponse d'autorisation) types de messages. Pour maintenir des taux d'approbation élevés et garantir le transfert de responsabilité, les champs suivants sont obligatoires ou fortement recommandés :

Remarque : Il s'agit d'une liste représentative des champs les plus couramment utilisés pour une autorisation de commerce électronique et non d'une spécification exhaustive.

ChampNom du champDescriptif
MTIIdentificateur du type de message1100 indique une demande d'autorisation
Champ 2Numéro de compte principal (PAN)Le numéro de carte à 16-19 chiffres du client. Affiché masqué sous la forme d'un numéro d'identification de carte.
Champ 3Code de traitementIndique le type de transaction (par exemple, 200 000 pour un achat).
Champ 4Montant, TransactionLe montant total de l'achat dans la devise de la transaction. Montré en centimes.
Champ 7Date et heure de transmissionLa date et l'heure auxquelles la transaction a été initiée (MMJJhh : mm):ss).
Champ 11Numéro d'audit de suivi du système (STAN)Un numéro unique à 6 chiffres pour identifier la transaction.
Champ 12Date et heure locales de la transactionLa date et l'heure auxquelles la transaction a été initiée (AAMMJJhh : mm):ss).
Champ 14Date d'expirationLa date d'expiration de la carte au format AAMM. Affiché haché.
Champ 19Indicatif du paysCode pays à 3 chiffres de la transaction. Affiché haché.
Champ 22Données de point de ventePour le commerce électronique, cela indique le statut de carte non présente. Attendez-vous à « 1000S0100010 »
Champ 24Code de fonctionCode d'opération à 3 chiffres (autorisation, remboursement, etc.). Affiché haché.
Champ 25Code motif du messageCode motif du message (« 1900 »). Affiché haché.
Champ 26Code professionnel de l'accepteur de carteCentre multicompte du commerçant.
Champ 27Code d'approbationLongueur du code d'approbation ("6")
Champ 32Acquirer Institution IDIdentifiant d’affiliation de l’acquéreur. Exemple « 1 000 000 000 ».
Champ 37Numéro de référence de récupérationValeur unique à 12 chiffres sur une période de 24 heures pour identifier la transaction. Affiché haché.
Champ 41Card Acceptor Terminal IDVotre identifiant de terminal (TID) à 8 chiffres. Exemple « 00000001 »
Champ 42Code d'identification de l'accepteur de carte (identifiant du commerçant)Votre identifiant marchand à 10 chiffres (issu de vos paramètres).
Champ 43Emplacement du nom de l'accepteur de carteNom du commerçant, nom de la ville du commerçant tel que défini dans les informations d'identification
Champ 47Données complémentaires nationalesDétails de facturation, d'expédition et de compagnie aérienne
Champ 48Données privées supplémentairesIndicateur de paiement étendu American Express, qui comprend le type de plan et le nombre de versements. Les types de plan sont 03 (plan de versements) et 05 (mois différés) : Exemple : « 0306 ». Peut être affiché haché.
Champ 49Code devise, transactionLe code de devise ISO numérique à 3 chiffres (par exemple, 840 pour USD). Affiché haché
Champ 61Données d'utilisation nationaleContient 3-D Secure 2.x et les détails du commerçant
Champ 63Données privéesContient des données AAV

Champ 47 Données supplémentaires nationales (détails sur la facturation, l'expédition et la compagnie aérienne)

Champ 47Nom du champDescriptif
Sous-champ 0Marque et type de transactionConcat of two digit card brand code, **in case is not airlines or IAC if is airline order. “**AXITD”
Sous-champ 1(Not sent in Airline orders) CUSTOMER EMAIL ID (CE ID)L'identifiant de messagerie du client est le littéral constant « CE »
Sous-champ 2(Non envoyé dans les commandes des compagnies aériennes) EMAIL CLIENTExemple : CFFROST@EMAILADDRESS.COM
Sous-champ 3(Not sent in Airline orders) CUSTOMER HOSTNAME ID (CHID)L'ID du nom d'hôte du client est un littéral constant « CH »
Sous-champ 4(Non envoyé dans les commandes des compagnies aériennes) NOM D'HÔTE DU CLIENT.Le domaine de messagerie du client. Exemple « GMAIL.COM »
Sous-champ 5(Not sent in Airline orders) HTTP BROWSER TYPE ID (HBT ID)L'ID de type du navigateur HTTP est un littéral constant « HBT »
Sous-champ 6(Non envoyé dans les commandes des compagnies aériennes) TYPE DE NAVIGATEUR HTTPAgent utilisateur issu de la requête : Exemple : MOZILLA/4.0~(COMPATIBLE;MSIE5.0;WINDOWS95)
Sous-champ 7(Not sent in Airline orders) SHIP TO COUNTRY ID (STC ID)L'ID du pays de destination est un littéral constant « STC »
Sous-champ 8(Non envoyé dans les commandes des compagnies aériennes) EXPÉDIER AU PAYSCode de pays numérique à trois chiffres. Exemple 840
Sous-champ 9(Not sent in Airline orders) SHIPPING METHOD ID (SM ID)L'ID du mode d'expédition est le littéral constant « SM »
Sous-champ 10(Non envoyé dans les commandes aériennes) MODE D'EXPÉDITIONLa valeur des commandes à emporter est « 06 », sinon « 03 » (shipping_options.type)
Sous-champ 11(Not sent in Airline orders) MERCHANT PRODUCT SKU ID (MPS ID)L'ID SKU du produit marchand est un littéral constant « MPS »
Sous-champ 12(Non envoyé dans les commandes des compagnies aériennes) SKU PRODUIT MARCHANDSKU de l’article le plus cher envoyé dans la commande. Si aucun SKU n'est envoyé, la valeur est "ND".
Sous-champ 13(Non envoyé dans les commandes des compagnies aériennes) IP CLIENTAdresse IP Internet du client
Sous-champ 14(Non envoyé dans les commandes des compagnies aériennes) CLIENT ANItéléphone sans « + » ni espaces
Sous-champ 16(Uniquement pour les commandes des compagnies aériennes) DATE DE DÉPARTDate de départ (format CCAAMMJJ) comme « 20030101 »
Sous-champ 17(Only for Airline orders) AIRLINE PASSENGER NAME ID (APN ID)L'identifiant du nom du passager de la compagnie aérienne est un littéral constant « APN »
Sous-champ 18(Uniquement pour les commandes des compagnies aériennes) NOM DU PASSAGERNom du passager au format : "FROST JANE M MRS"
Sous-champ 19(Uniquement pour les commandes des compagnies aériennes) ORIGINE (Aéroport d'origine)Aéroport d’origine pour le premier segment du voyage : code IATA de l’aéroport d’origine comme « SEA »
Sous-champ 20(Uniquement pour les commandes des compagnies aériennes) DESTAéroport de destination pour le premier segment du voyage : code IATA de l'aéroport de destination JFK
Sous-champ 21(Only for Airline orders) ROUTING ID (RTG ID)L'ID de routage est un littéral constant « RTG »
Sous-champ 22(Uniquement pour les commandes des compagnies aériennes) NOMBRE DE VILLESNombre total de visites des villes depuis les aéroports d'origine et de destination.
Sous-champ 23(Uniquement pour les commandes des compagnies aériennes) VILLES DE ROUTAGECodes d'aéroport ou de ville d'acheminement pour chaque étape du billet (y compris ORIGINE et DEST) : STL / JFK / MIA
Sous-champ 24(Only for Airline orders) AIRLINE CARRIERS ID (ALC ID)L'identifiant des transporteurs aériens est le littéral constant « ALC »
Sous-champ 25(Uniquement pour les commandes des compagnies aériennes) NOMBRE DE TRANSPORTEURS AÉRIENSNombre de compagnies aériennes participant au voyage
Sous-champ 26(Uniquement pour les commandes aériennes) TRANSPORTEURS AÉRIENSCode du transporteur aérien pour chaque étape du billet (y compris ORIGIN et DEST). Exemple AB / DC / EF
Sous-champ 27(Uniquement pour les commandes des compagnies aériennes) BASE TARIFAIRE« Affaires »
Sous-champ 28(Uniquement pour les commandes des compagnies aériennes) NOMBRE DE PASSAGERSNombre de passagers au format : 001
Sous-champ 29(Uniquement pour les commandes des compagnies aériennes) IP CLIENTAdresse IP Internet du client. Exemple 127.142.151.223
Sous-champ 30(Only for Airline orders) USTOMER EMAIL ID (CE ID)L'identifiant de messagerie du client est le littéral constant « CE »
Sous-champ 31(Only for Airline orders) USTOMER EMAIL IDAdresse e-mail du client. Exemple :CFFROST@EMAILADDRESS.COM

Champ 61 Sous-champs clés (détails 3DS)

Champ 61Nom du champDescriptif
Sous-champ 0Primary and Secondary IDValeur constante « AXASK »
Sous-champ 1INDICATEUR DE COMMERCE ÉLECTRONIQUE (ECI)Valeurs possibles : 05 = Authentifié avec AEVV, 06 = Tentative avec AEVV, 07 = Non authentifié
Sous-champ 2AMERICAN EXPRESS VERIFICATION VALUE (AEVV) IDValeur constante « AEVV »
Sous-champ 3AMERICAN EXPRESS VERIFICATION VALUE(AEVV) valeur cryptographique dérivée par l'émetteur avec les résultats d'authentification du paiement American ExpressSafeKey. Il s'agit d'une base64 de 28 caractères, une fois décodée, elle peut afficher des informations clés sur l'analyse effectuée. Exemple : « AAkBAmRGkyNEM1J5EkaTAAAAAAA="
Sous-champ 4AMERICAN EXPRESS SAFEKEY TRANSACTION ID (XID)Valeur constante « XID »
Sous-champ 5AMERICAN EXPRESS SAFEKEY TRANSACTION ID VALUEL’identifiant de transaction American Express SafeKey est déterminé lors de l’authentification du paiement American Express SafeKey. Valeur Base64. Exemple : « AgIAADm0+B7htUfXuLAUcDlOUtM= »

Champ 63 Sous-champs clés (données AAV)

Champ 63Nom du champDescriptif
Sous-champ 1IDENTIFIANT DE SERVICE (AX)Constante « AX »
Sous-champ 2REQUEST TYPE IDENTIFIERType AAV sélectionné dans la configuration, soit « AD » ou « AE »
Sous-champ 3CARDMEMBER BILLING POSTAL CODEExemple « 98107 »
Sous-champ 4CARDMEMBER BILLING ADDRESSExemple « 6201 14TH AVE NW »
Sous-champ 5CARDMEMBER FIRST NAMEExemple « LEAO »
Sous-champ 6CARDMEMBER LAST NAMEExemple « BUTRON »
Sous-champ 7CARDMEMBER BILLING PHONE NUMBERNuméro de téléphone de facturation. Exemple « 4155688537 »
Sous-champ 8SHIP-TO POSTAL CODEExemple « 98107 »
Sous-champ 9SHIP-TO ADDRESSExemple « 6201 14TH AVE NW »
Sous-champ 10SHIP-TO FIRST NAMEExemple « LOURDES »
Sous-champ 11SHIP-TO LAST NAMEExemple « MONTÉNÉGRO »
Sous-champ 12SHIP-TO PHONE NUMBERExemple « 4155797662 »
Sous-champ 13SHIP-TO COUNTRY CODEIndicatif du pays sous forme de numéro à 3 chiffres : « 840 »

La demande et les réponses partagent les mêmes noms de champ et les mêmes informations dans la plupart des cas, la principale différence étant les champs 38 et 39, qui sont liés aux résultats d'autorisation :

  • Champ 38 : Autorisation de code d'autorisation ou demande d'annulation (annulation).
  • Champ 39 : Les demandes d'autorisation approuvées auront la valeur « 000 » et les demandes d'annulations approuvées auront la valeur « 400 » en cas d'annulations (annulées). Chaque valeur différente sera liée à un code d'erreur qui sera affiché dans l'administrateur avec sa description.
  • Champ 44 : Code résultat AVS exprimé en lettre à un chiffre. Les valeurs possibles sont expliquées dans la section suivante.

Résultats AVS

Lorsque AMEX AVS (AAV) est activé dans la configuration avec la valeur « 004800 », le champ 44 renverra le résultat AVS sous forme de lettres à un chiffre, qui auront un équivalent dans les codes d'erreur Deuna AVS :

Code Amex AAVDéfinitionCode AVS de Deuna
ZSeul le code postal est correctA01
UnSeule l'adresse est correcteA02
KSeul le nom du titulaire de la carte est correctA03
ÔLe nom et l'adresse du titulaire de la carte sont correctsA04
LLe nom du titulaire de la carte et le code postal sont correctsA05
OuiL'adresse et le code postal sont correctA06
NL'adresse et le code postal sont incorrectA07
MLe nom, l'adresse et le code postal du titulaire de la carte sont correctsA08
ENom du titulaire de la carte incorrect, adresse correcte, code postal correctA12
FNom du titulaire de la carte incorrect, adresse correcte, code postal incorrectA13
réNom du titulaire de la carte incorrect, adresse incorrecte, code postal correctA14
WLe nom, l'adresse et le code postal du titulaire de la carte sont tous incorrectsA15
ULes informations de vérification de l'adresse ne sont pas disponiblesA16
SLa vérification de l'adresse n'est pas autoriséeA17
R.La vérification de l'adresse n'est pas disponible, réessayez.A18

Prochaines étapes#

Votre connexion AMEX est désormais active !

La dernière étape consiste à l'intégrer dans votre flux de transactions. Allez au Stratégie de paiement de l'administrateur pour créer des règles qui définissent quelles transactions sont acheminées vers AMEX (par exemple, « Acheminer toutes les transactions en EUR vers AMEX »).

Exemple interactifUtilise des données fictives et n’effectue aucune requête API.
Production
Paiements

Stratégies de paiement

Configurez le traitement par défaut et les règles de chaque flux de paiement.

Acme LATAM · Production

Traitement par défaut

Configurez le traitement par défaut et les règles de chaque flux de paiement.

RègleRoutageStatutAction
Traitement par défautAdyen → WorldpayActive

Règles spécifiques

Configurez le traitement par défaut et les règles de chaque flux de paiement.

1 règle fictiveProcesseurs de paiement
PrioritéRègleConditionsRoutageStatut
1Commandes de valeur élevéeMontant supérieur à 100 USDAdyen → WorldpayActive