Worldpay - Cards

This page presents all information related to the Worldpay connection using Cards as payment. Use the following buttons to navigate to the desired section.

Connecting with Yuno

Mandatory fields when integrating via Yuno:

card_holder_name
ip_address
*However, the provider may request additional fields according to the merchant or to improve the approval rate.

General information

Countries:

Albania-flag
Albania
Åland Islands-flag
Åland Islands
Algeria-flag
Algeria
American Samoa-flag
American Samoa
Andorra-flag
Andorra
Angola-flag
Angola
Anguilla-flag
Anguilla
Antigua and Barbuda-flag
Antigua and Barbuda
Argentina-flag
Argentina
Armenia-flag
Armenia
Aruba-flag
Aruba
Australia-flag
Australia
Austria-flag
Austria
Azerbaijan-flag
Azerbaijan
Bahamas-flag
Bahamas
Bahrain-flag
Bahrain
Bangladesh-flag
Bangladesh
Barbados-flag
Barbados
Belarus-flag
Belarus
Belgium-flag
Belgium
Belize-flag
Belize
Benin-flag
Benin
Bermuda-flag
Bermuda
Bhutan-flag
Bhutan
Bolivia-flag
Bolivia
Bosnia and Herzegovina-flag
Bosnia and Herzegovina
colomBotswanabia-flag
Botswana
Brazil-flag
Brazil
British Indian Ocean Territory-flag
British Indian Ocean Territory
Brunei Darussalam-flag
Brunei Darussalam
Bulgaria-flag
Bulgaria
Burkina Faso-flag
Burkina Faso
Burundi-flag
Burundi
Cabo Verde-flag
Cabo Verde
Cameroon-flag
Cameroon
Canada-flag
Canada
Cayman Islands-flag
Cayman Islands
Central African Republic-flag
Central African Republic
Chad-flag
Chad
Chile-flag
Chile
China-flag
China
Christmas Island-flag
Christmas Island
Cocos (Keeling) Islands-flag
Cocos Islands
colombia-flag
Colombia
Comoros-flag
Comoros
cook Islands-flag
Cook Islands
Costa Rica-flag
Costa Rica
Croatia-flag
Croatia
Cyprus-flag
Cyprus
Czechia-flag
Czechia
Denmark-flag
Denmark
Djibouti-flag
Djibouti
Dominican Republic-flag
Dominican Republic
Ecuador-flag
Ecuador
Egypt-flag
Egypt
El Salvador-flag
El Salvador
Equatorial Guinea-flag
Equatorial Guinea
Estonia-flag
Estonia
Ethiopia-flag
Ethiopia
Falkland Islands-flag
Falkland Islands
Faroe Islands-flag
Faroe Islands
Fiji-flag
Fiji
Finland-flag
Finland
France-flag
France
French Guiana-flag
French Guiana
French Polynesia-flag
French Polynesia
French Southern Territories-flag
French Southern Territories
Gabon-flag
Gabon
Gambia-flag
Gambia
Georgia-flag
Georgia
Germany-flag
Germany
Ghana-flag
Ghana
Gibraltar-flag
Gibraltar
Greece-flag
Greece
Greenland-flag
Greenland
Grenada-flag
Grenada
Guadeloupe-flag
Guadeloupe
Guam-flag
Guam
Guatemala-flag
Guatemala
Guernsey-flag
Guernsey
Guinea-flag
Guinea
Guinea-Bissau-flag
Guinea-Bissau
Guyana-flag
Guyana
Haiti-flag
Haiti
Holy See-flag
Holy See
Honduras-flag
Honduras
Hong Kong-flag
Hong Kong
Hungary-flag
Hungary
Iceland-flag
Iceland
India-flag
India
Indonesia-flag
Indonesia
Ireland-flag
Ireland
Isle-flag
Isle
Israel-flag
Israel
Italy-flag
Italy
Jamaica-flag
Jamaica
Jordan-flag
Jordan
Kazakhstan-flag
Kazakhstan
Kenya-flag
Kenya
Kiribati-flag
Kiribati
Korea-flag
Korea
Kuwait-flag
Kuwait
Kyrgyzstan-flag
Kyrgyzstan
Lao People’ Democratic Republic-flag
Laos
Latvia-flag
Latvia
Lesotho-flag
Lesotho
Liechtenstein-flag
Liechtenstein
Lithuania-flag
Lithuania
Luxembourg-flag
Luxembourg
Macao-flag
Macao
Macedonia-flag
Macedonia
Madagascar-flag
Madagascar
Malawi-flag
Malawi
Malaysia-flag
Malaysia
Maldives-flag
Maldives
Mali-flag
Mali
Malta-flag
Malta
Marshall Islands-flag
Marshall Islands
Martinique-flag
Martinique
Mauritania-flag
Mauritania
Mauritius-flag
Mauritius
Mayotte-flag
Mayotte
Mexico-flag
Mexico
Micronesia-flag
Micronesia
Moldova-flag
Moldova
Monaco-flag
Monaco
Mongolia-flag
Mongolia
Montenegro-flag
Montenegro
Montserrat-flag
Montserrat
Morocco-flag
Morocco
Mozambique-flag
Mozambique
Namibia-flag
Namibia
Nauru-flag
Nauru
Nepal-flag
Nepal
Netherlands-flag
Netherlands
New Caledonia-flag
New Caledonia
New Zealand-flag
New Zealand
Nicaragua-flag
Nicaragua
Niger-flag
Niger
nigeria-flag
Nigeria
Niue-flag
Niue
Norfolk Island-flag
Norfolk Island
Northern Mariana Islands-flag
Northern Mariana Islands
Norway-flag
Norway
Oman-flag
Oman
Pakistan-flag
Pakistan
Palau-flag
Palau
Panama-flag
Panama
Paraguay-flag
Paraguay
Peru-flag
Peru
Philippines-flag
Philippines
Pitcairn-flag
Pitcairn
Poland-flag
Poland
Portugal-flag
Portugal
Puerto Rico-flag
Puerto Rico
Qatar-flag
Qatar
Romania-flag
Romania
Russian Federation-flag
Russian Federation
Rwanda-flag
Rwanda
Réunion-flag
Réunion
Saint Kitts and Nevis-flag
Saint Kitts and Nevis
Saint Lucia-flag
Saint Lucia
Saint Vincent and the Grenadines-flag
Saint Vincent and the Grenadines
Samoa-flag
Samoa
San Marino-flag
San Marino
Sao Tome and Principe-flag
Sao Tome and Principe
Saudi Arabia-flag
Saudi Arabia
Senegal-flag
Senegal
Serbia-flag
Serbia
Seychelles-flag
Seychelles
Sierra Leone-flag
Sierra Leone
Singapore-flag
Singapore
Slovakia-flag
Slovakia
Slovenia-flag
Slovenia
Solomon Islands-flag
Solomon Islands
South Africa-flag
South Africa
Spain-flag
Spain
Sri Lanka-flag
Sri Lanka
Swaziland-flag
Swaziland
Sweden-flag
Sweden
Switzerland-flag
Switzerland
Tajikistan-flag
Tajikistan
Tanzania-flag
Tanzania
Thailand-flag
Thailand
Togo-flag
Togo
Tokelau-flag
Tokelau
Tonga-flag
Tonga
Trinidad and Tobago-flag
Trinidad and Tobago
Turkey-flag
Turkey
Turkmenistan-flag
Turkmenistan
Turks and Caicos Islands-flag
Turks and Caicos Islands
Tuvalu-flag
Tuvalu
Uganda-flag
Uganda
Ukraine-flag
Ukraine
United Arab Emirates-flag
United Arab Emirates
United Kingdom-flag
United Kingdom
United States-flag
United States
Uruguay-flag
Uruguay
Uzbekistan-flag
Uzbekistan
Vanuatu-flag
Vanuatu
Venezuela-flag
Venezuela
Vietnam-flag
Vietnam
Virgin Islands-flag
Virgin Islands
Wallis and Futuna-flag
Wallis and Futuna
Western Sahara-flag
Western Sahara
Yemen-flag
Yemen
Zambia-flag
Zambia

