Click here to search the entire website

Useful tables

On this page:

Payment method codes

To determine which payment methods the shopper can use, you can use either:

  • The <paymentMethodMask> variable

  • The <preferredPaymentMethod> variable

The card payment method codes are shown in the tables below.

Note:  Payment methods supported by our Hosted Payment Pages are listed in Hosted Payment Page useful tables.

For the full list of payment methods, see the Worldpay DTD at http://dtd.worldpay.com/v1/. For more information about supported alternative payment methods, see the alternative payment methods (APM) guide.

Submission codes

Payment method

Payment method code

Area

Any card (e.g. card not known) CARD-SSL International

American Express

AMEX-SSL

International

Visa

VISA-SSL

International

Mastercard

ECMC-SSL

International

AirPlus

AIRPLUS-SSL

International

Aurore

AURORE-SSL

International

Carte Bancaire

CB-SSL

France

Carte Bleue

CARTEBLEUE-SSL

France

Dankort

DANKORT-SSL

Denmark

Diners

DINERS-SSL

International

Discover Card

DISCOVER-SSL

United States

GE Capital

GECAPITAL-SSL

International

Maestro

MAESTRO-SSL

International

Japanese Credit Bank (JCB)

JCB-SSL

International

UATP

UATP-SSL

International

Response codes

Following a PAN check, we can also return these sub-card values for Visa and Mastercard cards:

Sub-card type

Payment method code

Area

Visa credit card

VISA_CREDIT-SSL

International

Visa debit card

VISA_DEBIT-SSL

International

Visa commercial credit card

VISA_COMMERCIAL_CREDIT-SSL

International

Visa commercial debit card

VISA_COMMERCIAL_DEBIT-SSL

International

Visa electron card

VISA_ELECTRON-SSL

International

Mastercard credit card

ECMC_CREDIT-SSL

International

Mastercard debit card

ECMC_DEBIT-SSL

International

Mastercard commercial credit card

ECMC_COMMERCIAL_CREDIT-SSL

International

Mastercard commercial debit card

ECMC_COMMERCIAL_DEBIT-SSL

International

ISO country codes

The country codes that can be used by the Worldwide Payment Gateway are listed below. To see whether your setup can integrate with these countries, speak to your Implementation Manager.

 

ISO currency codes

The currency codes that can be used by the Worldwide Payment Gateway are listed below. To see whether your setup can integrate with these currencies (and in what capacity), speak to your Implementation Manager.

The values in the orders sent to Worldpay use exponent instead of decimal delimiters. The currency code is always presented in capitals.

 

ISO 8583 response codes

We use ISO 8583 response codes (standard or extended) in order notifications to indicate the status of a payment.

Note:  Extended response codes are available in most circumstances, although they may need activating. For details, contact your Relationship Manager.

 

ECI response codes

If you have contacted us to display these in your XML, these are the Electronic Commerce Indicator values returned from the schemes to indicate the 3DS authentication result:

Visa/Amex/JCB MasterCard Description
05 02 Cardholder and issuing bank are 3D Secure. 3DS Authentication successful
06 01 Either cardholder or issuing bank not registered for 3DS
07 00 Cardholder and issuing bank not registered for 3DS

Test card numbers

For use in our test environment. 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 CVC/CVV and AVS numbers below).

Card type

Test card number

Airplus

122000000000003

American Express

343434343434343

Cartebleue

5555555555554444

Dankort

5019717010103742

Diners

36700102000000 and 36148900647913

Discover card

6011000400000000

JCB

3528000700000000

Maestro

6759649826438453 and 67999990100000000019

MasterCard

5555555555554444, 5454545454545454 and 2221000000000009

MasterCard Debit 5163613613613613

Visa

4444333322221111, 4911830000000 and 4917610000000000

Visa Debit

4462030000000000 and 4917610000000000003

Visa Electron (UK only)

4917300800000000

Visa Purchasing

4484070000000000

Card payout test values

Mastercard PT

Result description Magic value (Amount) Card type (see Test card numbers section above) Currency
AUTHORISED 1000 Mastercard, Mastercard Debit, Maestro MID settlement currency
REFUSED 310 Mastercard, Mastercard Debit, Maestro MID settlement currency
ERROR 320 Mastercard, Mastercard Debit, Maestro MID settlement currency

Issuer response test values

Input these magic values in:

  • <cardHolderName> (Direct model)

  • The Cardholder's name field on the test payment page (Hosted model)

The results come back in <ISO8583ReturnCode>, and you can view them in:

  • The test payment response (Direct)

  • Notifications

  • Inquiries

  • The test MAI

