American Express

Countries & currencies

Supported countries

• Albania
• Algeria
• American Samoa
• Andorra
• Angola
• Australia
• Austria
• Belgium
• Benin
• Bolivia
• Bonaire, Saba and Sint Eustatius
• Bouvet Island
• Brazil
• Bulgaria
• Burkina Faso
• Canada
• China
• Christmas Island
• Cocos (Keeling) Islands
• Cook Islands
• Croatia
• Cyprus
• Czech Republic
• Denmark
• Ecuador
• Egypt
• Estonia
• Faroe Islands
• Fiji
• Finland
• France
• French Guiana
• French Southern Territories
• Germany
• Greece
• Greenland
• Guadeloupe
• Guam
• Guernsey
• Heard Island and McDonald Islands
• Hong Kong
• Hungary
• Iceland
• Ireland
• Isle of Man
• Israel
• Italy
• Japan
• Jersey
• Jordan
• Kazakhstan
• Kenya
• Kiribati
• Kuwait
• Latvia
• Lebanon
• Liechtenstein
• Lithuania
• Luxembourg
• Macao
• Malaysia
• Mali
• Malta
• Marshall Islands
• Martinique
• Mauritania
• Mauritius
• Mayotte
• Mexico
• Micronesia
• Moldova
• Monaco
• Mongolia
• Montenegro
• Morocco
• Namibia
• Nauru
• Nepal
• Netherlands Antilles
• Netherlands
• New Zealand
• Niger
• Niue
• Norfolk Island
• Northern Mariana Islands
• Norway
• Oman
• Palau
• Papua New Guinea
• Pitcairn
• Poland
• Portugal
• Puerto Rico
• Qatar
• Réunion
• Romania
• Russia
• Saint Martin
• Saint Pierre and Miquelon
• San Marino
• Saudi Arabia
• Senegal
• Seychelles
• Sierra Leone
• Singapore
• Sint Maarten
• Slovakia
• Slovenia
• South Georgia and the South Sandwich Islands
• South Korea
• Spain
• Sri Lanka
• Sudan
• Svalbard and Jan Mayen
• Sweden
• Switzerland
• Taiwan
• Tanzania
• Togo
• Tokelau
• Tunisia
• Turkey
• Turks and Caicos Islands
• Tuvalu
• Ukraine
• United Arab Emirates
• United Kingdom
• United States Minor Outlying Islands
• United States
• Vanuatu
• Vatican City
• Virgin Islands (British)
• Virgin Islands (U.S.)
• Western Sahara

Supported currencies

• 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)

Integration

Diese Zahlungsarten bieten wir für die folgenden Integrationsmodi an. In unseren Anleitungen erfahren Sie mehr über die genauen Unterschiede:

• Hosted Checkout Page
• Hosted Tokenization Page
• Server-to-server
• Mobile/Client Integration

Im Kapitel „Process flows“ finden Sie eine Übersicht.

Je nach Integrationsmodus gelten Unterschiede:

• Hosted Checkout Page
• Hosted Tokenization Page
• Server-to-server/Mobile/Client Integration

Hosted Checkout Page

Fügen Sie die folgenden Merkmale zu einer CreateHostedCheckout-Standardanfrage hinzu:

{
	"HostedCheckoutSpecificInput": {
		"ReturnUrl": "https://yourReturnUrl.com"
	},
	"Order": {
		"AmountOfMoney": {
			"Amount": 100,
			"CurrencyCode": "EUR"
		}
	}
}

Hosted Tokenization Page

Fügen Sie einer Create Payment-Standardanfrage die folgenden Merkmale hinzu (einschließlich notwendiger 3-D Secure-Parameter), nachdem Sie die Karte tokenisiert haben:

{
	"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"
				}
			}
		}
	}
}

Server-to-server

Fügen Sie einer Create Payment-Standardanfrage die folgenden Merkmale hinzu (einschließlich notwendiger 3-D Secure-Parameter):

{
	"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"
				}
			}
		}
	}
}

Process flows

1. Ihre Kunden schließen eine Bestellung in Ihrem Shop ab und wählen diese Zahlungsart.
2. Sie senden eine CreateHostedCheckout/CreatePayment Anfrage an unsere Plattform. Je nach Integrationsmodus gelten Unterschiede. Im Kapitel „Integration“ finden Sie Beispiele für jeden Modus.
3. Unsere Plattform sendet Ihnen eine Antwort mit Anweisungen für die nächsten Schritte im Ablauf.
4. Ihre Kunden geben ihre Kreditkartennummer an und werden zwecks 3-D Secure Authentifizierung zu ihrem Kreditkartenherausgeber umgeleitet.
5. Unser System erhält das Ergebnis der 3-D Authentifizierung vom Kreditkartenherausgeber.
6. Wir verarbeiten die Transaktion und erhalten das Ergebnis vom Acquirer.
7. Wir leiten Ihren Kunden um zu Ihrer returnUrl.
8. Sie fragen das Ergebnis der Transaktion via GetPayment bei unserer Plattform an oder Sie erhalten das Ergebnis via Webhooks.
9. Wenn die Transaktion erfolgreich verlaufen ist, können Sie die Güter / Dienstleistungen ausliefern.

Testing

In unseren Test cases finden Sie Testdaten und detaillierte Instruktionen.