Whenever you send a request to our platform, you need to provide specific information by using parameters. This accounts for any scenario, such as (just to name a few):

The same principle also applies to our platform sending information to you, i.e. for

To ensure our platform processes your requests correctly, you need to

  • Get all mandatory/recommended/optional parameters from the respective guide
  • Consult this Parameter Cookbook to assign correct values to them

Learn here how to read the individual columns:

  • Field name: Name of the parameter
  • Details: A detailed description about the parameter's purpose in a request
  • Input: Can you send the parameter in a request to our platform? If sent anyway, our platform ignores it 
  • Output: Is the parameter included in notifications sent from our platform?
  • Format: Data type 
  • Max Length: Maximum amount of characters
  • Example: A typical value to give you an idea of the expected value, allowed format and maximum length
Nom du champ Description Entrée Sortie Format Longueur maximale Exemple
AAVADDRESS Indique le résultat AAV pour l'adresse (voir aussi AAVCHECK)  Non Oui AN 2 OK
AAVCHECK Résultat de la vérification automatique de l'adresse. Cette vérification n'est pas prise en charge par tous les acquéreurs de cartes de crédit.

Valeurs possibles :
KO : l'adresse a été envoyée mais l'acquéreur a retourné une réponse négative à la vérification de l'adresse, autrement dit l'adresse est erronée.
OK : l'adresse a été envoyée et l'acquéreur a retourné une réponse positive à la vérification de l'adresse, autrement dit l'adresse est correcte OU
L'acquéreur a envoyé un code d'autorisation, mais n'a pas retourné de réponse à la vérification de l'adresse.
NO : Tous les autres cas. Par exemple, aucune adresse transmise ; l'acquéreur a répondu qu'une vérification de l'adresse était impossible ; l'acquéreur a refusé l'autorisation mais n'a pas fourni de résultat particulier pour la vérification de l'adresse, etc.
Non Oui AN 2 NO
AAVMAIL Procédures d’authentification des adresses e-mail. Applicables uniquement aux transactions American Express. Non Oui AN 2 OK,KO
AAVNAME Procédures d’authentification des noms de titulaire. Applicables uniquement aux transactions American Express. Non Oui AN 2 OK,KO
AAVPHONE Procédures d’authentification des numéros de téléphone. Applicables uniquement aux transactions American Express. Non Oui AN 2 OK,KO
AAVZIP Indique le résultat AAV pour le code postal (voir aussi AAVCHECK) Non Oui AN 2 KO
ACCEPTANCE Code d'acceptation (autorisation) de l'acquéreur.

L'acquéreur renvoie ce code pour confirmer que le montant de la transaction a été bloqué sur la carte du client. Le code d'acceptation n'est pas unique.
Non Oui AN 16 04306B
ACCEPTURL URL de la page web à afficher au client quand le paiement est autorisé. Oui Non AN 200 http://www.myshop.com/accept.html
Account.PSPID Votre nom d'affiliation dans notre système, choisi par vous-même à l'ouverture de votre compte chez nous. Cet identifiant unique ne peut jamais être modifié. Oui Non AN 30 MyPSPID123
ADDMATCH Précise si nous considérons que l'adresse de facturation et d'expédition sont identiques

1=yes
0=no
Oui Non AN 1 1
ADDRMATCH voir ADDMATCH Oui Non AN 1 1
AIACTIONNUMBER Numéro de l'action Oui Non AN 17
AIAGIATA Numéro d'agence IATA Oui Non AN 8
AIAIRNAME Nom de la compagnie aérienne Oui Non AN 20 Brussels Airlines
AIAIRTAX Taxes d'aéroport Oui Non AN 11
AIBOOKIND*XX* Indicateur de réservation Oui Non AN 2
AICARRIER*XX* Code du transporteur Oui Non AN 4 SN
AICHDET Détails des frais Oui Non AN 49
AICLASS*XX* Classe de voyage Oui Non AN 15
AICONJTI Billet en conjonction Oui Non AN 3
AIDEPTCODE Code de département du champ DBI Oui Non AN 17
AIDESTCITY*XX* Aéroport d'arrivée (abrégé) Oui Non AN 5 BLQ
AIDESTCITYL*XX* Aéroport d'arrivée (long) Oui Non AN 20 Guglielmo Marconi
AIEXTRAPASNAME*XX* Nom du passager supplémentaire Oui Non AN 49
AIEYCD Indicatif régional de la destination Oui Non AN 3
AIFLDATE*XX* Date du vol Oui Non YYYYMMDD 20 20120504
AIFLNUM*XX* Numéro du vol Oui Non AN 4 1234
AIGLNUM Numéro de compte du champ DBI Oui Non AN 17
AIINVOICE Bon de livraison/numéro de facture Oui Non AN 17
AIIRST Type d'indicatif régional de la destination Oui Non AN 1
AIORCITY*XX* Aéroport de départ (abrégé) Oui Non AN 5 BRU
AIORCITYL*XX* Aéroport de départ (long) Oui Non AN 20 Brussels
AIPASNAME Nom du passager Oui Non AN 49
AIPROJNUM Numéro de projet du champ DBI Oui Non AN 17
AISTOPOV*XX* Escale Oui Non AN 1
AITIDATE Date d'émission du billet Oui Non Date/Time 20 15/04/2012 13:14:56
AITINUM Numéro du billet Oui Non AN 16 123
AITINUML*XX* Numéro du billet Oui Non AN 16 123
AITYPCH Type de frais Oui Non AN 2
AIVATAMNT Montant de la TVA Oui Non AN 11
AIVATAPPL TVA applicable Oui Non AN 1
ALIAS Nom d'alias. Dès que l'alias a été créé, vous pouvez l'utiliser pour remplacer le numéro de la carte dans les demandes de transaction.

Évitez d'utiliser des espaces et des caractères spéciaux dans l'alias.
Oui Oui AN 50 9897B5BB-4981-4633-BF46-40DCD6DFAB1F
Alias.AliasId Nom d'alias. Dès que l'alias a été créé, vous pouvez l'utiliser pour remplacer le numéro de la carte dans les demandes de transaction.

Évitez d'utiliser des espaces et des caractères spéciaux dans l'alias.
Oui Non AN 30 9897B5BB-4981-4633-BF46-40DCD6DFAB1F
Alias.OrderId Votre numéro de commande (référence du commerçant).

Cette référence est généralement utilisée par le commerçant pour consulter sa transaction dans le Back Office.
Pour le mode à 3 niveaux, en ligne, le système utilise aussi cette référence pour vérifier qu'un paiement n'est pas demandé deux fois pour la même commande. À la demande du commerçant, cette période de vérification peut être réduite ou la vérification désactivée.

Si l'acquéreur est techniquement capable de traiter la transaction, et si le compte ne contient aucune configuration spéciale, cet ID de la commande (orderID) est envoyé à l'acquéreur comme référence (ref2) pour la transaction. Dans ce cas, le commerçant reçoit ce champ ref2 sur ses relevés de compte, ce qui l'aide à rapprocher ses transactions. 
Bien que notre système puisse accepter jusqu'à 30 caractères, la norme pour la plupart des acquéreurs est 10 ou 12. La longueur acceptée et le format de validation des données dépend de l'acquéreur/la banque. Si l'ID de la commande (orderID) n'est pas conforme aux règles ref2 définies par l'acquéreur, nous lui envoyons notre PAYID comme ref2.

Évitez d'utiliser des espaces ou des caractères spéciaux dans l'orderID.
Oui Non AN 40 Order_789
Alias.StorePermanently Indicate whether you want to store an alias temporarily or indefinitely.

The possible values are:

N: the alias will be deleted after 2 hours

Y: the alias will be stored indefinitely for future use

This parameter can only be used when Alias Gateway and Alias Manager are used together.
Oui Non AN 1 Y or N
ALIASOPERATION Indique qui décide/définit le nom d'alias, le commerçant ou notre système.

Valeurs possibles : BYMERCHANT ou BYPSP
Oui Non AN 10 BYPSP
ALIASPERSISTEDAFTERUSE Indicate whether you want to store an alias temporarily or indefinitely.

The possible values are:

N: the alias will be deleted after 2 hours

Y: the alias will be stored indefinitely for future use

This parameter can only be used when Alias Gateway and Alias Manager are used together.
Oui Non 1 Y or N
ALIASUSAGE Brève explication destinée au client sur les raisons pour lesquelles vous suggérez la création d'un alias. Pour le client, le texte s'affichera en mode e-Commerce. Oui Non AN 255 Monthly subscription to lf World.
AMOUNT Montant de la transaction.

Si le montant est envoyé comme entrée, il doit être multiplié par 100 pour éviter les problèmes provoqués par les séparateurs décimaux.
En général, l'acquéreur accepte jusqu'à 2 décimales, selon la devise.
Oui Oui N 15 Sent: 12995 Returned: 129.95
AUTHORIZATION CODE (* 100 pour éviter les décimales). Oui Non AN 10 A437956
AUTHORIZATION DATE

