Last update 6/09/2018

9. Payment method selection options

9.1 Payment method selection on the merchant's site

9.1.1 How to show a specific payment method

When a customer is redirected from your website/shop to our secure payment page, he will be presented with the payment methods that are activated in your ePDQ account.

However, if you want the selection of the payment methods to be done on your own website instead of on our payment page, you can send us the payment method name and/or brand in the hidden fields. In that case, we will only show this particular payment method on our payment page and the customer will be allowed to only pay with this payment method.

The additional hidden fields that you will send are the following:

<input type="hidden" name="PM" value="">
<input type="hidden" name="BRAND" value="">

Field
Description
PM
Payment method or payment method group (e.g. credit card)
BRAND
Payment method brand (e.g. VISA)

Depending on the payment method, you will have to send both fields or only one of them. In many cases the PM and BRAND have the same value, in which case you can send only the PM or only the BRAND.

Examples

  • Hidden fields in the event that you want your customer to pay with VISA:

<input type="hidden" name="PM" value="CreditCard ">
<input type="hidden" name="BRAND" value="VISA">

  • Hidden fields in the event that you only want your customer to pay by credit card (other payment methods than credit cards won't be displayed):

<input type="hidden" name="PM" value="CreditCard ">
<input type="hidden" name="BRAND" value="">

  • Hidden fields in the event that you want your customer to pay with iDEAL:

<input type="hidden" name="PM" value="iDEAL">
<input type="hidden" name="BRAND" value="">

OR

<input type="hidden" name="PM" value="">
<input type="hidden" name="BRAND" value="iDEAL">

9.1.2 How to return from the payment page to the payment method selection screen

If the customer selects the payment method on your website, we will only present the selected payment method on the payment page to the customer.

If the payment with this payment method is unsuccessful and the customer would like to try using another payment method, he will not be presented with a list of your payment methods on our secure payment page, as the payment method selection took place on your website (and not on our secure payment page).

Therefore, to redirect the customer to a URL on your own website, where he can select another payment method, you can use the "BACKURL".

With the BACKURL, when the customer clicks the “Back” button on our secure payment page, after the authorisation has been declined or after having cancelled from a third-party or bank website, we redirect him to the URL you have entered for the “BACKURL”.

Note: The "back" button described in this section is the back button in our secure payment pages, NOT the back button of the browser.

You can enter the “BACKURL” specified in the "Payment page" tab of your account's “Technical information” page.

However if you prefer not to always use the same URL, you can also send us a specific “BACKURL” in the hidden fields. The “BACKURL” sent in the hidden fields will override the general “BACKURL” entered in your account.

You can send the “BACKURL” in the following hidden field:
<input type="hidden" name="BACKURL" value="">

Field
Usage
BACKURL
URL of the web page to display to the customer when he clicks the “Back” button on our secure payment page.

If the customer selects the payment method on our secure payment page and not on your website, the “BACKURL” is not taken into account. Consequently, when the customer clicks the “Back” button on our secure payment page, he will simply be redirected to our secure payment method selection page.

9.2 Show a specific list of payment methods

If the customer is to select the payment method from a specific list of payment methods on our payment page, you can send us this list of payment methods in the hidden fields, so we will only show these specific payment methods on our payment page.

The hidden field is the following:

<input type="hidden" name="PMLIST" value="">

Field
Description
PMLIST
List of selected payment methods and/or credit card brands. Separated by a “;” (semicolon).

Example

If you only want your customer to choose between VISA and iDEAL on our payment page (i.e. if you also have other payment methods that you don’t want to be displayed), the hidden field and its value will be:

<input type="hidden" name="PMLIST" value="VISA;iDEAL">

9.3 Exclude specific payment methods

If you wish to not present a specific payment method to the customer, you can use a hidden field to do so. This is particularly useful for sub-brands, when you want to accept a brand (e.g. MasterCard) but not one of its sub-brands (e.g. Maestro).

The hidden field is the following:

<input type="hidden" name="EXCLPMLIST" value="">

Field
Description
EXCLPMLIST
List of payment methods and/or credit card brands that should NOT be shown. Separated by a “;” (semicolon).

9.4 Layout of the payment methods

You can arrange the layout/list of the payment methods on our payment page using the following hidden field:

<input type="hidden" name="PMLISTTYPE" value="">

Field
Possible values
PMLISTTYPE
The possible values are 0, 1 and 2:
  • 0: Horizontally grouped logos with the group name on the left (default value)
  • 1: Horizontally grouped logos with no group names
  • 2: Vertical list of logos with specific payment method or brand name

9.5 Window for 3-D Secure

9.5.1 3-D Secure v1.0

If you have payment methods with 3-D Secure enabled, you can choose how you want the identification page to be displayed to the customer by sending us an extra parameter in the hidden fields.

The hidden field is the following:

<input type="hidden" name="WIN3DS" value="">

Field
Possible values
WIN3DS
  • “MAINW”: to display the identification page in the main window (default value);
  • “POPUP”: to display the identification page in a POPUP window and return to the main window at the end.

Important

Please note that for some payment methods (e.g. Visa, MasterCard, JCB, etc.), the ‘POPUP’ value is not allowed and will be converted into ‘MAINW’ by the system. We recommend explicitly testing the behaviour of this field for every payment method. 

9.5.2 3-D Secure v2.1 (Available in TEST)

In addition to the previously requested parameter (WIN3DS), it is highly recommended to include the following parameter. It contains the preconfigured sizes for width x height in pixels of the window displayed in the Cardholder browser window.

Note: If you don't send this parameter, then the default value will be 05 = Full screen.

Parameter
Possible values
Mpi.challengeWindowSize
  • 01 = 250 x 400
  • 02 = 390 x 400
  • 03 = 500 x 600
  • 04 = 600 x 400
  • 05 = Full screen

In order to make the 3DS v2 approach to risk evaluation more effective, we recommend that you send in additional parameters as described in the list here. Providing these parameters can have a direct impact on your conversion rate as they can help authenticate the cardholder without being redirected. For more information refer to the DirectLink 3DS guide.

You can use the following test card to simulate a 3-D Secure registered card in our test environment:

Frictionless Flow

Brand Card number Expiry date
VISA 4186455175836497 Any date in the future
Mastercard
5137009801943438 Any date in the future
American Express
375418081197346 Any date in the future

Challenge Flow

Brand Card number Expiry date
VISA 4874970686672022 Any date in the future
Mastercard
5130257474533310 Any date in the future
American Express
379764422997381 Any date in the future

Note: More test cards numbers can be downloaded here.

9.6 Split credit/debit cards

The functionality to split VISA and MasterCard into a debit and a credit payment method allows you to offer them to your customers as two different payment methods (e.g. VISA Debit and VISA Credit), or you can decide only to accept one of both split brands.

To use the split of credit and debit cards via e-Commerce, you need to include the CREDITDEBIT parameter in the hidden fields that you send to the payment page (and therefore also include in the SHA-IN calculation!).

Field Format
CREDITDEBIT "C": credit card
"D": debit card

Related error: When the buyer selects the debit card method but next enters a credit card number, an error code will be returned: ‘Wrong brand/Payment method was chosen’.

If the payment is successfully processed with the CREDITDEBIT parameter, the same parameter will also be returned in the post-sale feedback. However, whereas the submitted values are C or D, the return values are "CREDIT" or "DEBIT".

You will also find these return values in transaction overview via "View transactions" and "Financial history", and in reports you may download afterwards.

Configuration in your account

The split functionality can also be activated and configured per payment method, in your ePDQ account. Go to Split Credit/Debit Cards for more information.

*Call Charges: The following is a guide to call charge information from Business landlines within the UK.

Barclaycard is a trading name of Barclays Bank PLC. Barclays Bank PLC is authorised by the Prudential Regulation Authority and regulated by the Financial Conduct Authority and the Prudential Regulation Authority (Financial Services Register number: 122702). Registered in England. Registered No. 1026167. Registered office: 1 Churchill Place, London E14 5HP

Barclays Bank PLC subscribes to the Lending Code which is monitored and enforced by the Lending Standards Board. Further details can be found at www.lendingstandardsboard.org.uk escape arrow


© Barclaycard 2016