Mastercard
Introduction
Mastercard est l'une des plus grandes marques de cartes au monde, traitant des transactions dans 210 pays. Établie en 1966 par un groupe de banques américaines sous le nom d'Interbank Card Association, elle a adopté son nom actuel 13 ans plus tard, en 1979.
Mastercard Crédit
Mastercard Crédit est la principale marque de carte de Mastercard.
Mastercard Débit
La carte Mastercard Débit est acceptée par des millions d'entreprises en ligne. Son réseau d'acceptation est aussi global que celui de la carte Mastercard Crédit.
Mastercard SecureCode
Mastercard SecureCode est un code privé pour les comptes Mastercard qui offre aux consommateurs une couche supplémentaire de sécurité pour le shopping en ligne, similaire au service 3D Secure de Visa.
Pays & devises
Pays pris en charge
-
Îles Åland
-
Albanie
-
Algérie
-
Samoa américaines
-
Andorre
-
Angola
-
Anguilla
-
Antarctique
-
Antigua-et-Barbuda
-
Argentine
-
Arménie
-
Aruba
Australie
Autriche
Azerbaïdjan
Bahamas
Bahreïn
Bangladesh
Barbade
Biélorussie
Belgique
Belize
Bénin
Bermudes
Bhoutan
Bolivie
Bonaire, Saba et Sint Eustatius
Bosnie-Herzégovine
Botswana
Île Bouvet
Brésil
Territoire britannique de l'océan Indien
Brunei
Bulgarie
Burkina Faso
Burundi
Cambodge
Cameroun
Canada
Cap-Vert
Îles Caïmans
République Centrafricaine
Tchad
Chili
Chine
Île Christmas
Îles Cocos (Keeling)
Colombie
Comores
Congo (République Démocratique)
Congo (République)
Îles Cook
Costa Rica
Croatie
Curaçao
Chypre
République tchèque
Danemark
Djibouti
République dominicaine
Dominique
Timor oriental
Équateur
Égypte
Salvador
Eswatini
Guinée équatoriale
Érythrée
Estonie
Éthiopie
Îles Falkland
Îles Féroé
Fidji
Finlande
France
Guyane française
Polynésie française
Territoires australs français
Gabon
Gambie
Géorgie
Allemagne
Ghana
Gibraltar
Grèce
Groenland
Grenade
Guadeloupe
Guam
Guatemala
Guernesey
Guinée-Bissau
Guinée
Guyana
Haïti
Île Heard et îles McDonald
Honduras
Hong Kong
Hongrie
Islande
Inde
Indonésie
Irak
Irlande
île de Man
Israël
Italie
Côte d'Ivoire
Jamaïque
Japon
Jersey
Jordanie
Kazakhstan
Kenya
Kiribati
Koweït
Kirghizistan
Laos
Lettonie
Liban
Lesotho
Libéria
Libye
Liechtenstein
Lituanie
Luxembourg
Macao
Macédoine
Madagascar
Malawi
Malaisie
Maldives
Mali
Malte
Îles Marshall
Martinique
Mauritanie
Maurice
Mayotte
Mexique
Micronésie
Moldavie
Monaco
Mongolie
Monténégro
Montserrat
Maroc
Mozambique
Myanmar
Namibie
Nauru
Népal
Antilles néerlandaises
Pays-Bas
Nouvelle-Calédonie
Nouvelle-Zélande
Nicaragua
Nigeria
Niger
Niue
Île Norfolk
Îles Mariannes du Nord
Norvège
Oman
Pakistan
Palaos
Palestine
Panama
Papouasie-Nouvelle-Guinée
Paraguay
Pérou
Philippines
Pitcairn
Pologne
Portugal
Porto Rico
Qatar
Réunion
Roumanie
Russie
Rwanda
Saint-Barthélemy
Sainte-Hélène
Saint-Kitts-et-Nevis
Sainte-Lucie
Saint-Martin
Saint-Pierre-et-Miquelon
Saint-Vincent-et-les-Grenadines
Samoa
Saint-Marin
São Tomé-et-Principe
Arabie Saoudite
Sénégal
Serbie
Seychelles
Sierra Leone
Singapour
Sint Maarten
Slovaquie
Slovénie
Îles Salomon
Somalie
Afrique du Sud
Géorgie du Sud et les îles Sandwich du Sud
Corée du Sud
Espagne
Sri Lanka
Soudan
Suriname
Svalbard et Jan Mayen
Suède
Suisse
Taïwan
Tadjikistan
Tanzanie
Thaïlande
Togo
Tokelau
Tonga
Trinité-et-Tobago
Tunisie
Turquie
Turkménistan
Îles Turques-et-Caïques
Tuvalu
Ouganda
Ukraine
Émirats Arabes Unis
Royaume-Uni
Îles mineures éloignées des États-Unis
États-Unis
Uruguay
Ouzbékistan
Vanuatu
Vatican
Venezuela
Vietnam
Îles Vierges (britanniques)
Îles Vierges (États-Unis)
Wallis et Futuna
Sahara Occidental
Yémen
Zambie
Zimbabwe
Devises prises en charge
- Albanian lek (ALL)
- Algerian dinar (DZD)
- Angolan kwanza (AOA)
- Argentine peso (ARS)
- Armenian dram (AMD)
- Aruban florin (AWG)
- Australian dollar (AUD)
- Azerbaijani manat (AZN)
- Bahamian dollar (BSD)
- Bahraini dinar (BHD)
- Bangladeshi taka (BDT)
- Barbados dollar (BBD)
Intégration
Nous proposons ces méthodes de paiement pour les modes d'intégration suivants. Découvrez dans nos guides dédiés leurs différences individuelles :
Veuillez trouver une vue d'ensemble dans le chapitre "Cinématique".
Selon le mode d'intégration, des différences s'appliquent :
Hosted Checkout Page
Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :
{
"HostedCheckoutSpecificInput": {
"ReturnUrl": "https://yourReturnUrl.com"
},
"Order": {
"AmountOfMoney": {
"Amount": 100,
"CurrencyCode": "EUR"
}
}
}
| Propriétés | Remarques |
|---|---|
|
hostedCheckoutSpecificInput.returnURL |
L'URL vers laquelle nous redirigeons vos clients après que le paiement soit finalisé. |
|
order.amountOfMoney |
amount : Le montant brut que vous souhaitez facturer pour cette commande. |
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.
Hosted Tokenization Page
Ajoutez les propriétés suivantes à une requête standard CreatePayment (y compris les propriétés 3-D Secure obligatoires) après avoir tokenisé la carte :
{
"CardPaymentMethodSpecificInput": {
"Token": "tokenId",
"ThreeDSecure": {
"RedirectionData": {
"ReturnUrl": "https://yourRedirectionUrl.com"
}
}
},
"Order": {
"AmountOfMoney": {
"Amount": 100,
"CurrencyCode": "EUR"
},
"Customer": {
"Device": {
"AcceptHeader":
"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3",
"Locale": "en_EN",
"TimezoneOffsetUtcMinutes": -180,
"UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.142 Safari/537.36",
"Browserdata": {
"ColorDepth": 24,
"JavaScriptEnabled": false,
"ScreenHeight": "1080",
"ScreenWidth": "1920"
}
}
}
}
}
| Propriétés | Remarques |
|---|---|
|
cardPaymentMethodSpecificInput.token |
Token : Les informations de la carte de crédit tokenisées que vous avez reçues en tokenisant les informations/obtenant le token. En savoir plus dans notre guide dédié Hosted Tokenization Page. |
|
cardPaymentMethodSpecificInput.threeDSecure |
returnURL : L'URL vers laquelle nous redirigeons vos clients après que le paiement a été finalisé. |
|
order.amountOfMoney |
amount : Le montant brut que vous souhaitez facturer pour cette commande. |
|
customer.device |
Propriétés minimales pour se conformer au SCA pour l'authentification 3-D Secure. Consultez notre guide dédié pour apprendre comment demander correctement le 3-D Secure et consultez notre référence API pour plus d'informations sur les propriétés. |
Trouvez des informations détaillées sur cet objet et ses propriétés dans notre API HostedTokenization/ API CreatePayment.
Server-to-server
Ajoutez les propriétés suivantes à une requête standard CreatePayment (y compris les propriétés 3-D Secure obligatoires) :
{
"CardPaymentMethodSpecificInput": {
"PaymentProductId": XXX,
"SkipAuthentication": false,
"Card": {
"CardholderName": "John Doe",
"CardNumber": "0000000000000000",
"Cvv": 123,
"ExpiryDate": 1236
},
"ThreeDSecure": {
"RedirectionData": {
"ReturnUrl": "https://yourRedirectionUrl.com"
}
}
},
"Order": {
"AmountOfMoney": {
"Amount": 100,
"CurrencyCode": "EUR"
},
"Customer": {
"Device": {
"AcceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3",
"Locale": "en_EN",
"TimezoneOffsetUtcMinutes": -180,
"UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.142 Safari/537.36",
"Browserdata": {
"ColorDepth": 24,
"JavaScriptEnabled": false,
"ScreenHeight": "1080",
"ScreenWidth": "1920"
}
}
}
}
}
| Propriétés | Remarques |
|---|---|
|
cardPaymentMethodSpecificInput.paymentProductId cardPaymentMethodSpecificInput.card cardPaymentMethodSpecificInput.ThreeDSecure |
paymentProductId : L'identifiant numérique du mode de paiement sur notre plateforme. Trouvez cet id dans le chapitre "Aperçu".
returnURL : L'URL vers laquelle nous redirigeons vos clients après que le paiement a été finalisé. |
|
order.amountOfMoney |
amount : Le montant brut que vous souhaitez facturer pour cette commande. |
|
customer.device |
Propriétés minimales pour se conformer au SCA pour l'authentification 3-D Secure. Consultez notre guide dédié pour apprendre comment demander correctement le 3-D Secure et consultez notre référence API pour plus d'informations sur les propriétés. |
Trouvez des informations détaillées sur cet objet et ses propriétés dans notre CreatePaymentAPI.
Cinématique
Nous proposons cette méthode de paiement pour tous nos modes d'intégration. Quel que soit le mode que vous choisissez, le processus suit quelques étapes de base comme décrit ci-dessous. Découvrez dans nos guides dédiés les spéciticités de chacune :
- Vos clients finalisent une commande dans votre boutique et sélectionnent cette méthode de paiement.
- Vous envoyez une requête CreateHostedCheckout/CreatePayment à notre plateforme. Selon votre mode d'intégration, des différences s'appliquent. Consultez le chapitre “Intégration” pour trouver des exemples pour chaque mode.
- Notre plateforme vous envoie une réponse avec des instructions pour les prochaines étapes du processus.
- Vos clients fournissent leur numéro de carte de crédit et sont redirigés vers leur émetteur pour une authentification 3-D Secure.
- Notre système reçoit le résultat de l'authentification 3-D de l'émetteur.
- Nous traitons la transaction et recevons le résultat de l'acquéreur.
- Nous redirigeons votre client vers votre returnUrl .
- Vous demandez le résultat de la transaction de notre plateforme via GetPaymentDetails /GetHostedCheckout ou recevez le résultat via des webhooks.
- Si la transaction a réussi, vous pouvez livrer les marchandises/services.
Test
Consultez nos Cas de test pour des données de test et des instructions détaillées.
Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.