worldline Direct
S'inscrire

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.

Aperçu

Groupe de paiement :
Identifiant du moyen de paiement:
2
Avantages clés
  • Autorisation en temps réel
  • Paiements sécurisés
  • Cycle de remise rapide
  • Acceptation internationale

Pays & devises

Pays pris en charge

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)
  • Euro (EUR)
  • Fiji dollar (FJD)
  • Hong Kong dollar (HKD)
  • Hungarian forint (HUF)
  • Israeli new shekel (ILS)
  • Japanese yen (JPY)
  • Jordanian dinar (JOD)
  • Kazakhstani tenge (KZT)
  • Kenyan shilling (KES)
  • Kuwaiti dinar (KWD)
  • Lebanese pound (LBP)
  • Macanese pataca (MOP)
  • Malaysian ringgit (MYR)
  • Mauritanian ouguiya (MRO)
  • Mauritian rupee (MUR)
  • Mexican peso (MXN)
  • Moldovan leu (MDL)
  • Mongolian tugrik (MNT)
  • Moroccan dirham (MAD)
  • Nepalese rupee (NPR)
  • Netherlands Antillean guilder (ANG)
  • New Taiwan dollar (TWD)
  • New Zealand dollar (NZD)
  • Norwegian krone (NOK)
  • Omani rial (OMR)
  • Papua New Guinean kina (PGK)
  • Polish zloty (PLN)
  • Pound sterling (GBP)
  • Qatari riyal (QAR)
  • Romanian new leu (RON)
  • Russian ruble (RUB)
  • Saudi riyal (SAR)
  • Seychelles rupee (SCR)
  • Singapore dollar (SGD)
  • South Korean won (KRW)
  • Sri Lankan rupee (LKR)
  • Swedish krona/kronor (SEK)
  • Swiss franc (CHF)
  • Tanzanian shilling (TZS)
  • Tunisian dinar (TND)
  • Turkish lira (TRY)
  • Ukrainian hryvnia (UAH)
  • United Arab Emirates dirham (AED)
  • United States dollar (USD)
  • Vanuatu vatu (VUV)

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
     currencyCode

amount : Le montant brut que vous souhaitez facturer pour cette commande.
currencyCode : Le code de devise ISO 4217 pour ce montant.

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 
     redirectionData.returnURL
     skipAuthentication

returnURL : L'URL vers laquelle nous redirigeons vos clients après que le paiement a été finalisé.
skipAuthentication : Indiquer s'il faut procéder au 3-D Secure pour cette commande.

order.amountOfMoney
     amount
     currencyCode

amount : Le montant brut que vous souhaitez facturer pour cette commande.
currencyCode : Le code de devise ISO 4217 pour ce montant.

customer.device
     acceptHeader
     locale
     timezoneOffsetUtcMinutes
     userAgent
     browserdata
          colorDepth
          javaScriptEnabled
          screenHeight
          screenWidth

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
     cardholderName
     cardNumber
     cvv
     expiryDate

cardPaymentMethodSpecificInput.ThreeDSecure
     redirectionData.returnURL
     skipAuthentication

paymentProductId : L'identifiant numérique du mode de paiement sur notre plateforme. Trouvez cet id dans le chapitre "Aperçu".


cardPaymentMethodSpecificInput.card : Les informations de la carte utilisée pour le paiement.
Assurez-vous de respecter les exigences PCI DSS nécessaires pour l'envoi de données sensibles.

returnURL : L'URL vers laquelle nous redirigeons vos clients après que le paiement a été finalisé.
skipAuthentication : Indiquer s'il faut procéder au 3-D Secure pour cette commande.

order.amountOfMoney
     amount
     currencyCode

amount : Le montant brut que vous souhaitez facturer pour cette commande.
currencyCode : Le code de devise ISO 4217 pour ce montant.

customer.device
     acceptHeader
     locale
     timezoneOffsetUtcMinutes
     userAgent
     browserdata
          colorDepth
          javaScriptEnabled
          screenHeight
          screenWidth

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 :

  1. Vos clients finalisent une commande dans votre boutique et sélectionnent cette méthode de paiement.
  2. 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.
  3. Notre plateforme vous envoie une réponse avec des instructions pour les prochaines étapes du processus.
  4. Vos clients fournissent leur numéro de carte de crédit et sont redirigés vers leur émetteur pour une authentification 3-D Secure.
  5. Notre système reçoit le résultat de l'authentification 3-D de l'émetteur.
  6. Nous traitons la transaction et recevons le résultat de l'acquéreur.
  7. Nous redirigeons votre client vers votre returnUrl .
  8. Vous demandez le résultat de la transaction de notre plateforme via GetPaymentDetails /GetHostedCheckout ou recevez le résultat via des webhooks.
  9. 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.

Cette page vous a-t-elle été utile ?

Avez-vous des commentaires ?

Merci pour votre réponse.
New Feature

Try out our new chatbot and find answers to all your questions.