Currencies:

ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ISK, JPY, KES, KRW, MXN, MYR, NOK, NZD, PHP, PLN, SEK, SGD, THB, TWD, USD, VND, ZAR

Payment methods:

Credit card
Credit card
debit card
Debit card
Prepaid card
Prepaid card

TRX without CVV:

Yes

Purchase TRX in 1-Step:

Yes

Purchase TRX in 2-Step:

Yes

Support for recurrency:

Yes

Particularities:

  • Can only be performed as a follow up from an original card on file payment when your customer was authenticated and agreed to a standing instruction.
  • You must declare the intent for all recurring payments, either: subscription, instalment or unscheduled.

Webhooks:

Yes

Captures

Partial capture:

Yes

Multiple captures:

In general only one capture (partial or full) can be done for each authorised payment. You may have a special arrangement with Worldpay, which enables you to perform multiple partial captures on a single order.

Maximum time to capture an authorization:

14 days (a setting of no more than four days is highly recommended).

Captures over the amount of authorization:

No

Refunds

Refund support:

Yes

Partial refunds:

Yes

Multiple refunds:

Yes

Time to process refund:

3-6 weeks to be processed depending on the acquirer.

Voids

Void support:

Yes

Void to authorization:

Yes

Installments

Capability to define the installments when creating the payment:

Yes

Additional considerations of installments:

If you're allowing your shoppers to pay in installments, you can choose a different first installment amount. This is useful if you want to add a shipping or processing fee. This is not available with all acquirers in Latin America. Please consult your Implementation Manager before using this feature.