Voir Code d'autorisation. Date/heure auxquelles vous recevez le code d'autorisation.

Oui Non MM/DD/YY HH:MM:SS 17 03/15/08 16:07:12
AUTHORIZATION MODE Voir Code d'autorisation. La manière dont vous recevez le code d'autorisation.

Valeur possible :
« TEL » pour téléphone
Oui Non AN 3 TEL
BACKURL URL de la page web à afficher au client s'il clique sur le bouton Retour dans notre page de paiement sécurisé. Oui Non AN 200 http://www.myshop.com/selectPM.html
BGCOLOR Couleur de fond sur la page de paiement. Oui Non AN N/A Blue #0000FF
BIC Code banque (utilisé dans le cadre des transactions de prélèvement automatique) Oui Oui 11 GEBABEBB36A
BIN 6 premiers chiffres d'un numéro de carte de crédit. Peut être utilisé pour identifier la marque et la banque émettrice. Non Oui N 6 444444
BRAND

Marque d'une carte de crédit/débit/d'achat.

Vous pouvez consulter une liste des valeurs BRAND sur la page Support > Manuels de l’utilisateur et d’intégration > Guides techniques > Payment Methods Processing/Procedures

Si vous envoyez le champ BRAND sans envoyer une valeur dans le champ PM (« Carte de crédit » ou « Carte d'achat », la valeur BRAND ne sera pas prise en compte.

Oui Oui AN 25 VISA
browserAcceptHeader Exact content of the HTTP accept headers as sent to the merchant from the Cardholder’s browser.
If the total length of the accept header sent by the browser exceeds 2048 characters, the 3DS Server truncates the excess portion
Oui Non AN 2048
browserColorDepth Value representing the bit depth of the color palette for displaying images, in bits per pixel. Obtained from Cardholder browser using the screen color Depth property.
Values accepted:
1 = 1 bit
4 = 4 bits
8 = 8 bits
15 = 15 bits
16 = 16 bits
24 = 24 bits
32 = 32 bits
48 = 48 bits
Oui Non AN 2 1
browserJavaEnabled Boolean that represents the ability of the cardholder browser to execute Java. Value is returned from the navigator java Enabled property (possible values TRUE or FALSE). Oui Non A 5 TRUE
browserLanguage Value representing the browser language as defined in IETF BCP47. Returned from navigator language property. Oui Non AN 8 en
browserScreenHeight Total height of the Cardholder’s screen in pixels. Value is returned from the screen height property. Between 0 and 999999 Oui Non AN 6 1024
browserScreenWidth Total width of the cardholder’s screen in pixels. Value is returned from the screen width property Between 0 and 999999 Oui Non AN 6 1024
browserTimeZone Time difference between UTC time and the Cardholder browser local time, in minutes between -840 and 720 Oui Non AN 3 -840
browserUserAgent Exact content of the HTTP user-agent header.
Note: If the total length of the User- Agent sent by the browser exceeds 2048 characters, the 3DS Server truncates the excess portion.
Oui Non AN 2048
BUTTONBGCOLOR Couleur de fond du bouton sur la page de paiement. Oui Non AN N/A Black #000000
BUTTONTXTCOLOR Couleur du texte du bouton sur la page de paiement. Oui Non AN N/A White #FFFFFF
CANCELURL URL de la page web à afficher au client quand il annule le paiement. Oui Non AN 200 http://www.myshop.com/cancel.html
Card.Brand Marque d'une carte de crédit/débit/d'achat.

Vous pouvez consulter une liste des valeurs BRAND sur la page @STARTURL@https://secure.ogone.com/NCol/$environment$/PM_process_procedure.asp?@TXTURL@Procédure/Traitement des modes de paiement@ENDURL@

Si vous envoyez le champ BRAND sans envoyer une valeur dans le champ PM (« Carte de crédit » ou « Carte d'achat », la valeur BRAND ne sera pas prise en compte.
Oui Non AN 25 Visa
Card.PaymentMethod

Mode de paiement.

Vous pouvez consulter une liste des valeurs PM sur Support > Manuels de l’utilisateur et d’intégration > Guides techniques > Payment Methods Processing/Procedures

Oui Non AN 26 CreditCard
CARDNO Numéro de carte ou numéro de compte.

Les règles de masquage des numéros de cartes de crédit par notre système - dans toute sortie, affichage ou e-mail - sont définies par PCI.

Pour VISA, VISA PC, MASTERCARD, MASTERCARD PC et MASTERCARD PC CM CIC, les 4 derniers chiffres sont visibles.

Pour toutes les autres marques/modes de paiement, la partie masquée dépend de la longueur du numéro de carte ou de compte :

Si le numéro comporte plus de 15 chiffres : les 6 premiers et les 2 derniers chiffres sont visibles, avec xxxxxxxx (8x) au milieu.
Si le numéro comporte entre 12 et 15 chiffres : les 4 premiers et les 2 derniers chiffres sont visibles, avec xxxxxxxx (6x) au milieu.
Si le numéro comporte entre 8 et 11 chiffres : les 2 premiers et les 2 derniers chiffres sont visibles, avec xxxxxxxx (4x) au milieu.
Si le numéro comporte entre 4 et 7 chiffres : le premier et le dernier chiffres sont visibles, avec xx (2x) au milieu.
Si le numéro comporte moins de 4 chiffres, il est totalement masqué.

Le numéro de compte n'est jamais visible pour le virement bancaire hors ligne et le paiement à la livraison.

Le numéro de compte pour les transactions avec prélèvement automatique est masqué quand la transaction a le statut 4 - commande enregistrée, si l'acheteur doit envoyer un fax signé pour confirmer le paiement.
Oui Oui AN 21 XXXXXXXXXXXX1111
CATALOGURL URL du catalogue du commerçant. Oui Non AN 200 http://www.myshop.com/shop.html
CAVV_3D Valeur de vérification de la carte du titulaire (CAAV) Il s’agit d’un cryptogramme obtenu de l’émetteur pendant l’authentification du paiement qui prouve les résultats de l’authentification du paiement pendant la transaction. Non Oui AN 300
CAVVALGORITHM_3D L’algorithme qui a été utilisé pour générer le CAVV. Non Oui N 1 5
CCCTY Pays dans lequel la carte a été émise, en valeurs de code ISO 3166-1-alpha-2 (http://www.iso.org/iso/country_codes/iso_3166_code_lists.htm). Si ce paramètre n'est pas disponible, « 99 » est renvoyé dans la réponse.

Cette vérification du pays d'émission de la carte de crédit repose sur des listes fournies en externe, il existe donc un léger risque puisque nous nous fions à leur exactitude. La vérification donne des résultats positifs dans 94 % des cas.
Non Oui AN 2 US
CH_AUTHENTICATION_INFO Paramètre de retour d information 3DSv2. Fournit des informations détaillées sur les émetteurs de vos clients lorsqu ils refusent les transactions de vos clients. Notez que tous les émetteurs ne communiquent pas les raisons pour lesquelles ils refusent des transactions. Par conséquent, dans certains cas, CH_AUTHENTICATION_INFO est vide Non Oui AN 128 Please contact your bank for further information.
CIVILITY Civilité du client (M, Mme, Mlle, etc.) Oui Non AN 5 Mr.
CN Nom du titulaire de la carte (client).

Les caractères spéciaux sont autorisés, mais il faut éviter les guillemets. La plupart des acquéreurs ne vérifient pas le nom de client puisque les noms peuvent être écrits de différentes manières.
Oui Oui AN Min. 2 - Max. 35 John Doe
COF_INITIATOR Credential-on-file initiator
Valeurs possibles:
CIT: Une transaction initiée par un titulaire de carte.@br@MIT: Une transaction initiée par un marchand.
Plus d’information disponible dans nos guides e-Commerce et DirectLink.
Les valeurs par défaut sont sélectionnées si vous n’ajoutez aucun paramètre. Cependant si vous souhaitez les modifier vous pouvez changer ces valeurs par défaut en envoyant les nouveaux paramètres.
Exemples:
S’applique en cas d’utilisation d’un Alias ou lors de sa création:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = UNSCHED
S’applique à un premier paiement planifié / abonnement:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = SCHED
S’applique aux transactions récurrentes non planifiées en cas d’utilisation d’un Alias ou lors de sa création:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = UNSCHED
S’applique aux paiements échelonnés:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
Oui Non 3 CIT,MIT
COF_SCHEDULE Credential-on-file planifiée ou non planifiée
Valeurs possibles:
SCHED: Une transaction planifiée.
UNSCHED: Une transaction non planifiée.
Plus d’information disponible dans nos guides e-Commerce et DirectLink.
Les valeurs par défaut sont sélectionnées si vous n’ajoutez aucun paramètre. Cependant si vous souhaitez les modifier vous pouvez changer ces valeurs par défaut en envoyant les nouveaux paramètres.
Exemples:
S’applique en cas d’utilisation d’un Alias ou lors de sa création:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = UNSCHED
S’applique à un premier paiement planifié / abonnement:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = SCHED
S’applique aux transactions récurrentes non planifiées en cas d’utilisation d’un Alias ou lors de sa création:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = UNSCHED
S’applique aux paiements échelonnés:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = SCHED
Oui Non 7 SCHED,UNSCHED
COF_TRANSACTION

Credential-on-file transaction
Valeurs possibles:
FIRST: Première transaction d’une série de transactions.
SUBSEQ: Transactions suivantes d’une série de transactions.
Plus d’information disponible dans nos guides e-Commerce et DirectLink.
Les valeurs par défaut sont sélectionnées si vous n’ajoutez aucun paramètre. Cependant si vous souhaitez les modifier vous pouvez changer ces valeurs par défaut en envoyant les nouveaux paramètres.
Exemples:
S’applique en cas d’utilisation d’un Alias ou lors de sa création:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = UNSCHED
S’applique à un premier paiement planifié / abonnement:
COF_INITIATOR = CIT
COF_TRANSACTION = FIRST
COF_SCHEDULE = SCHED
S’applique aux transactions récurrentes non planifiées en cas d’utilisation d’un Alias ou lors de sa création:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = UNSCHED
S’applique aux paiements échelonnés:
COF_INITIATOR = MIT
COF_TRANSACTION = SUBSEQ
COF_SCHEDULE = SCHED

Oui Non 5 FIRST,SUBSEQ
COM Description de la commande

Le champ com est parfois transmis à l'acquéreur (en fonction de l'acquéreur), pour figurer sur les relevés de compte du commerçant ou du client.
Oui Non AN 100 Three telephone cards
COMPLUS Champ permettant de soumettre une valeur que vous souhaitez recevoir dans la demande de retour d'informations ou la sortie.

COMPLUS est différent de « com » en ce sens que le champ COMPLUS est plus long. Les infos COMPLUS, cependant, ne sont pas affichées dans le Back Office.
Peut être utilisé pour revenir aux informations sur la session, au contenu de la commande ou aux informations sur l'utilisateur après la transaction.
Oui Oui AN 1000 Three telephone cards
CREDITCODE

Code indiquant les modalités de paiement d'une méthode de paiement. Ce paramètre n'est utilisé qu'avec des méthodes de paiement spécifiques (reprises dans les guides dédiés)

Oui Non N 3 001
CUID

L'identifiant unique du client (CUI) est un identifiant affecté par le commerçant à son client. Ce peut être un nom, un numéro client, une adresse e-mail, etc.

Oui Non AN 50 2014101512366
CURRENCY Devise de la transaction.

Devise du montant exprimée dans le code ISO alphabétique disponible sur http://www.currency-iso.org/iso_index/iso_tables/iso_tables_a1.htm

Les devises acceptées sur notre plate-forme sont les suivantes : AED, ANG, ARS, AUD, AWG, BGN, BRL, BYR, CAD, CHF, CNY, CZK, DKK, EEK, EGP, EUR, GBP, GEL, HKD, HRK, HUF, ILS, ISK, JPY, KRW, LTL, LVL, MAD, MXN, NOK, NZD, PLN, RON, RUB, SEK, SGD, SKK, THB, TRY, UAH, USD, XAF, XOF, XPF et ZAR

Si un commerçant souhaite accepter des paiements dans une devise ne figurant pas dans notre liste, il peut nous demander de l'ajouter.

Les devises qu'un commerçant peut accepter pour les paiements dépendent du contrat avec son acquéreur.

Si le commerçant veut accepter une devise qui n'est pas prise en charge par son acquéreur, nous pouvons de notre côté mettre en place une conversion dynamique de devise (c'est une option payante).
Oui Oui AN 3 EUR
CVC Code de validation de carte. Ce code de vérification est un code d'authentification lié de manière unique au numéro de carte, mais ne faisant pas partie du numéro de carte lui-même. Selon la marque, ce code porte un nom différent (CVC2 ou Code de validation de carte (Card Validation Code) pour MasterCard, CVV2 ou Valeur de vérification de carte (Card Verification Value) pour VISA, CID ou Numéro d'identification de carte (Card Identification Number) pour American Express). Mais il est généralement fait référence à ce code sous le nom de « CVC ».
Selon la marque de la carte, le code de vérification comporte 3 ou 4 chiffres inscrits au recto ou au verso de la carte, un numéro d'émission, une date de début ou une date de naissance :

