Mastercard Credit
Intro
Mastercard is one of the largest card brands in the world, processing transactions in 210 countries. Established in 1966 by a group of US banks as Interbank Card Association payment instrument, it got its current name 13 years later, in 1979.
Mastercard Credit cards are widely used for both domestic and cross-border transactions, with strong acceptance in e-commerce and travel-related payments. They are issued by a broad range of financial institutions and are closely tied to Mastercard’s global credit processing capabilities.
Our platform offers three variants of the Mastercard brand, with separate PaymentProductIds / guides for each:
| Brand | PaymentProductId |
|---|---|
| Mastercard | 3 |
| Mastercard Credit | 118 |
| Mastercard Debit | 119 |
To offer the Mastercard Credit/Mastercard Debit variants, we need to activate the credit/debit split option in your account(s). Contact us to make that happen.
If you choose not to activate this feature, process transactions as described in the Mastercard guide.
Wichtigste Vorteile
- Autorisierung in Echtzeit
- Sichere Zahlungen
- Schneller Zahlungsausgleich
- Internationale Akzeptanz
Länder & Währungen
Unterstützte Länder
-
Aland
-
Albanien
-
Algerien
-
Samoa Amerikanisch
-
Andorra
-
Angola
-
Anguilla
-
Guam
-
Antigua und Barbuda
-
Argentinien
-
Armenien
-
Aruba
Australien
Osterreich
Aserbaidschan
Bahamas
Bahrain
Bangladesch
Barbados
Belarus
Belgien
Belize
Benin
Bermuda
Bhutan
Bolivien
Bonaire Bonaire Saba Saba Sint Eustatius Sint Eustatius
Bosnien und Herzegowina
Botswana
Norwegen
Brasilien
Britisches Territorium im Indischen Ozean
Brunei
Bulgarien
Burkina Faso
Burundi
Kambodscha
Kamerun
Kanada
Kap Verde
Cayman Islands
Zentralafrikanische Republik
Tschad
Chile
China Volksrepublik
Weihnachtsinsel
Kokosinseln
Kolumbien
Komoren
Kongo Demokratische Republik
Kongo Republik
Cookinseln
Costa Rica
Kroatien
Curaçao
Zypern Republik
Tschechien
Danemark
Dschibuti
Dominikanische Republik
Dominica
Osttimor
Ecuador
Agypten
El Salvador
Eswatini
Äquatorialguinea
Eritrea
Estland
Athiopien
Falklandinseln
Faroer
Fidschi
Finnland
Frankreich
Franzosisch-Guayana
Franzosisch-Polynesien
Französische Süd- und Antarktisgebiete
Gabun
Gambia
Georgien
Deutschland
Ghana
Gibraltar
Griechenland
Gronland
Grenada
Guadeloupe
Guam
Guatemala
Guernsey
Guinea-Bissau
Guinea-a
Guyana
Haiti
Australien
Honduras
Hongkong
Ungarn
Island
Indien
Indonesien
Irak
Irland
Isle of Man
Israel
Italien
Elfenbeinküste
Jamaika
Japan
Jersey
Jordanien
Kasachstan
Kenia
Kiribati
Kuwait
Kirgisistan
Laos
Lettland
Libanon
Lesotho
Liberia
Libyen
Liechtenstein
Litauen
Luxemburg
Macau
Nordmazedonien
Madagaskar
Malawi
Malaysia
Malediven
Mali
Malta
Marshallinseln
Martinique
Mauretanien
Mauritius
Mayotte
Mexiko
Mikronesien Foderierte Staaten
Moldau Republik
Monaco
Mongolei
Montenegro
Montserrat
Marokko
Mosambik
Myanmar
Namibia
Nauru
Nepal
Niederlandische Antillen
Niederlande
Neukaledonien
Neuseeland
Nicaragua
Nigeria
Niger
Niue
Norfolkinsel
Marianen Nordliche
Norwegen
Oman
Pakistan
Palau
Palastina Autonomiegebiete
Panama
Papua-Neuguinea
Paraguay
Peru
Philippinen
Pitcairninseln
Polen
Portugal
Puerto Rico
Katar
Reunion
Rumänien
Russland Russland
Ruanda
Saintbarthelemy
St. Helena, Ascension und Tristan da Cunha
Saint Kitts Nevis
Saint Lucia
Saint-Martin
Saint-Pierre und Miquelon
Saint Vincent Grenadinen
Samoa
San Marino
Sao Tome und Principe
Saudi-Arabien
Senegal
Serbien
Seychellen
Sierra Leone
Singapur
Sint Maarten
Slowakei
Slowenien
Salomonen
Somalia
Sudafrika
Sudgeorgien Sandwichinseln
Korea Sud
Spanien
Sri Lanka
Sudan
Suriname
Norwegen
Schweden
Schweiz
Taiwan
Tadschikistan
Tansania
Thailand
Togo
Tokelau
Tonga
Trinidad und Tobago
Tunesien
Turkei
Turkmenistan
Turksinseln und Caicosinseln
Tuvalu
Uganda
Ukraine Ukraine
Vereinigte Arabische Emirate
Vereinigtes Konigreich
Vereinigte Staaten
Vereinigte Staaten
Uruguay
Usbekistan
Vanuatu
Vatikanstadt
Venezuela
Vietnam
Jungferninseln Britische
Jungferninseln Amerikanische
Wallis Futuna
Westsahara
Jemen
Sambia
Simbabwe
Unterstützte Währungen
- Albanischer Lek
- Algerischer Dinar
- Angolanischer Kwanza
- Argentinischer Peso
- Armenischer Dram
- Aruba-Florin
- Australischer Dollar
- Aserbaidschan-Manat
- Bahamas-Dollar
- Bahrain-Dinar
- Bangladesch-Taka
- Barbados-Dollar
Integration
Diese Zahlungsarten bieten wir für die folgenden Integrationsmodi an. In unseren Anleitungen erfahren Sie mehr über die genauen Unterschiede:
Im Kapitel „Zahlungsablauf“ finden Sie eine Übersicht.
Je nach Integrationsmodus gelten Unterschiede:
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"
}
}
}
| Merkmale | Hinweise |
|---|---|
|
hostedCheckoutSpecificInput.returnURL |
Die URL, an die wir Ihre Kunden weiterleiten, nachdem die Zahlung beendet ist. |
|
order.amountOfMoney |
amount: Der Bruttobetrag, den Sie für diese Bestellung erheben möchten |
Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer CreateHostedCheckoutAPI
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"
}
}
}
}
}
| Properties | Remarks |
|---|---|
|
cardPaymentMethodSpecificInput.token |
Die tokenisierten Anmeldedaten für die Kreditkarte, die Sie bei der Tokenisierung der Anmeldedaten/beim Erhalt des Tokens bekommen haben. Erfahren Sie mehr in unserer Anleitung Hosted Tokenization Page. |
|
cardPaymentMethodSpecificInput.threeDSecure |
returnURL: Die URL, an die wir Ihre Kunden weiterleiten, nachdem die Zahlung beendet ist. |
|
order.amountOfMoney |
amount: Der Bruttobetrag, den Sie für diese Bestellung erheben möchten |
|
customer.device |
Minimale Merkmale für die Erfüllung der SCA-Vorschriften für die 3-D Secure-Authentifizierung. In unserer Anleitung erfahren Sie, wie Sie eine korrekte 3-D Secure-Anfrage stellen. In unserer API-Referenz lernen Sie mehr über die Merkmale. |
Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer HostedTokenizationAPI / CreatePaymentAPI
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"
}
}
}
}
}
| Merkmale | Hinweise |
|---|---|
|
cardPaymentMethodSpecificInput.paymentProductId cardPaymentMethodSpecificInput.card cardPaymentMethodSpecificInput.ThreeDSecure |
paymentProductId: Der numerische Identifikator der Zahlungsart auf unserer Plattform. Diese ID finden Sie im Kapitel "Überblick".
returnURL: Die URL, an die wir Ihre Kunden weiterleiten, nachdem die Zahlung beendet ist. |
|
order.amountOfMoney |
amount: Der Bruttobetrag, den Sie für diese Bestellung erheben möchten |
|
customer.device |
Minimale Merkmale für die Erfüllung der SCA-Vorschriften für die 3-D Secure-Authentifizierung. Schauen Sie in unserer Anleitung nach, um zu erfahren, wie Sie eine korrekte 3-D Secure-Anfrage stellen. In unserer API Referenz lernen Sie mehr über die Merkmale. |
Ausführliche Informationen über dieses Objekt und seine Eigenschaften finden Sie in unserer CreatePaymentAPI
Zahlungsablauf
Wir bieten diese Zahlungsmethode für alle unsere Integrationsmodi an. Unabhängig vom gewählten Modus folgt der Ablauf einigen grundlegenden Schritten, die im Folgenden beschrieben werden. In unseren Anleitungen erfahren Sie mehr über die genauen Unterschiede.
- Ihre Kunden schließen eine Bestellung in Ihrem Shop ab und wählen diese Zahlungsart.
- Sie senden eine CreateHostedCheckout/CreatePayment Anfrage an unsere Plattform. Je nach Integrationsmodus gelten Unterschiede. Im Kapitel „Integration“ finden Sie Beispiele für jeden Modus.
- Unsere Plattform sendet Ihnen eine Antwort mit Anweisungen für die nächsten Schritte im Ablauf.
- Ihre Kunden geben ihre Kreditkartennummer an und werden zwecks 3-D Secure Authentifizierung zu ihrem Kreditkartenherausgeber umgeleitet.
- Unser System erhält das Ergebnis der 3-D Authentifizierung vom Kreditkartenherausgeber.
- Wir verarbeiten die Transaktion und erhalten das Ergebnis vom Acquirer.
- Wir leiten Ihren Kunden um zu Ihrer returnUrl.
- Sie fragen das Ergebnis der Transaktion via GetPayment bei unserer Plattform an oder Sie erhalten das Ergebnis via Webhooks.
- Wenn die Transaktion erfolgreich verlaufen ist, können Sie die Güter / Dienstleistungen ausliefern.
Testdaten
In unseren Testszenarios finden Sie Testdaten und detaillierte Instruktionen.
Stellen Sie sicher, den korrekten Endpunkt anzusteuern und zurück zum Live-Endpunkt zu wechseln, sobald Sie Ihre Tests abgeschlossen haben