Magic value Result code Result description
AUTHORISED N/A AUTHORISED
REFUSED N/A REFUSED
ERROR N/A ERROR
REFUSED4 4 HOLD CARD
REFUSED5 5 REFUSED
REFUSED8 8 APPROVE AFTER IDENTIFICATION
REFUSED13 13 INVALID AMOUNT
REFUSED15 15 INVALID CARD ISSUER
REFUSED17 17 ANNULATION BY CLIENT
REFUSED28 28 ACCESS DENIED
REFUSED29 29 IMPOSSIBLE REFERENCE NUMBER
REFUSED33 33 CARD EXPIRED
REFUSED34 34 FRAUD SUSPICION
REFUSED38 38 SECURITY CODE EXPIRED
REFUSED41 41 LOST CARD
REFUSED43 43 STOLEN CARD, PICK UP
REFUSED51 51 LIMIT EXCEEDED
REFUSED55 55 INVALID SECURITY CODE
REFUSED56 56 UNKNOWN CARD
REFUSED57 57 ILLEGAL TRANSACTION
REFUSED62 62 RESTRICTED CARD
REFUSED63 63 SECURITY RULES VIOLATED
REFUSED75 75 SECURITY CODE INVALID
REFUSED76 76 CARD BLOCKED
REFUSED85 85 REJECTED BY CARD ISSUER

3D Secure (3DS) test values

Input these magic values in:

  • <cardHolderName> (Direct model)

  • The Cardholder's name field on the test payment page (Hosted model)

The 3DS results come back in <ThreeDSecureResult>, and you can view them in:

  • The test payment response (Direct)

  • Notifications

  • Inquiries

  • The test MAI

Note:  You can combine the below values with the issuer response values in the table above. Do this by appending the issuer response value to "3D" or "NO3D", separated by a "." For example, to create a Cardholder authenticated - 13 INVALID AMOUNT response, use the magic value: 3D.REFUSED13 and choose Cardholder authenticated on the simulator page. To create a Authentication Offered but not Used - 41 LOST CARD response, you can use NO3D.REFUSED41:

Magic value 3DS result
3D Invokes the 3D Secure simulator page, where you can select values to simulate the authentication result
NO3D

Bypasses the 3D secure simulator page, instead simulating either:

  • Authentication Offered but not Used

  • Ecommerce

Note:  "Authentication Offered but not Used" applies to Verified by Visa and Mastercard SecureCode, whereas "Ecommerce" applies only to American Express SafeKey.

CVC/CVV and AVS test values

Testing CVC/CVV

Input these magic values in:

  • <cvc> (Direct model)

  • The Security code field on the test payment page (Hosted model)

The response values come back in <CVCResultCode>, and you can view them in:

  • The test payment response (Direct)

  • Notifications

  • Inquiries

  • The test MAI

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 (American Express)

Input these magic values in:

  • <cvc> (Direct model)

  • The Security code field on the test payment page (Hosted model)

The result codes come back in <CVCResultCode>, and you can view them in:

  • The test payment response (Direct)

  • Notifications

  • Inquiries

  • The test MAI

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

Testing AVS

Input these magic values in:

  • <postalCode> (Direct model)

  • The Post code/Zip code field on the test payment page (Hosted model)

The response codes come back in AVSResultCode>:

  • The test payment response (Direct)

  • Notifications

  • Inquiries

  • The test MAI

Magic value

Response code

Descriptive response

Meaning

AAAA

A

APPROVED

Postcode and address matched

BBBB

B

PARTIAL APPROVED

Postcode matched; address not checked

CCCC

C

PARTIAL APPROVED

Postcode matched; address not matched

DDDD

D

PARTIAL APPROVED

Address matched; postcode not checked

EEEE

E

NOT SENT TO ACQUIRER

Postcode and address not checked

FFFF

F

PARTIAL APPROVED

Address matched; postcode not matched

GGGG

G

PARTIAL APPROVED

Postcode not checked; address not matched
HHHH H NOT SUPPLIED BY SHOPPER Postcode and address not supplied by shopper/merchant
IIII I PARTIAL APPROVED Address not checked; postcode not matched
JJJJ J FAILED Postcode and address not matched
[Left blank] H NOT SUPPLIED BY SHOPPER Postcode and address not supplied by shopper/merchant
KKKK E NO RESPONSE FROM ACQUIRER Postcode and address not checked
LLLL E NOT CHECKED BY ACQUIRER Postcode and address not checked
MMMM E UNKNOWN Postcode and address not checked

Testing AAV

Input these American Express Advanced Verification magic values in:

  • <cvc> (Direct model)

  • The Security code field on the test payment page (Hosted model)

The response codes come back in: <AAVAddressResultCode>, <AAVPostcodeResultCode>,  <AAVCardholderNameResultCode>, <AAVTelephoneResultCode>, <AAVEmailResultCode>, and you can view them in:

  • The test payment response (Direct)

  • Notifications

  • Inquiries

  • The test MAI

Magic value

Response code

Descriptive response

Meaning

Y

A

SHOPPER DATA MATCHES

Data matched

N

D

SHOPPER DATA DOES NOT MATCH

Data not matched

X

C

DATA NOT SENT

Data not sent to acquirer

U

B

DATA NOT CHECKED BY ACQUIRER

Data not checked by acquirer
[Left blank] B UNKNOWN Unknown