VISA et MasterCard : code à 3 chiffres au verso de la carte sur l'emplacement réservé à la signature (après le numéro de compte complet du client ou après les 4 derniers chiffres du numéro de compte du client).

American Express : code à 4 chiffres au-dessus du numéro de compte au recto de la carte.

Aurora, Aurore et Cofinoga : date de naissance (JJ/MM/AAAA ou JJMMAAAA).
Oui Non N 5 758
CVCCHECK Résultat du contrôle du code de vérification de carte. Seuls quelques acquéreurs retournent les résultats du contrôle CVC spécifique. Pour la plupart des acquéreurs, le CVC est supposé correct si la transaction est autorisée.

Valeurs possibles :

KO : le CVC a été envoyé mais l'acquéreur a retourné une réponse négative pour la vérification du CVC, autrement dit le CVC est erroné.
OK : le CVC a été envoyé et l'acquéreur a retourné une réponse positive à la vérification du CVC, autrement dit le CVC est correct OU
L'acquéreur a envoyé un code d'autorisation, mais n'a pas retourné de résultat spécifique pour la vérification du CVC.
NO : Tous les autres cas. Par exemple, aucun CVC transmis ; l'acquéreur a répondu qu'une vérification du CVC était impossible ; l'acquéreur a refusé l'autorisation mais n'a pas fourni un résultat spécifique pour la vérification du CVC, etc.
Non Oui AN 2 OK
DATATYPE La valeur est TRAVEL si vous fournissez des données de voyage à notre système et ce champ est obligatoire. Oui Non AN 6 TRAVEL
DATEIN date d'arrivée Oui Non dd/MM/yyyy 10 40658
DATEOUT date de départ Oui Non dd/MM/yyyy 10 40659
DCC_COMMPERCENTAGE Pourcentage de commission eDCC Non Oui N
DCC_CONVAMOUNT Montant converti eDCC Non Oui N
DCC_CONVCCY Devise de destination eDCC Non Oui AN 3 EUR
DCC_EXCHRATE Taux de change eDCC Non Oui N
DCC_EXCHRATESOURCE Source eDCC du taux de conversion Non Oui N 50
DCC_EXCHRATETS Horodatage eDCC du taux de conversion Non Oui N
DCC_INDICATOR Indicateur eDCC Non Oui N
DCC_MARGINPERCENTAGE Pourcentage de marge eDCC Non Oui N
DCC_VALIDHOURS Validité eDCC (en heures) du taux de conversion, à partir de la date/heure définie dans DCC_EXCHRATETS Non Oui N
DECLINEURL URL de la page web à afficher au client quand l'acquéreur rejette l'autorisation plus de fois que le maximum de tentatives autorisées (10 par défaut, mais ce nombre peut être modifié dans la page Informations techniques). Oui Non AN 200 http://www.myshop.com/decline.html
DEVICE Pour afficher une page de paiement adaptée aux appareils mobiles, envoyez la valeur « mobile » (uniquement avec les modes de paiement Paypal, Postfinance et Bancontact/Mister Cash). Oui Non AN 6 mobile
DIGESTCARDNO Condensat SHA du numéro de carte utilisé pendant la transaction Non Oui AN 128 68BFB396F35AF3876FC509665B3DC23A0930AAB1
ECI Indicateur de commerce électronique (Electronic Commerce Indicator ou ECI). L'ECI indique le niveau de sécurité auquel les informations de paiement sont traitées entre le titulaire de la carte et le commerçant.

Vous pouvez définir une valeur ECI par défaut dans la page Informations techniques. Une valeur ECI envoyée dans la transaction annule la valeur ECI par défaut.

Il incombe au commerçant de fournir les valeurs ECI correctes pour les transactions. Pour l'e-Commerce, notre système définit une valeur ECI de 5, 6 ou 7 selon le résultat de l'authentification 3-D Secure.

Valeurs possibles :

0 - Lecture en machine (Swiped)

Le commerçant a glissé la carte de crédit du client dans une machine lisant les données de la bande magnétique de la carte.

1 - Saisie manuelle (Manually keyed) (MOTO) (carte non présente)

Le commerçant a reçu les informations financières du client par téléphone ou par fax/e-mail, mais n'a pas eu la carte du client entre les mains.

2 - Récurrent (à partir de MOTO)

La première transaction du client a été une commande par e-mail/téléphone, autrement dit le client a fourni ses informations financières par téléphone ou par e-mail/fax au commerçant. Le commerçant a stocké ces informations lui-même ou les a fait stocker dans notre système à l'aide d'un alias et il réalise une autre transaction pour le même client (transaction récurrente).

