Related topics

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 Ingenico ePayments 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.

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.

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

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.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 Ingenico ePayments account. Go to Split Credit/Debit Cards for more information.

Ingenico ePayments is the online and mobile commerce division of Ingenico Group. We connect merchants and consumers, enabling businesses everywhere to go further beyond today’s boundaries and creating the future of global commerce. As industry leaders since 1994, our innovative spirit drives us forward across all channels. We are the trusted partner of over 65,000 small and large merchants who rely on us to make payments easy and secure for their customers. With advanced data analytics, fraud management solutions and cross-border commerce expertise, we help merchants optimize their business and grow into new markets around the world.

Learn more

This website uses cookies to be able to give you the best user experience. If you don't want to accept these cookies, we allow you to change the cookie settings. Click 'Accept' to allow all cookies from this website.