American Express

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
• Brésil
• Bulgarie
• Burkina Faso
• Canada
• Chine
• Île Christmas
• Îles Cocos (Keeling)
• Îles Cook
• Croatie
• Chypre
• République tchèque
• Danemark
• Équateur
• Égypte
• Estonie
• Îles Féroé
• Fidji
• Finlande
• France
• Guyane française
• Territoires australs français
• Allemagne
• Grèce
• Groenland
• Guadeloupe
• Guam
• Guernesey
• Île Heard et îles McDonald
• Hong Kong
• Hongrie
• Islande
• Irlande
• île de Man
• Israël
• Italie
• Japon
• Jersey
• Jordanie
• Kazakhstan
• Kenya
• Kiribati
• Koweït
• Lettonie
• Liban
• Liechtenstein
• Lituanie
• Luxembourg
• Macao
• Malaisie
• Mali
• Malte
• Îles Marshall
• Martinique
• Mauritanie
• Maurice
• Mayotte
• Mexique
• Micronésie
• Moldavie
• Monaco
• Mongolie
• Monténégro
• Maroc
• Namibie
• Nauru
• Népal
• Antilles néerlandaises
• Pays-Bas
• Nouvelle-Zélande
• Niger
• Niue
• Île Norfolk
• Îles Mariannes du Nord
• Norvège
• Oman
• Palaos
• Papouasie-Nouvelle-Guinée
• Pitcairn
• Pologne
• Portugal
• Porto Rico
• Qatar
• Réunion
• Roumanie
• Russie
• Saint-Martin
• Saint-Pierre-et-Miquelon
• Saint-Marin
• Arabie Saoudite
• Sénégal
• Seychelles
• Sierra Leone
• Singapour
• Sint Maarten
• Slovaquie
• Slovénie
• Géorgie du Sud et les îles Sandwich du Sud
• Corée du Sud
• Espagne
• Sri Lanka
• Soudan
• Svalbard et Jan Mayen
• Suède
• Suisse
• Taïwan
• Tanzanie
• Togo
• Tokelau
• Tunisie
• Turquie
• Îles Turques-et-Caïques
• Tuvalu
• Ukraine
• Émirats Arabes Unis
• Royaume-Uni
• Îles mineures éloignées des États-Unis
• États-Unis
• Vanuatu
• Vatican
• Îles Vierges (britanniques)
• Îles Vierges (États-Unis)
• Sahara Occidental

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 méthodes d'intégration suivants. Découvrez leurs différences dans nos guides dédiés :

• Hosted Checkout Page
• Hosted Tokenization Page
• Server-to-server
• Intégration mobile/client

Veuillez trouver une vue d'ensemble dans le chapitre "Cinématique".

Selon votre méthode d'intégration, des différences s'appliquent :

• Hosted Checkout Page
• Hosted Tokenization Page 
• Server-to-server/Intégration mobile/client

Hosted Checkout Page

Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :

{
  "hostedCheckoutSpecificInput": {
    "locale": "en_GB",
	"returnUrl": "https://yourReturnUrl.com", 
    "cardPaymentMethodSpecificInput": {
      "groupCards": true,
	  "clickToPay": false
    },
    "paymentProductFilters": {
      "restrictTo": {
        "groups": [
          "cards"
        ]
      }
    }
  },
  "order": {
    "amountOfMoney": {
      "amount": 100,
      "currencyCode": "AUD"
    }
  }
}

Hosted Tokenization Page

Ajoutez les propriétés suivantes à une requête standard CreatePayment (y compris les propriétés 3-D Secure) après avoir tokenisé la carte :

{
   "hostedTokenizationId":"hostedTokenizationId",
   "order":{
      "amountOfMoney":{
         "amount":1000,
         "currencyCode":"EUR"
      },
      "customer":{
         "account":{
            "authentication":{
               "method":"guest",
               "utcTimestamp":"202309261631"
            },
            "changeDate":"20200101",
            "changedDuringCheckout":true,
            "createDate":"20100101",
            "hadSuspiciousActivity":false,
            "passwordChangeDate":"20200101",
            "passwordChangedDuringCheckout":false,
            "paymentAccountOnFile":{
               "createDate":"20100101",
               "numberOfCardOnFileCreationAttemptsLast24Hours":1
            },
            "paymentActivity":{
               "numberOfPaymentAttemptsLast24Hours":1,
               "numberOfPaymentAttemptsLastYear":0,
               "numberOfPurchasesLast6Months":0
            }
         },
         "accountType":"existing",
         "billingAddress":{
            "countryCode":"BE",
            "city":"Brussels",
            "houseNumber":"3",
            "state":"Flemish Brabant",
            "street":"Da Vincilaan",
            "zip":"1930",
            "additionalInfo":"floor 9"
         },
         "contactDetails":{
            "emailAddress":"wile.e.coyote@acmelabs.com",
            "phoneNumber":"+321234567890"
         },
         "device":{
            "acceptHeader":"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,/;q=0.8",
            "browserData":{
               "colorDepth":99,
               "javaEnabled":true,
               "javaScriptEnabled":true,
               "screenHeight":"768",
               "screenWidth":"1024"
            },
            "ipAddress":"123.123.123.123",
            "locale":"en_GB",
            "userAgent":"Mozilla/5.0(WindowsNT10.0;Win64;x64)AppleWebKit/537.36(KHTML,likeGecko)Chrome/75.0.3770.142Safari/537.36",
            "timezoneOffsetUtcMinutes":"-180"
         }
      }
   }
}

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": "AUD"
		},
		"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"
				}
			}
		}
	}
}

Cinématique

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 méthode 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.