Maestro

Introduction
Mastercard est l'une des plus grandes marques de cartes au monde, traitant des transactions dans 210 pays. Créée en 1966 par un groupe de banques américaines sous le nom d'Interbank Card Association, elle a pris son nom actuel 13 ans plus tard, en 1979.
Mastercard Crédit
Mastercard Crédit est la principale marque de cartes du groupe Mastercard.
Mastercard Débit
La carte de débit Mastercard est acceptée dans des millions d'entreprises en ligne. Son réseau d'acceptation est aussi global que celui de la carte de crédit Mastercard.
Maestro
Cette marque de carte de débit a été introduite par Mastercard en 1992 en tant que première carte globale de débit en ligne basée sur un code PIN. Maestro peut être soit liée à un compte bancaire du consommateur, soit être une carte prépayée. Elle bénéficie d'une large acceptation dans le monde, car elle a soit remplacé, soit est co-badgée avec des marques domestiques.
Mastercard SecureCode
Mastercard SecureCode est un code privé pour le compte Mastercard qui offre aux consommateurs une couche supplémentaire de sécurité pour les achats en ligne, similaire au service 3D Secure de Visa.
Pays & devises
Pays pris en charge
-
Albanie
-
Andorre
-
Arménie
-
Australie
-
Autriche
-
Azerbaïdjan
-
Biélorussie
-
Belgique
-
Belize
-
Bosnie-Herzégovine
-
Île Bouvet
-
Bulgarie
Devises prises en charge
- Albanian lek (ALL)
- Armenian dram (AMD)
- Australian dollar (AUD)
- Azerbaijani manat (AZN)
- Belarusian ruble (BYN)
- Belize dollar (BZD)
- Bosnia and Herzegovina convertible mark (BAM)
- Bulgarian lev (BGN)
- Croatian kuna (HRK)
- Czech koruna (CZK)
- Danish krone (DKK)
- Euro (EUR)
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.