- Directives d'intégration
- Fonctionnalités prises en charge (Autres fonctionnalités)
- Données supplémentaires
- Données de niveau II et de niveau III
- Données de niveau II/III pour l'acquéreur First Data
Données de niveau II/III pour l'acquéreur First Data
Cette page comporte des informations supplémentaires sur l'intégration par rapport au guide d'intégration de niveau II/III standard et concerne spécifiquement l'acquéreur First Data.
La passerelle soumettra les données de niveau II/III que vous avez indiquées à l'acquéreur First Data uniquement si vous renseignez au moins les champs suivants :
- Code postal de destination d'expédition (
shipping.address.postcodeZip) - Code postal d'origine de l'expédition (
shipping.origin.postcodeZip, si elle n'est pas fournie, la valeur configurée sur votre profil de commerçant peut être soumise à l'acquéreur.) - Données de transaction au niveau de l'article
- Quantité de l'article (
transaction.item[n].quantity) - Code produit de l'article (
transaction.item[n].name) - Unité de mesure de l'article (
transaction.item[n].unitOfMeasure) - Code d'article (
transaction.item[n].detail.commodityCodeoutransaction.item[n].detail.acquirerCustom ={"XD34_4":"<non-integer item commodity code>"})
- Quantité de l'article (
- Votre ID d'enregistrement fiscal (
order.taxRegistrationId(fortement recommandé pour obtenir les meilleurs taux d'interchange))
Données de niveau II
Pour transmettre les données de niveau II suivantes dans votre demande de transaction, utilisez les champs API correspondants au niveau de la commande et/ou au niveau de la transaction avec les détails de l'intégration, comme illustré dans la colonne « Valeur du champ » dans le tableau ci-dessous.
| Données de niveau II | Champ au niveau de la commande | Champ au niveau de la transaction | Valeur du champ |
|---|---|---|---|
| Référence de l'achat du commerçant | order.referenceSi non indiquée, la passerelle utilise la valeur fournie dans le champ order.id (champ obligatoire).
|
- |
Ce champ est obligatoire pour les cartes Mastercard (jusqu'à 17 caractères), mais est facultatif pour les cartes Visa (jusqu'à 25 caractères). |
| Numéro de référence du client/du titulaire de la carte | order.customerReference |
- |
Ce champ est obligatoire pour les cartes Mastercard et Visa. |
| Numéro de facture | order.invoiceNumber |
- |
Ce champ est obligatoire pour les cartes Mastercard, mais facultatif pour les cartes Visa. |
| Montant d'expédition et de gestion | order.shippingAndHandlingAmount |
transaction.shippingAndHandlingAmount |
Si vous indiquez un montant d'expédition et de gestion, vous devez également fournir les informations suivantes :
|
| Montant de taxe | order.taxAmount |
transaction.taxAmount |
Ce champ est obligatoire pour les cartes Mastercard, mais facultatif pour les cartes Visa. |
| Montant des droits | À partir de la version 67 de l'API, utilisez :order.dutyAmountPour les versions d'API inférieures à 67, utilisez : order.tax[n].type=DUTYorder.tax[n].amount |
À partir de la version 67 de l'API, utilisez :transaction.dutyAmountPour les versions d'API inférieures à 67, utilisez : transaction.tax[n].type=DUTYtransaction.tax[n].amount |
- |
Données de niveau III
Pour transmettre les données de niveau III suivantes dans votre demande de transaction, utilisez les champs correspondants au niveau de la commande (du groupe de paramètres order.item[n]) et/ou au niveau de la transaction (du groupe de paramètres transaction.item[n]) API avec les détails de l'intégration, comme illustré dans la colonne « Valeur du champ » dans le tableau ci-dessous.
| Données de niveau III | Champ au niveau de la commande | Champ au niveau de la transaction | Valeur du champ |
|---|---|---|---|
| Unité de mesure de l'article | order.item[n].unitOfMeasure |
transaction.item[n].unitOfMeasure |
Vous devez indiquer la valeur d'énumération correcte comme requis par votre acquéreur ; voir Valeurs d'énumération d'unité de mesure d'article. |
| Type de taxe de l'article | order.item[n].detail.unitTaxType |
transaction.item[n].detail.unitTaxType |
Vous devez indiquer la valeur d'énumération correcte pour le code de type de taxe comme requis par votre acquéreur ; voir Valeurs d'énumération de type de taxe. |
| Type de taxe de l'article [n] | order.item[n].detail.tax[m].type |
transaction.item[n].detail.tax[m].type |
Seuls les détails fournis pour le premier élément de la liste (transaction.item[n].detail.unitTax[1].*) seront soumis à l'acquéreur. Vous devez indiquer la valeur d'énumération correcte pour le code de type de taxe comme requis par votre acquéreur ; voir Valeurs d'énumération de type de taxe. |
| Code d'article | order.item[n].detail.acquirerCustom ={"XD34_4":"<non-integer item commodity code>"} |
transaction.item[n].detail.acquirerCustom ={"XD34_4":"<non-integer item commodity code>"} |
Utilisez ce champ si vous voulez soumettre un code d'article qui ne soit pas un nombre entier pour un poste. Pour soumettre un code d'article numérique pour un poste, vous pouvez utiliser les champs order.item[n].detail.commodityCode ou transaction.item[n].detail.commodityCode. |
Valeurs d'énumération de type de taxe
Indiquez la valeur d'énumération de type de taxe correcte dans les champs order.item[n].detail.unitTaxType et/ou transaction.item[n].detail.unitTaxType
| Code type de taxe | Description |
|---|---|
| 00 | Inconnu |
| 01 | Taxe sur les ventes fédérale/nationale |
| 02 | Taxe sur les ventes d'État |
| 03 | Taxe sur les ventes communale |
| 04 | Taxe sur les ventes locale |
| 05 | Taxe sur les ventes municipale |
| 06 | Autre taxe |
| 10 | Taxe sur la valeur ajoutée (TVA) |
| 11 | Taxe sur les produits et services (TPS) |
| 12 | Taxe sur les ventes provinciale |
| 20 | Taxe sur les chambres |
| 21 | Taxe de séjour |
| 22 | Taxe sur l'énergie |
Valeurs d'énumération d'unité de mesure d'article
Indiquez la valeur d'énumération d'unité de mesure correcte pour les postes dans les champs order.item[n].unitOfMeasure et/ou transaction.item[n].unitOfMeasure.
| Code de l'unité de mesure | Description |
|---|---|
| ACR | Acre (4046,86 m2) |
| ASM | Titre alcoométrique massique |
| ASV | Titre alcoométrique volumique |
| AMP | Ampère |
| AMH | Ampère-heure (3,6 kC) |
| ARE | Are (100 m2) |
| BAR | Bar |
| BLL | Baril (pétrole) (158,987 dm3) |
| BFT | Pied de planche |
| BQL | Becquerel |
| BIL | Milliard d'unités thermiques britanniques |
| MLD | Milliard d'unités thermiques américaines |
| BX | ox |
| BHP | Puissance de freinage (245,7 watts) |
| BTU | Unité thermique britannique (1,055 kilojoules) |
| BUA | Boisseau (35,2391 dm3) |
| BUI | Boisseau (36,36874 dm3) |
| CDL | Candela |
| CCT | Capacité de charge en tonnes métriques |
| CS | ase |
| CNT | Cental GB (45,359237 kg) |
| CGM | Centigramme |
| CLT | Centilitre |
| CMT | Centimètre |
| DTN | Centner, mesure (100 kg) (syn. : décitonne) |
| WCD | Corde (3,63 m3) |
| COU | Coulomb |
| CKG | Coulomb par kilogramme |
| DMQ | Décimètre cube |
| FTQ | Pied cube |
| INQ | Pouce cube |
| MTQ | Mètre cube |
| MQH | Mètre cube par heure |
| MQS | Mètre cube par seconde |
| MMQ | Millimètre cube |
| YDQ | Yard cube |
| CUR | Curie |
| DAY | Jour |
| DEC | Décennie (dix ans) |
| DAA | Hectare |
| DLT | Décilitre |
| DMT | Décimètre |
| CEL | Degré Celsius |
| FAH | Degré Fahrenheit |
| KEL | Degré Kelvin : Identique à Kelvin |
| DPT | Tonne de déplacement |
| DZN | Douzaine |
| DZP | Douzaines de packs |
| DZR | Douzaines de paires |
| DPC | Douzaines de pièces |
| DRL | Douzaines de rouleaux |
| DRM | Drachme britannique (3,887935 g) |
| DRI | Drame GB (1,771745 g) |
| DRA | Drame US (3,887935 g) |
| BLD | Baril à sec (115,627 dm3) |
| GLD | Gallon à sec (4,404884 dm3) |
| PTD | Pinte à sec (0,55061 dm3) |
| QTD | Quart à sec (1,101221 dm3) |
| EA ou EAC | Chacun |
| FAR | Farad |
| OZI | Once liquide (28,413 cm3) |
| OZA | Once liquide (29,5735 cm3) |
| FOT | Pieds (0,3048 m) |
| GLI | Gallon (4,546092 dm3) |
| GBQ | Gigabecquerel |
| GWH | Gigawatt-heure (1 million kW/h) |
| GII | Gill (0,142065 dm3) |
| GIA | Gill (11,8294 cm3) |
| GRN | Grain GB, US (64,798910 mg) |
| GRM | Gramme |
| GFI | Gramme d'isotopes fissibles |
| GGR | Douzaine brute (douzaine) |
| GRO | Brut |
| GRT | Tonne brute (enregistrée) |
| SAN | Semestre (six mois) |
| HAR | Hectare |
| HBA | Hectobar |
| HGM | Hectogramme |
| DTH | Hectokilogramme |
| HLT | Hectolitre |
| HPA | Hectolitre d'alcool pur |
| HMT | Hectomètre |
| HTZ | Hertz |
| HUR | Heure |
| CEN | Centaine |
| BHX | Centaine de boîtes |
| HIU | Centaines d'Unités internationales |
| CLF | Centaine de feuilles |
| CNP | Centaine de packs |
| CWA | Poids de centaine US (45,3592 kg) |
| INH | Pouce (25,4 mm) |
| ITM | Élément |
| JOU | Joule |
| KEL | Kelvin |
| KBA | Kilobar |
| KGM | Kilogramme |
| KPH | Kilogramme de potasse caustique |
| KSH | Kilogramme de soude caustique |
| KNS | Kilogramme de substance nommée |
| KNI | Kilogramme d'azote |
| KPP | Kilogramme d'anhydride phosphonique |
| KPP | Kilogramme de pentoxyde de phosphore |
| KPH | Kilogramme d'hydroxyde de potassium |
| KPO | Kilogramme d'oxyde de potassium |
| KSD | Kilogramme de substance sèche à 90 pour cent |
| KUR | Kilogramme d'uranium |
| KMQ | Kilogramme par mètre cube |
| KGS | Kilogramme par seconde |
| KHZ | Kilohertz |
| KJO | Kilojoule |
| KMT | Kilomètre |
| KMH | Kilomètre-heure |
| KPA | Kilopascal |
| KTN | Kilotonne |
| KVR | Kilovar |
| KVT | Kilovolt |
| KVA | Kilovolt-ampère |
| KWT | Kilowatt |
| KWH | Kilowattheure |
| KNT | Knot (1 mille marin par heure) |
| LEF | Feuille |
| GLL | Gallon liquide (3,7854l dm3) |
| PTL | Pinte liquide (0,473176 dm3) |
| QTL | Quart liquide (0,946353 dm3) |
| LTR | Litre (1 dm3) |
| LPA | Litre d'alcool pur |
| LTN | Tonne longue GB, US (1,0160469 t) |
| LUM | Lumen |
| LUX | Lux |
| MHZ | Mégahertz |
| MAL | Mégalitre |
| MAM | Mégamètre |
| MPA | Mégapascal |
| MVA | Mégavolt-ampère (1000 KVA) |
| MAW | Mégawatt |
| MWH | Mégawattheure (100 million kW/h) |
| MTR | Mètre |
| MTS | Mètre par seconde |
| MSK | Mètre carré par seconde |
| CTM | Carat métrique (200 mg = 2,10-4 kg) |
| TNE | Tonne métrique (1 000 kg) |
| MBR | Millibar |
| MCU | Millicurie |
| MGM | Milligramme |
| MI.T | Millilitre |
| MMT | Millimètre |
| MIO | Million |
| HMQ | Million de mètres cubes |
| MIU | Million d'Unités internationales |
| MIN | Minute |
| MON | Mois |
| NMI | Mille marin (1852 m) |
| NTT | Tonne nette (enregistrée) |
| NEW | Newton |
| NMB | Nombre |
| NAR | Nombre d'articles |
| NBB | Nombre de bobines |
| NCL | Nombre de cellules |
| NIU | Nombre d'Unités internationales |
| NMP | Nombre de packs |
| NMR | Nombre de paires |
| NPL | Nombre de parcelles |
| NPT | Nombre de pièces |
| NRL | Nombre de rouleaux |
| OHM | Ohm |
| ONZ | Once GB, US (28,349523 g) |
| APZ | Once GB, US (31,10348 g) (syn. : Once troy) |
| PK | Package |
| PAL | Pascal |
| DWT | Pennyweight GB, US (1,555174 g) |
| PCE | Pièce |
| PCB | Pièce |
| PSC | Pièce |
| PTI | Pinte (0,568262 dm3) |
| LBR | Livre GB, US (0,45359237 kg) |
| PGL | Gallon preuve |
| LBS | Livres |
| QTI | Quart (1,136523 dm3) |
| QAN | Trimestre (d'une année) |
| QTR | Quart, GB (12,700586 kg) |
| RPM | Révolution par minute |
| RPS | Révolution par seconde |
| SCO | Score |
| SCR | Scruple GB (1,295982 g) |
| SEC | Seconde |
| SET | Ensemble |
| SHT | Tonne d'expédition |
| SST | Norme courte (7 200 allumettes) |
| SIE | Siemens |
| CMK | Centimètre carré |
| DMK | Décimètre carré |
| FTK | Pied carré |
| INK | Pouce carré |
| KMK | Kilomètre carré |
| MTK | Mètre carré |
| MIK | Mille carré |
| MMK | Millimètre carré |
| YDK | Yard carré |
| WSD | Standard |
| ATM | Atmosphère standard (101325 Pa) |
| SMI | Mille (Statuts) (1609,344 m) |
| STI | Stone GB (6,350293 kg) |
| ATT | Atmosphère technique (98066,5 Pa) |
| DAD | Dix jours |
| TPR | Dix paires |
| MIL | Millier |
| TAH | Millier d'ampères-heures |
| MBF | Millier de pieds de planche (2,36 m3) |
| TQD | Millier de mètres cubes par jour |
| MBE | Millier d'équivalents briques standard |
| TSH | Tonnes vapeur par heure |
| TSD | Tonne de substance sèche à 90 pour cent |
| TRL | Trillion d'unités thermiques britanniques |
| APZ | Once troy |
| ST | Unité de mesure inconnue |
| VLT | Volt |
| WTT | Watt |
| WHR | Wattheure |
| WEB | Weber |
| WEE | Semaine |