American Express

Introduction
Lancée en tant que société de courrier express dès 1850, American Express a introduit ses chèques de voyage dès 1891 dans le but d'aider les Américains voyageant en Europe. Pour renforcer davantage la présence de la société dans le secteur financier, soutenue par diverses acquisitions bancaires, Amex a lancé sa première carte de paiement en 1958. Près de 30 ans plus tard, American Express a introduit son premier produit de carte de crédit qui n’avait pas à être payé en totalité à la fin du mois. Pour élargir l’acceptation des cartes, Amex a abandonné sa politique d’exclusivité; ainsi, à la fin de 2017, l’entreprise comptait 112,8 millions de cartes en circulation.
Amex SafeKey
Amex SafeKey exploite le 3-D Secure pour détecter et réduire la fraude en ligne en ajoutant une couche de sécurité supplémentaire lorsque les consommateurs effectuent des achats en ligne.
Pays & devises
Pays pris en charge
-
Albanie
-
Algérie
-
Samoa américaines
-
Andorre
-
Angola
-
Australie
-
Autriche
-
Belgique
-
Bénin
-
Bolivie
-
Bonaire, Saba et Sint Eustatius
-
Île Bouvet
Devises prises en charge
- Albanian lek (ALL)
- Algerian dinar (DZD)
- Australian dollar (AUD)
- Boliviano (BOB)
- Bulgarian lev (BGN)
- Canadian dollar (CAD)
- CFA franc BCEAO (XOF)
- Chinese yuan (CNY)
- Croatian kuna (HRK)
- Czech koruna (CZK)
- Danish krone (DKK)
- Egyptian pound (EGP)
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.