3 - Paiements à tempérament (Installment payments)

Paiement partiel de marchandises/services qui ont déjà été livrés, mais qui seront réglés en plusieurs versements échelonnés.

4 - Saisie manuelle (Manually keyed), carte présente

Le client est présent physiquement devant le commerçant. Le commerçant a la carte du client entre les mains. Les informations de la carte sont saisies manuellement, la carte n'est pas glissée dans une machine.

5 - L'identification du titulaire de la carte a réussi

L'identification 3-D Secure du titulaire de la carte, autrement dit l'authentification est complète. (Confirmation totale)

6 - Le commerçant prend en charge l'identification mais pas le titulaire de la carte, Le commerçant a un contrat 3-D Secure, mais la carte du titulaire n'est pas 3-D Secure ou est 3-D Secure mais le titulaire de la carte n'est pas encore en possession du code confidentiel (Confirmation partielle). Les règles de garantie de paiement conditionnelles s'appliquent .

7 - E-commerce avec cryptage SSL

Le commerçant a reçu les informations financières du client via un site web sécurisé (crypté SSL) (le site web du commerçant ou notre plate-forme sécurisée).

9 - Récurrent (de l'e-commerce)

La première transaction du client était une transaction e-Commerce, autrement dit, le client a saisi ses informations financières lui-même sur un site web sécurisé (le site web du commerçant ou notre plate-forme sécurisée). Le commerçant a stocké ces informations lui-même ou les a fait stocker dans notre système à l'aide d'un alias et il réalise une autre transaction pour le même client (transaction récurrente), à l'aide des informations de l'alias.
Oui Non N 2 4
ECI_3D

5: identification du titulaire de la carte réussie

6 : preuve de tentative d'authentification
12 : émetteur non participant
91 : L’identification du titulaire de la carte a échoué. La transaction est refusée (Statut 2)
92 : page ACS temporairement indisponible, mais continue quand même

Non Oui N 2 5
ECOM_BILLTO_POSTAL_CITY Ville de facturation Oui Non AN 25 Brussels
ECOM_BILLTO_POSTAL_COUNTRYCODE Pays de facturation Oui Non AN 2 BE
ECOM_BILLTO_POSTAL_COUNTY Invoicing county Oui Non AN 25 South Yorkshire (UK)
ECOM_BILLTO_POSTAL_NAME_FIRST Prénom du client facturé Oui Non AN 35 Bill
ECOM_BILLTO_POSTAL_NAME_LAST Nom du client facturé Oui Non AN 35 Smith
ECOM_BILLTO_POSTAL_POSTALCODE Code postal de facturation Oui Non AN 10 1200
ECOM_BILLTO_POSTAL_STREET_LINE1

Adresse de facturation, première ligne

Oui Non AN 60 Billing Street
ECOM_BILLTO_POSTAL_STREET_LINE2 Adresse de facturation, deuxième ligne Oui Non AN 35 Building 123
ECOM_BILLTO_POSTAL_STREET_NUMBER Numéro de maison de l'adresse de facturation Oui Non AN 10 1
ECOM_CONSUMER_GENDER Genre Oui Non AN (M or F) 1 F
ECOM_CONSUMERID Identification du client dans le système du commerçant. Oui Non AN 50 Customer1
ECOM_PAYMENT_CARD_VERIFICATION Voir « CVC ». Oui Non N 5 758
ECOM_SHIPMETHODDETAILS Identification du point de collecte Oui Non AN 50
ECOM_SHIPTO_COMPANY Delivery address: Company Oui Non AN 50 My Company
ECOM_SHIPTO_DOB

Date de naissance

Oui Non dd/MM/yyyy 10 01/01/2001
ECOM_SHIPTO_ONLINE_EMAIL Adresse électronique Oui Non AN 50 bill@smith.com
ECOM_SHIPTO_POSTAL_CITY Ville d'expédition Oui Non AN 25 Brussels
ECOM_SHIPTO_POSTAL_COUNTRYCODE Code du pays d'expédition Oui Non AN 2 BE
ECOM_SHIPTO_POSTAL_COUNTY Delivery county Oui Non AN 25 Bailey (US, TX)
ECOM_SHIPTO_POSTAL_NAME_FIRST Prénom du client expédié Oui Non AN 35 Bill
ECOM_SHIPTO_POSTAL_NAME_LAST Nom du client expédié Oui Non AN 35 Smith
ECOM_SHIPTO_POSTAL_NAME_PREFIX Préfixe du client expédié Oui Non AN 10 Mr.
ECOM_SHIPTO_POSTAL_POSTALCODE Code postal de l'expédition Oui Non AN 10 1200
ECOM_SHIPTO_POSTAL_STATE État (code ISO) de livraison Oui Non AN 2 CA (California)
ECOM_SHIPTO_POSTAL_STREET_LINE1 Adresse d'expédition, première ligne Oui Non AN 35 Ship street
ECOM_SHIPTO_POSTAL_STREET_LINE2 Adresse d'expédition, deuxième ligne Oui Non AN 35 Building 2
ECOM_SHIPTO_POSTAL_STREET_NUMBER Numéro de maison de l'adresse d'expédition Oui Non AN 10 2
ECOM_SHIPTO_TELECOM_FAX_NUMBER Numéro de fax de l'adresse d'expédition Oui Non AN 20 +32 2 123 4567
ECOM_SHIPTO_TELECOM_PHONE_NUMBER Numéro de téléphone de l'adresse d'expédition Oui Non AN 20 +32 2 123 456
ED

Date d'expiration. Cette date ne doit pas être antérieure à la date de traitement de la transaction dans notre système.

Si aucune date d'expiration n'est disponible (par exemple pour les virements bancaires), la valeur 9999 est utilisée.

Oui Oui Input: MM/YY or MMYY Output: MMYY 7 1224
EMAIL Adresse électronique du client. Si vous faites une demande de 3DSv2.1, assurez-vous que le format d’email soit valide. Dans le cas contraire, l’authentification client forte utilisera le protocole 3DSv1.0. Oui Non AN 50 John.Doe@test.com
EXCEPTIONURL URL de la page web à afficher au client quand le résultat du paiement est incertain. Oui Non AN 200 http://www.myshop.com/exception.html
EXCLPMLIST Liste des modes de paiement qui ne doivent PAS être affichés sur la page de paiement Oui Non AN 500 VISA;MasterCard;American Express
FLAG3D Valeur fixe : « Y » Demande à notre système d'effectuer une identification 3-D Secure si nécessaire. Oui Non AN 1 Y
FONTTYPE Type/famille de police utilisé sur la page de paiement. Oui Non AN N/A Arial
GLOBORDERID La référence de la commande globale regroupant plusieurs commandes vous permet de demander ultérieurement une opération de maintenance sur l'ensemble de ces transactions. Oui Non AN 15 neworders15
HOMEURL URL de la page d'accueil du commerçant. Oui Non AN 200 http://www.myshop.com
HTML_ANSWER Code html encodé BASE64 à ajouter dans la page html retournée au client.
Cette balise est ajoutée en tant qu'enfant du XML de la balise globale . Le champ HTML_ANSWER contient le code HTML qui doit être ajouté dans la page html retournée au client du navigateur.
Ce code charge automatiquement la page d'identification de la banque émettrice dans un menu contextuel de la fenêtre principale, en fonction de la valeur du paramètre WIN3DS.
Pour éviter toute interférence entre les balises html incluses dans le contenu HTML_ANSWER de la balise XML, avec le reste du XML retourné en réponse à la demande DirectLink, le contenu HTML_ANSWER est encodé BASE64 par notre système avant de retourner la réponse. En conséquence, il doit être décodé BASE64 avant d'être inclus dans la page html envoyée au titulaire de la carte.
Non Oui AN N/A
HTTP_ACCEPT Champ d'en-tête de la demande d'acceptation dans le navigateur du titulaire de la carte, utilisé pour spécifier certains types de supports acceptables pour la réponse. Cette valeur est utilisée par l'émetteur pour vérifier si le navigateur du titulaire de la carte est compatible avec son système d'identification. Oui Non AN 500 Accept: */*
HTTP_USER_AGENT Champ d'en-tête de la demande de l'User-Agent dans le navigateur du titulaire de la carte, contenant des informations sur l'User-Agent à l'origine de la demande. Cette valeur est utilisée par l'émetteur pour vérifier si le navigateur du titulaire de la carte est compatible avec son système d'identification. Oui Non AN 255 User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)
IP Adresse IP du client qui est détectée par notre système dans une intégration de niveau 3 ou qui nous est envoyée par le marchand dans une intégration de niveau 2. Oui Oui AN 20 192.168.1.1
IPCTY Pays d'origine de l'adresse IP, en valeurs de code ISO 3166-1-alpha-2 (http://www.iso.org/iso/country_codes/iso_3166_code_lists.htm). Si ce paramètre n'est pas disponible, « 99 » est retourné dans la réponse.

Il existe 4 codes IP spécifiques faisant référence aux adresses IP pour lesquelles le pays d'origine est incertain :

  • A1 : Proxy anonyme. Les proxies anonymes sont des fournisseurs d'accès Internet qui autorisent les utilisateurs web à masquer leur adresse IP.
  • AP : région Asie Pacifique
  • EU : réseau européen
  • A2 : fournisseurs d'accès satellite

Le contrôle IP s'appuie sur des listes IP fournies en externes, il existe donc un léger risque puisque nous nous fions à leur exactitude. La vérification donne des résultats positifs dans 94 % des cas.
Non Oui AN 2 UK
ISSUERID Pour pré-sélectionner une banque pour une transaction iDEAL correspondant au BIC de la banque. Oui Non N 10 ABNANL2A
ITEMATTRIBUTES*XX* Attributs de l'article
remplace *XX* par un nombre pour soumettre plusieurs articles
Oui Non AN 50
ITEMCATEGORY*XX* Catégorie de l'article
remplace *XX* par un nombre pour soumettre plusieurs articles
Oui Non AN 50
ITEMCOMMENTS*XX* Commentaires sur l'article
remplace *XX* par un nombre pour soumettre plusieurs articles
Oui Non AN 255
ITEMDESC*XX* Description de l'article
remplace *XX* par un nombre pour soumettre plusieurs articles
Oui Non AN 16
ITEMDISCOUNT*XX* Remise sur l'article
remplace *XX* par un nombre pour soumettre plusieurs articles
Oui Non N
ITEMID*XX* Identifiant de l'article
remplace *XX* par un nombre pour soumettre plusieurs articles
Oui Non AN 15
ITEMNAME*XX* Nom de l'article
remplace *XX* par un nombre pour soumettre plusieurs articles
Oui Non AN 40
ITEMPRICE*XX* Prix de l'article
remplace *XX* par un nombre pour soumettre plusieurs articles
Oui Non N
ITEMQUANT*XX* Quantité d'articles
remplace *XX* par un nombre pour soumettre plusieurs articles
Oui Non N
ITEMQUANTORIG*XX* Quantité maximum par article Oui Non N
ITEMUNITOFMEASURE*XX* Unité de mesure de l'article (à utiliser conjointement à ITEMWEIGHT*XX*) Oui Non AN 50
ITEMVAT*XX* Montant TVA de l'article Oui Non N
ITEMVATCODE*XX* Code TVA de l'article Oui Non N
ITEMWEIGHT*XX* Poids de l'article Oui Non N
LANGUAGE Langues actuellement proposées à l'acheteur (titulaire de la carte/titulaire du compte) pour la page de paiement.

Le format est « language_Country ».
La valeur de langue utilise la norme ISO 639-1.
La valeur de pays utilise la norme ISO 3166-1.

Langue par défaut utilisée si aucune valeur de langue n'est envoyée ou si la langue envoyée n'est pas valide :
en_US (anglais)

Autres langues disponibles :
ar_AR (arabe)
cs_CZ (tchèque)
da_DK (danois)
de_DE (allemand)
el_GR (grec)
es_ES (espagnol)
fi_FI (finnois)
fr_FR (français)
he_IL (hébreu)
hu_(HU hongrois)
it_IT (italien)
ja_JP (japonais)
ko_KR (coréen)
nl_BE (flamand)
nl_NL (néerlandais)
no_NO (norvégien)
pl_PL (polonais)
pt_PT (portugais)
ru_RU (russe)
se_SE (suédois)
sk_SK (slovaque)
tr_TR (turc)
zh_CN (chinois simplifié)
Oui Non AN 5 fr_FR
Layout.Language Langues actuellement proposées à l'acheteur (titulaire de la carte/titulaire du compte) pour la page de paiement.

Le format est « language_Country ».
La valeur de langue utilise la norme ISO 639-1.
La valeur de pays utilise la norme ISO 3166-1.

Langue par défaut utilisée si aucune valeur de langue n'est envoyée ou si la langue envoyée n'est pas valide :
en_US (anglais)

Autres langues disponibles :
ar_AR (arabe)
cs_CZ (tchèque)
da_DK (danois)
de_DE (allemand)
el_GR (grec)
es_ES (espagnol)
fi_FI (finnois)
fr_FR (français)
he_IL (hébreu)
hu_(HU hongrois)
it_IT (italien)
ja_JP (japonais)
ko_KR (coréen)
nl_BE (flamand)
nl_NL (néerlandais)
no_NO (norvégien)
pl_PL (polonais)
pt_PT (portugais)
ru_RU (russe)
se_SE (suédois)
sk_SK (slovaque)
tr_TR (turc)
zh_CN (chinois simplifié)
Oui Non AN 5 en_US
LOGO Logo à afficher sur la page de paiement. Oui Non AN N/A myshoplo.gif or https://www.myshop.com/myshoplo.gif
MANDATEID Prélèvements automatiques DE/NL : Référence unique du mandat Oui Oui AN 35
Mpi. provisionAttemptsInTheLast24Hours

Number of Add Card
attempts in the last 24 hours.
Between 0 and 999

Oui Non AN 3 10
Mpi.cardholderAccountAgeIndicator

Cardholder Account Age Indicator
Card holder account" is a client account a card holder registered with a 3DS requestor (e.g. at a merchant's homepage) while the "payment account" is the cardholder’s account with the issuer. The "card holder account” refers to the payment card number which is defined by ISO/IEC 7812.

Length of time that the cardholder has had the account with the merchant.
01 = No account (guest check-out)
02 = Created during this transaction
03 = Less than 30 days
04 = 30−60 days
05 = More than 60 days

"
Oui Non AN 2 1
Mpi.cardholderAccountChange

Cardholder Account Change
Card holder account is a client account a card holder registered with a 3DS requestor (e.g. at a merchant's homepage) while the payment account is the cardholder's account with the issuer. The card holder account” refers to the payment card number which is defined by ISO/IEC 7812.

Date that the cardholder's account with the merchant was last changed including Billing or Shipping address, new payment account or new user(s) added.

Oui Non YYYYMMDD 8 20190101
Mpi.cardholderAccountChangeIndicator

Card holder account is a client account a card holder registered with a 3DS requestor (e.g. at a merchant's homepage) while the payment account is the cardholder's account with the issuer. The card holder account” refers to the payment card number which is defined by ISO/IEC 7812.

01 = Changed during this transaction
02 = Less than 30 days
03 = 30−60 days
04 = More than 60 days

Oui Non AN 2 1
Mpi.cardholderAccountDate

Card holder account is a client account a card holder registered with a 3DS requestor (e.g. at a merchant's homepage) while the payment account is the cardholder's account with the issuer. The card holder account refers to the payment card number which is defined by ISO/IEC 7812.

Date that the cardholder opened the account with the merchant.

Oui Non YYYYMMDD 8 20190101
Mpi.cardholderAccountPasswordChangeIndicator

Card holder account is a client account a card holder registered with a 3DS requestor (e.g. at a merchant's homepage) while the payment account is the cardholder's account with the issuer. The card holder account refers to the payment card number which is defined by ISO/IEC 7812.

Date that the cardholder opened the account with the merchant.

Indicates the length of time since the cardholder's account with the merchant had a password change or account reset.

Length: 2 characters Data Type: String Values accepted:
01 = No change
02 = Changed during this transaction
03 = Less than 30 days
04 = 30−60 days
05 = More than 60 days

Oui Non AN 2 1
Mpi.challengeWindowSize

Dimensions of the challenge window that has been displayed to the Cardholder. The ACS shall reply with content that is formatted to appropriately render in this window to provide the best possible user experience. Preconfigured sizes are width x height in pixels of the window displayed in the Cardholder browser window.
01 = 250 x 400
02 = 390 x 400
03 = 500 x 600
04 = 600 x 400
05 = Full screen

Oui Non AN 2 01
Mpi.deliveryEmailAddress For Electronic delivery, the email address to which the merchandise was delivered. Oui Non AN 254 example@example.com
Mpi.deliveryTimeframe

Indicates the merchandise delivery timeframe.
01 = Electronic Delivery
02 = Same day shipping
03 = Overnight shipping
04 = Two-day or more shipping

Oui Non AN 2 01
Mpi.giftCardAmount For prepaid or gift card purchase, the purchase amount total of prepaid or gift card(s) in major units (for example, USD 123.45 is 123). Between 0 and 999999999999999 Oui Non AN 15 123
Mpi.giftCardCount For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased. Between 0 and 99 Oui Non AN 2 10
Mpi.giftCardCurrency For prepaid or gift card purchase, the currency code of the card as defined in ISO 4217 Oui Non AN 3 USD
Mpi.HomePhone.countryCode Country code of a home phone
ITU-E.164 country code
Oui Non AN 3 55
Mpi.HomePhone.subscriber Home phone (without country code) Oui Non AN 15 1234
Mpi.merchantFraudRate Merchant Fraud Rate in the EEA (all EEA card fraud divided by all EEA card volumes) calculated as per PSD2 Regulatory Technical Standards (RTS).
Make sure to calculate the rate according to PSD2 RTS Article 19 regulation, as neither MasterCard nor we will validate the score.
Values accepted:
1 (represents fraud rate less than or equal to 1 basis point [bp], which is 0.01%)
2 (represents fraud rate between 1 bp + - and 6 bps)
3 (represents fraud rate between 6 bps + - and 13 bps)
4 (represents fraud rate between 13 bps + - and 25 bps)
5 (represents fraud rate greater than 25 bps)
Oui Non AN 2 1
Mpi.MobilePhone.countryCode Country code of a mobile phone
ITU-E.164 country code
Oui Non AN 3 55
Mpi.MobilePhone.subscriber Mobile phone (without country code) Oui Non AN 15 1234
Mpi.numberOfPurchaseWithAccountInTheLastSixMonths

Card holder account is a client account a card holder registered with a 3DS requestor (e.g. at a merchant's homepage) while the payment account is the cardholder's account with the issuer. The card holder account refers to the payment card number which is defined by ISO/IEC 7812.

Date that the cardholder opened the account with the merchant.

Number of purchases with this cardholder account during the previous six months. Between 0 and 9999

Oui Non AN 4 10
Mpi.paymentAccountAge

Card holder account is a client account a card holder registered with a 3DS requestor (e.g. at a merchant's homepage) while the payment account is the cardholder's account with the issuer. The card holder account refers to the payment card number which is defined by ISO/IEC 7812.

Date that the cardholder opened the account with the merchant.

Date that the payment account was enrolled in the cardholder’s account with the merchant.

Oui Non YYYYMMDD 8 20190101
Mpi.paymentAccountAgeIndicator

Card holder account is a client account a card holder registered with a 3DS requestor (e.g. at a merchant's homepage) while the payment account is the cardholder's account with the issuer. The card holder account refers to the payment card number which is defined by ISO/IEC 7812.

Date that the cardholder opened the account with the merchant.

Indicates the length of time that the payment account was enrolled in the cardholder's account with the merchant.
01 = No account (guest check-out)
02 = During this transaction
03 = Less than 30 days
04 = 30−60 days
05 = More than 60 days

Oui Non AN 2 1
Mpi.preOrderDate For a pre-ordered purchase, the expected date that the merchandise will be available. Oui Non YYYYMMDD 8 20190101
Mpi.preOrderPurchaseIndicator

Indicates whether Cardholder is placing an order for merchandise with a future availability or release date.
01 = Merchandise available
02 = Future availability

Oui Non AN 2 01
Mpi.reorderItemsIndicator

Indicates whether the cardholder is reordering previously purchased merchandise.
01 = First time ordered
02 = Reordered

Oui Non AN 2 01
Mpi.secureCorporatePayment Secure Corporate Payment
Indicates that dedicated payment processes and procedures were used and that potential secure corporate payment exemption applies.
Send this field only with Y if the acquirer exemption field is blank, as acquirer exemption and secure payment are mutually exclusive.
However, the directory server (DS) will not validate the conditions in the extension. The DS will pass data as sent.
You can optionally indicate if they apply to the dedicated processes and protocols as per PSD2 RTS Article 17, which would potentially allow the issuer to claim the secure corporate payment exemption.
Value accepted: Y / N
Oui Non 1 Y
Mpi.shippingAddressUsage

Date when the shipping address used for this transaction was first used with the merchant.

Oui Non AN 8 20190101
Mpi.shippingAddressWasFirstUsed

Indicates when the shipping address used for this transaction was first used with the merchant.
01 = This transaction
02 = Less than 30 days
03 = 30−60 days
04 = More than 60 days

Oui Non AN 2 01
Mpi.shippingIndicator Indicates shipping method chosen for the transaction. Merchants must choose the Shipping Indicator code that most accurately describes the cardholder’s specific transaction, not their general business.
If one or more items are included in the sale, use the Shipping Indicator code for the physical goods, or if all digital goods, use the Shipping Indicator code that describes the most expensive item.
01 = Ship to cardholder’s billing address
02 = Ship to another verified address on file with merchant
03 = Ship to address that is different than the cardholder’s billing address
04 = Ship to Store / Pick-up at local store (Store address shall be populated in shipping address fields)
05 = Digital goods (includes online
06 = Travel and Event tickets not shipped
07 = Other (for example Gaming/ digital services not shipped/emedia subscriptions etc.)
Oui Non AN 2 1
Mpi.shippingNameAndCardholderNameAreIdentical Indicates if the Cardholder Name on the account is identical to the shipping Name used for this transaction (possible values TRUE or FALSE). Oui Non A 5 TRUE
Mpi.suspiciousAccountActivityDetected Indicates whether the merchant has experienced suspicious activity (including previous fraud) on the cardholder account (possible values TRUE or FALSE). Oui Non A 5 TRUE
Mpi.threeDSRequestorAuthenticationData Data that documents and supports a specific authentication process. In the current version of the specification, this data element is not defined in detail; however the intention is that for each merchant Authentication Method, this field carries data that the ACS can use to verify the authentication process. For example, for method:
02—field can carry generic merchant authentication information
03—data element can carry information about the provider of the federated ID and related information
04—data element can carry the FIDO attestation data (including the signature)
In future versions of the specification, these details are expected to be included
Oui Non AN 2048
Mpi.threeDSRequestorAuthenticationMethod

Mechanism used by the Cardholder to authenticate to the merchant.
occurred (i.e. cardholder logged in” as guest)
02 = Login to the cardholder account at the merchant system using merchant’s own credentials
03 = Login to the cardholder account at the merchant system using federated ID
04 = Login to the cardholder account at the merchant system using issuer credentials
05 = Login to the cardholder account at the merchant system using third- party authentication
06 = Login to the cardholder account at the merchant system using FIDO Authenticator
07–79 = Reserved for EMVCo future use (values invalid until defined by EMVCo)
80–99 = Reserved for DS use"

Oui Non AN 2 02
Mpi.threeDSRequestorAuthenticationTimestamp

Date and time in UTC of the cardholder authentication (format YYYYMMDDHHMMSS).

Oui Non Date/Time 14 20190101235959
Mpi.threeDSRequestorChallengeIndicator

Indicates whether a challenge is requested for this transaction. For example:
For 01-PA, a merchant may have concerns about the transaction, and request a challenge.
For 02-NPA, a challenge may
be necessary when adding a new card to a wallet.
For local/regional mandates or other variables.
• 01 = No preference
• 02 = No challenge requested
• 03 = Challenge requested: merchant Preference
• 04 = Challenge requested: Mandate
• 05–79 = Reserved for EMVCo future use (values invalid until defined by EMVCo)
• 80-99 = Reserved for DS use
Note: If the element is not provided, the expected action is that the ACS would interpret as 01 = No preference.

Oui Non AN 2 02
Mpi.threeDSRequestorPriorAuthenticationData Data that documents and supports a specific authentication process. In the current version of the specification, this data element is not defined in detail; however the intention is that for each merchant Authentication Method,these fields carry data that the ACS can use to verify the authentication process. Oui Non AN 2048
Mpi.threeDSRequestorPriorAuthenticationMethod

Mechanism used by the Cardholder to previously authenticate to the merchant.
01 = Frictionless authentication occurred by ACS
02 = Cardholder challenge occurred by ACS
03 = AVS verified
04 = Other issuer methods
05–79 = Reserved for EMVCo future use (values invalid until defined by EMVCo)
80–99 = Reserved for DS use

Oui Non AN 2 02
Mpi.threeDSRequestorPriorAuthenticationTimestamp

Date and time in UTC of the prior cardholder authentication (format YYYYMMDDHHMMSS).

Oui Non Date/Time 14 20190101235959
Mpi.threeDSRequestorPriorReference This data element provides additional information to the ACS to determine the best approach for handing a request.
This data element contains an ACS Transaction ID for a prior authenticated transaction (for example, the first recurring transaction that was authenticated with the cardholder).
Oui Non AN 36
Mpi.transactionActivityInTheLast24Hours Number of transactions (successful and abandoned) for this cardholder account with the merchant across all payment accounts in the previous 24 hours.
Between 0 and 999
Oui Non AN 3 10
Mpi.transactionActivityLastYear Number of transactions (successful and abandoned) for this cardholder account with the merchant across all payment accounts in the previous year.
Between 0 and 999
Oui Non AN 3 10
Mpi.transactionType

Identifies the type of transaction being authenticated.
01 = Goods/ Service Purchase
03 = Check Acceptance
10 = Account Funding
11 = Quasi-Cash Transaction
28 = Prepaid Activation and Load

Oui Non AN 2 01
Mpi.WorkPhone.countryCode Country code of a work phone ITU-E.164 country code Oui Non AN 3 55
Mpi.WorkPhone.subscriber Phone used for work purposes (without country code) Oui Non AN 15 1234
NCERROR

Code d'erreur.

Une liste avec les codes d'erreur est disponible via Support > Manuels de l’utilisateur et d’intégration > Guides d'utilisation > La signification des statuts des paiements et des codes d'erreur éventuels
La valeur de ce paramètre est 0 ou vide s'il n'est pas applicable.

Non Oui AN 10 30141001
NCERRORPLUS

Description de l'erreur du code NCERROR.

Une liste avec les descriptions est disponible via Support > Manuels de l’utilisateur et d’intégration > Guides d'utilisation > La signification des statuts des paiements et des codes d'erreur éventuels
La valeur de ce paramètre est 0 ou vide s'il n'est pas applicable.

Non Oui AN 255 Invalid card number
NCSTATUS Statut de l'erreur. En général, c'est le premier chiffre de NCERROR. Non Oui AN 4 3
OPERATION L'opération définit le type de la transaction demandée. La procédure de paiement configurée dans la page Informations techniques définit l'opération de la transaction par défaut pour une nouvelle commande.  Une valeur d'opération envoyée dans la transaction annule la valeur par défaut.

Valeurs possibles pour les nouvelles commandes :

RES : demande d'autorisation.
SAL : demande de vente directe (paiement), autrement dit une autorisation automatiquement suivie d'un paiement.
RFD : remboursement, non lié à un paiement précédent, donc pas d'opération de maintenance sur une transaction existante. (vous ne pouvez pas utiliser cette opération sans autorisation spécifique de la part de votre acquéreur)

Les valeurs possibles pour les opérations de maintenance sont les suivantes :

REN: renouvellement de l'autorisation, si l'autorisation originale n'est plus valide.
DEL : suppression de l'autorisation, ce qui laisse la transaction ouverte à la possibilité d'opérations de maintenance plus approfondies.
DES : suppression de l'autorisation, fermant la transaction après cette opération.
SAL : saisie partielle des données (paiement), ce qui laisse la transaction ouverte à la possibilité de saisie d'autres données.
SAS : (dernière) saisie de données partielle ou complète (paiement), fermant la transaction (pour d'autres saisies de données), après cette saisie de données.
RFD : remboursement partiel (sur une facture payée), ce qui laisse la transaction ouverte à la possibilité d'un autre remboursement.
RFS : (dernière) saisie de données partielle ou complète (sur une facture payée), fermant la transaction après ce remboursement.

Les dernières (ou seules) opérations modifient le statut global de la transaction, tandis que les opérations partielles ne le font pas.

PAU: demande de pré-autorisation:

En accord avec votre acquéreur vous pouvez utiliser ce code d’opération pour réserver temporairement des fonds sur la carte d’un client.

Si vous deviez pré-autoriser des transactions avec des acquéreurs ou des types de carte qui ne supportent pas la pré-autorisation, ces transactions ne seraient pas bloquées, mais traitées comme des autorisations classiques (RES).

La pré-autorisation ne peut pas être défini comme valeur par défaut dans votre compte Ingenico.
Oui Non A 3 RFD
ORDERID Votre numéro de commande (référence du commerçant).

Cette référence est généralement utilisée par le commerçant pour consulter sa transaction dans le Back Office.
Pour le mode à 3 niveaux, en ligne, le système utilise aussi cette référence pour vérifier qu'un paiement n'est pas demandé deux fois pour la même commande. À la demande du commerçant, cette période de vérification peut être réduite ou la vérification désactivée.

Si l'acquéreur est techniquement capable de traiter la transaction, et si le compte ne contient aucune configuration spéciale, cet ID de la commande (orderID) est envoyé à l'acquéreur comme référence (ref2) pour la transaction. Dans ce cas, le commerçant reçoit ce champ ref2 sur ses relevés de compte, ce qui l'aide à rapprocher ses transactions. 
Bien que notre système puisse accepter jusqu'à 30 caractères, la norme pour la plupart des acquéreurs est 10 ou 12. La longueur acceptée et le format de validation des données dépend de l'acquéreur/la banque. Si l'ID de la commande (orderID) n'est pas conforme aux règles ref2 définies par l'acquéreur, nous lui envoyons notre PAYID comme ref2.

Évitez d'utiliser des espaces ou des caractères spéciaux dans l'orderID.
Oui Oui 40 AB5456CB896
ORDERSHIPCOST ! Oui Non AN 10
ORDERSHIPTAXCODE ! Oui Non AN 10
OWNERADDRESS Adresse du client. Oui Non AN 35 102 First Avenue
OWNERCTY Pays du client.

Pays en code ISO 3166-1-alpha-2 tel qu'indiqué sur le site https://www.iban.com/country-codes 
Oui Non AN 2 BE
OWNERTELNO Numéro de téléphone du client.

Les caractères spéciaux (+ ou/ par exemple) sont autorisés dans ce champ. Il est préférable d'être cohérent dans le mode d'envoi des numéros de téléphone. 
Oui Non AN 30 Batch:20 3222869611
OWNERTOWN Ville du client. Oui Non AN 25 Brussels
OWNERZIP Code postal du client. Oui Non AN 10 1000
Parameters.AcceptUrl URL de la page web à afficher au client quand le paiement est autorisé. Oui Non AN 255 http://www.myshop.com/accept.html
Parameters.ExceptionUrl URL de la page web à afficher au client quand le résultat du paiement est incertain. Oui Non AN 255 http://www.myshop.com/exception.html
Parameters.ExcludedPaymentMethods Liste des modes de paiement qui ne doivent PAS être affichés sur la page de paiement Oui Non AN 50 Diners;American Express
Parameters.ParamPlus Champ permettant de soumettre certains paramètres et leurs valeurs que vous souhaitez recevoir dans la demande de retour d'informations ou la redirection finale. Cfr. e-Commerce avancé

Structure :
paramname=paramvalue&paramname=paramvalue&…
Oui Non AN 1000 SessionID=126548354&ShopperID=73541312
PARAMPLUS Champ permettant de soumettre certains paramètres et leurs valeurs que vous souhaitez recevoir dans la demande de retour d'informations ou la redirection finale. Cfr. e-Commerce avancé

Structure :
paramname=paramvalue&paramname=paramvalue&…
Oui Oui AN 1000 SessionID=126548354&ShopperID=73541312
PARAMVAR Partie variable à inclure dans les URL utilisées pour les demandes de retour d'informations et/ou d'annulation-rejet. PARAMVAR distingue les minuscules et les majuscules et doit comporter 2 caractères minimum. Oui Non AN 50 webshop1
PAYID

Référence de transaction unique de notre système.

Le PAYID comporte actuellement 10 chiffres, mais ce nombre est appelé à augmenter.
Dans l'environnement de test, le PAYID contient actuellement 8 chiffres.

Oui Oui N N/A 3126514264
PAYIDSUB Numéro d'historique de l'opération sur le PAYID. Vous pouvez réaliser plusieurs opérations financières (autorisation, paiement, remboursement, etc.) sur la même commande (PAYID). Chaque opération financière est identifiée par le PAYID/PAYIDSUB. Oui Oui N N/A 1
PAYMENTOCCURRENCE Code indiquant le nombre d'occurrences de paiement Ce paramètre n'est utilisé qu'avec des méthodes de paiement spécifiques (reprises dans les guides dédiés). Oui Non N 2 42
PM

Mode de paiement.

Vous pouvez consulter une liste des valeurs PM sur Support > Manuels de l’utilisateur et d’intégration > Guides techniques > Payment Methods Processing/Procedures

Oui Oui AN 25 CreditCard
PMLIST

Liste des modes de paiement et/ou marques de carte sélectionnés à afficher sur la page de paiement. Séparés par un point-virgule.

Vous pouvez consulter une liste de valeurs PM et BRAND sur Support > Manuels de l’utilisateur et d’intégration > Guides techniques > Payment Methods Processing/Procedures
 

Oui Non AN 200 VISA;MasterCard;American Express
PMLISTTYPE Mode d'affichage de la liste des icônes des modes de paiement sur la page de paiement. Oui Non N N/A 2
PSPID Votre nom d'affiliation dans notre système, choisi par vous-même à l'ouverture de votre compte chez nous. Cet identifiant unique ne peut jamais être modifié. Oui Non AN 30 JDoeSHOP
PSWD Mot de passe pour le PSPID (utilisateur par défaut) ou un UserID spécifique. Oui Non AN N/A BluEPr1nT8?
RECIPIENTACCOUNTNUMBER MCC 6012 détaillants : Données d'autorisation supplémentaires VisaNuméro de compte du destinataire OU numéro de carte de crédit en partie masqué Oui Non AN 10 12345ABCDZ6789
RECIPIENTDOB MCC 6012 détaillants : Données d'autorisation supplémentaires VisaDate de naissance du destinataire Oui Non dd/MM/yyyy 10 2/3/1982
RECIPIENTLASTNAME MCC 6012 détaillants : Données d'autorisation supplémentaires Visa. Nom de famille du destinataire Oui Non AN 6
RECIPIENTZIP MCC 6012 détaillants : Données d'autorisation supplémentaires Visa.Code postal du destinataire Oui Non AN 6 W1A 1AA
REF_CUSTOMERID todo Oui Non AN 20 Abc-1234_5/2
REMOTE_ADDR Adresse IP du client (uniquement pour le module de détection des fraudes). Pour les interfaces dans lesquelles notre système gère le dialogue avec le client (pour l'e-Commerce, par exemple) la REMOTE_ADDR est directement saisie par nos soins. Pour les autres interfaces, le commerçant doit envoyer l'adresse IP du client avec les détails de la transaction.

Si la vérification du pays de l'adresse IP n'est pas nécessaire, envoyez la valeur « NONE ».
Oui Non AN N/A 212.23.45.96
RTIMEOUT Délai d'attente de la demande pour une transaction, en secondes. La valeur peut être comprise entre 30 et 90. La valeur par défaut est 90.

S'il utilise les composants http pour des interfaces telles que DirectLink, le commerçant doit s'assurer que le délai d'attente du composant http est plus long que la valeur qu'il définit comme RTIMEOUT pour la transaction.
Oui Non N 2 45
SCO_CATERY Catégories de notation. Voir le module FDMA (Advanced Fraud Detection Module) : Documentation sur la notation.

Valeurs possibles : G (vert), O (orange), R (rouge).
Non Oui AN 1 G
SCORING Notation finale d'une transaction. Voir le module FDMA (Advanced Fraud Detection Module) : Documentation sur la notation. Non Oui N 4 17
SEQUENCETYPE
Valeurs possibles pour indiquer le type de transaction Prélèvement automatique (NL) :

- FRST : Premier ensemble d'une série d'ordres de prélèvement automatique

- RCUR: Ordres de prélèvement automatique où l'autorisation du débiteur est utilisée pour les transactions de prélèvement automatique exécutées par le créditeur

- FNAL: Dernier ensemble d'une série d'ordres de prélèvement automatique (après quoi le même identifiant de mandat(MandateID) ne peut plus être utilisé)

- OOFF: Ordre de prélèvement automatique où l'autorisation du débiteur est utilisée pour exécuter une transaction de prélèvement automatique unique
Oui Oui AN 4 FRST
SHASIGN Chaîne hachée avec l'algorithme de hachache sécurisé (Secure Hash Algorithm).

Le SHASIGN dans les champs masqués est pour la signature SHA-in (contrôle des données avant le paiement).
Le commerçant obtient un SHASIGN en retour s'il utilise une signature SHA-out (contrôle d'origine du retour).
Oui Oui AN 128 172386BFF99BC8F899035E356497D4334958F2D4
ShaSignature.ShaSign Chaîne hachée avec l'algorithme de hachache sécurisé (Secure Hash Algorithm).

Le SHASIGN dans les champs masqués est pour la signature SHA-in (contrôle des données avant le paiement).
Le commerçant obtient un SHASIGN en retour s'il utilise une signature SHA-out (contrôle d'origine du retour).
Oui Non AN 128 172386BFF99BC8F899035E356497D4334958F2D4
SIGNDATE Prélèvements automatiques NL : Date à laquelle le mandat a été signé par l'acheteur. Oui Oui YYYYMMDD 8 20140131
STATUS Statut du paiement.

0

Incomplet ou invalide

1

Annulé par le client

2

Autorisation refusée

4

Commande enregistrée

41

En attente du paiement du client

5

Autorisé

51

En attente d'autorisation

52

Autorisation inconnue

59

Autor. à obtenir manuellement

6

Autorisé et annulé

61

Suppression d'autor. en attente

62

Suppression d'autor. incertaine

63

Suppression d'autor. refusée

7

Paiement supprimé

71

Suppression de paiement en suspens

72

Suppression de paiement incertaine

73

Suppression de paiement refusée

74

Paiement supprimé(non accepté)

75

Suppression traitée par le commerçant

8

Remboursement

81

Remboursement en suspens

82

Remboursement incertain

83

Remboursement refusé

84

Paiement refusé par l'acquéreur(sera débité)

85

Remboursement traité par le commerçant

9

Paiement demandé

91

Traitement du paiement en cours

92

Paiement incertain

93

Paiement refusé

94

Remboursement refusé par l'acquéreur

95

Paiement traité par le commerçant

97-99

En cours de traitement(statut technique intermédiaire)



Le tableau ci-dessus résume les statuts possibles des paiements.

Les statuts à 1 chiffre sont des statuts « normaux » :
  • 0 signifie que le paiement n'est pas valide (par exemple, erreur de validation des données) ou que le traitement n'est pas terminé soit parce qu'il est en cours, soit parce que la transaction a été interrompue. Si la cause est une erreur de validation, un code d'erreur supplémentaire (*) (NCERROR) identifie l'erreur.
  • 1 signifie que le client a annulé la transaction.
  • 2 signifie que l'acquéreur///
Non Oui N 2 9
STATUS_3D N : échec d'identification
Y : identification réussie
A : preuve de tentative d'authentification
U : serveur d'annuaire indisponible
Oui Non AN 1 N
SUB_AM Montant de l'abonnement Oui Non N N/A 100
SUB_AMOUNT Montant de l'abonnement Oui Non N N/A 100
SUB_COM description de la commande Oui Non AN 100 One telephone card
SUB_COMMENT commentaire sur l'abonnement Oui Non AN 200 Monthly subscription to lf World.
SUB_CUR devise de l'abonnement Oui Non AN 3 EUR
SUB_ENDDATE

date de fin de l'abonnement

Oui Non yyyy-MM-dd 10 2021-01-01
SUB_ORDERID ID de commande de l'abonnement Oui Non AN 40 order 123
SUB_PERIOD_MOMENT moment d'un paiement de l'abonnement, en fonction de sub_period_unit Oui Non N N/A 1
SUB_PERIOD_NUMBER Intervalle entre chaque occurrence du paiement de l'abonnement Oui Non N N/A 15
SUB_PERIOD_UNIT unité de l'intervalle entre chaque occurrence du paiement de l'abonnement Oui Non AN 2 d
SUB_STARTDATE

date de début d'un abonnement

Oui Non yyyy-MM-dd 10 2021-01-01
SUB_STATUS statut d'un abonnement Oui Non AN 1 0
SUBBRAND Ce champ est renvoyé lors de l'utilisation de la sous-marque d'une marque. Les sous-marques peuvent être des versions prépayées de cartes de crédit (Visa/MasterCard Prepaid, etc.), des cartes d'entreprise ou des cartes liées à des privilèges spéciaux (MasterCard Platinum, Visa Infinite, etc.).

Pour que ce champ soit renvoyé, il doit être ajouté aux paramètres dynamiques d'e-Commerce dans l'onglet Retour de transaction de votre page Informations techniques.
Non Oui AN 25 VISA VPAY; CIRRUS
SUBSCRIPTION_ID Identifiant unique d'un abonnement. Oui Oui AN 50 subscription1
TAXINCLUDED ! Oui Non AN 1 1
TBLBGCOLOR Couleur de fond du tableau sur la page de paiement. Oui Non AN N/A LightYellow #FFFFE0
TBLTXTCOLOR Couleur du texte du tableau sur la page de paiement. Oui Non AN N/A Blue #0000FF
TITLE Titre sur la page de paiement. Oui Non AN N/A John's bait shop
TP URL du modèle (y compris http(s)://)/nom.

Quand nous proposons d'héberger le modèle du marchand sur notre serveur, celui-ci n'a plus qu'à saisir son nom de fichier dans le champ tp au lieu de l'URL complète. De cette manière, l'URL du marchand devient chez nous une URL statique.
Oui Non AN N/A http://www.myshop.com/template.html
TRXDATE Date de transaction. Non Oui MM/DD/YY N/A 12/25/2010
TXTCOLOR Couleur du texte sur la page de paiement. Oui Non AN N/A DarkGreen #006400
USERID Nom d'utilisateur tel que spécifié sur la page de gestion des utilisateurs du compte.

L'UserID par défaut d'un compte est identique au PSPID du compte. Si le champ UserID reste vide lors d'une demande de paiement via e-Commerce ou lors de la connexion, nous prendrons la valeur du champ PSPID comme valeur pour l'UserID.

Évitez d'utiliser des espaces et des caractères spéciaux dans l'USERID.
Oui Non AN Min. 5 and Max. 30 JohnD
VC Type de carte virtuelle. Les cartes virtuelles sont, en général, des numéros de carte de crédit virtuels et à usage unique qui ne peuvent être utilisés que dans une boutique en ligne prédéfinie. Non Oui AN 3 NO
WIN3DS Mode d'affichage de la page d'identification pour 3-D Secure ou pour les boutons de paiement KBC, CBC, Dexia et ING du client.

Valeurs possibles : MAINW, POPUP, POPIX (DirectLink seulement)
Oui Non AN 6 MAINW