Visa
Intro
Visa is one of the world’s largest card brands that facilitates online payments in over 200 countries. Originating from Bank of America’s initiative to introduce a new unified financial instrument for consumers in 1958, it has now issued over 3.3 bln cards worldwide.
Visa Credit
Visa Credit cards are extensively used in global commerce, especially in e-commerce, subscriptions, and international transactions. They benefit from Visa’s large-scale processing network and are often associated with higher transaction values, cross-border usage, and advanced authorisation and risk management capabilities.
Visa Debit
Visa Debit cards are accepted globally across a vast network of merchants. They are issued by a wide range of financial institutions and operate on Visa’s global payment infrastructure.
Our platform offers three variants of the Visa brand, with separate PaymentProductIds / guides for each:
| Brand | PaymentProductId |
|---|---|
| Visa | 1 |
| Visa Debit | 114 |
| Visa Credit | 115 |
To offer the Visa Credit/Visa 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 Visa guide.
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
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
Sudsudan
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
We offer this payment methods for the following integration modes. Learn in our dedicated guides about their individual differences:
Find a high level overview in the "Zahlungsablauf" chapter.
Depending on the integration mode, differences apply:
Hosted Checkout Page
Add the following properties to a standard CreateHostedCheckout request:
{
"hostedCheckoutSpecificInput": {
"locale": "en_GB",
"returnUrl": "https://yourReturnUrl.com",
"cardPaymentMethodSpecificInput": {
"groupCards": true,
"clickToPay": false
},
"paymentProductFilters": {
"restrictTo": {
"groups": [
"cards"
]
}
}
},
"order": {
"amountOfMoney": {
"amount": 100,
"currencyCode": "EUR"
}
}
}| Properties | Remarks |
|---|---|
|
hostedCheckoutSpecificInput.returnURL |
The URL we redirect your customers to after the payment has been finalised. |
|
order.amountOfMoney |
amount: The gross amount you want to charge for this order. |
Find detailed information about this object and its properties in our CreateHostedCheckoutAPI.
Hosted Tokenization Page
Add the following properties to a standard CreatePayment request (including mandatory 3-D Secure properties) after you have tokenised the card:
{
"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 |
Token: The tokenised credit card credentials you have received by tokenising the credentials/getting the token. Learn more in our dedicated Hosted Tokenization Page guide. |
|
cardPaymentMethodSpecificInput.threeDSecure |
returnURL: The URL we redirect your customers to after the payment has been finalised. |
|
order.amountOfMoney |
amount: The gross amount you want to charge for this order. |
|
customer.device |
Minimum properties to comply with SCA for 3-D Secure authentication. Check our dedicated guide to learn how to request 3-D Secure correctly and our API reference for more information about the properties. |
Find detailed information about this object and its properties in our HostedTokenizationAPI/ CreatePaymentAPI.
Server-to-server
Add the following properties to a standard CreatePayment request (including mandatory 3-D Secure properties):
{
"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"
}
}
}
}
}
| Properties | Remarks |
|---|---|
|
cardPaymentMethodSpecificInput.paymentProductId cardPaymentMethodSpecificInput.card cardPaymentMethodSpecificInput.ThreeDSecure |
paymentProductId: The numeric identifier of the payment method on our platform. Find this id in the "Überblick" chapter.
returnURL: The URL we redirect your customers to after the payment has been finalised. |
|
order.amountOfMoney |
amount: The gross amount you want to charge for this order. |
|
customer.device |
Minimum properties to comply with SCA for 3-D Secure authentication. Check our dedicated guide to learn how to request 3-D Secure correctly and our API reference for more information about the properties. |
Find detailed information about this object and its properties in our CreatePaymentAPI.
Zahlungsablauf
We offer this payment method for all our integration modes. Regardless of the mode you choose, the flow follows some basic steps as described below. Learn in our dedicated guides about the individual differences:
- Your customers finalise an order in your shop and select this payment method.
- You send a CreateHostedCheckout/CreatePayment request to our platform. Depending on your integration mode, differences apply. Check out the “Integration” chapter to find examples for each mode.
- Our platform sends you a response with instructions for the next steps of the flow.
- Your customers provide their credit card number and are redirected to their issuer for 3-D Secure authentication.
- Our system receives the 3-D authentication result from the issuer.
- We process the transaction and receive the result from the acquirer.
- We redirect your customer to your returnUrl.
- You request the transaction result from our platform via GetPaymentDetails /GetHostedCheckout or receive the result via webhooks.
- If the transaction was successful, you can deliver the goods / service.
Testdaten
Refer to our Testszenarios for test data and detailed instructions.
- Make sure to use the right endpoint and switch back to the live URL as soon as you have finished your tests.
- The data in our Testszenarios ONLY work for payment requests in our test environment. Using this data in our production environment will lead to undesirable testing results.