Number of installments (#months):

Depends on agreement of merchant with acquirer. In LATAM:
  • Brazil and Argentina: Up to 12 instalments.
  • Mexico: Up to 18 sequential instalments: 3, 6, 9, 10, 12, 15, 18.
  • Colombia: Up to 12 instalments without interest. Up to 48 instalments with interest. Sequential instalments: 3,6,9,10,12,18,24,36,48.
  • Peru and Central America: Up to 48 sequential instalments: 3, 6, 9, 10, 12, 18, 24, 36, 48.

Chargebacks

Notifications of chargebacks:

Yes

Defined period to make a chargeback:

A shopper can dispute a payment up to six months (sometimes longer) after the payment.

Endpoint for disputes:

Yes

Maximum time to dispute a chargeback (provide evidence):

Normally you have 12 days to defend the chargeback.

Security

Address verification service:

Yes

Support for 0Auth:

Yes

E3DS v2:

Yes

Testing guidelines for sandbox environment

Necessary fields for testing:

Merchant Code, Username and Password

Test cards:

Card type Test card number
Airplus 122000000000003
American Express 343434343434343
Cartebleue 5555555555554444
China Union Pay 6221260062379699
Dankort 5019717010103742
Diners 36700102000000
36148900647913
Discover card 6011000400000000
JCB 3528000700000000
Maestro 6759649826438453
MasterCard 5555555555554444
5454545454545454
2221000000000009
MasterCard Debit 5163613613613613
Visa 4444333322221111
4911830000000
4917610000000000
Visa Debit 4462030000000000
4917610000000000003
Visa Electron (UK only) 4917300800000000
Visa Purchasing 4484070000000000

Brazil test cards:

Card type Test card number
ELO 4514 1600 0000 0003
6550 0000 0000 0001
Hipercard 3841 0011 1122 2233 334
6062 8288 8866 6688
Aura As the Aura card is paired with Mastercard, and because it shares the same payment method mask, you will be able to submit Mastercard test card numbers to test your integration.

Argentina test cards:

Card type Test card number
Argencard 5010 9100 0000 0007
5010 9500 0000 0006
5011 0500 0000 0009
5011 0800 0000 0005
5011 1000 0000 0009
Cabal 5896 5700 0000 0004
6035 2200 0000 0006
6042 0000 0000 0004
6043 0100 0000 0008
Cencosud 6034 9300 0000 0002
Coope Plus 6274 0100 0000 0007
Credimas 5045 2000 0000 0002
Italcred 5043 3800 0000 0005
Naranja 5895 6200 0000 0002
Nativa 4870 1700 0000 0004
Nevada 5043 6300 0000 0007
Nexo 6049 4000 0000 0003
6281 6100 0000 0008
Tarjeta Shopping 5894 0700 0000 0004

Limitations/ Specifications for testing:

With these cards you can specify an expiry date up to seven years in the future. These cards do not have an issue number, a registered address or a card verification code (use the following CVC/CVV):

Testing CVC/CVV:
Magic value CVC/CVV result code CVC/CVV result description
[Left blank] B - CVV/CVC not supplied by shopper/merchant NOT SUPPLIED BY SHOPPER
111 C - CVV/CVC not checked NOT SENT TO ACQUIRER
222 C - CVV/CVC not checked NO RESPONSE FROM ACQUIRER
333 C - CVV/CVC not checked NOT CHECKED BY ACQUIRER
444 D - CVV/CVC not matched FAILED
555 A - CVV/CVC matched APPROVED
Testing CVC/CVV for American Express:
Magic value CVC/CVV result code CVC/CVV result description
[Left blank] B - CVV/CVC not supplied by shopper/merchant NOT SUPPLIED BY SHOPPER
1111 C - CVV/CVC not checked NOT SENT TO ACQUIRER
2222 C - CVV/CVC not checked NO RESPONSE FROM ACQUIRER
3333 C - CVV/CVC not checked NOT CHECKED BY ACQUIRER
4444 D - CVV/CVC not matched FAILED
5555 C - CVV/CVC not checked UNKNOWN
6666 A - CVV/CVC matched APPROVED

Integration configuration

Credentials and steps to obtain them:

  • Merchant Code: Your Implementation Manager (or support contact) at Wordlpay should have given you a merchantCode.
  • Other credentials:
    1. Log in to the Merchant Administration Interface (Sandbox and Production).
    2. Click ACCOUNT, then select Profile from the top menu.
    3. Note your New Username for the connection.
    4. Click the pencil icon next to XML Password.
    5. Enter your new password and click Save XML Password.

Configuration of webhooks in partner:

  1. Log in to the production Merchant Administration Interface (Production).
  2. *Note: To set up notifications in both the test and production environments, you need to log in to the production MAI.
  3. Click INTEGRATION, then select Merchant Channel from the top menu.
  4. In the Merchant Channels (Production and Test) areas:
    1. Activate the http channel and select xml under Content.
    2. Enter the Address to receive test and production notifications.
  5. In the Merchant Channel Events (Production and Test) areas, select the payment statuses you want to receive notifications on.