Last update 20/04/2016

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.

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

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.

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.

Cookie settings

Introduction

Functional

Functional cookies are required for the website to operate correctly. These cookies cannot be disabled.

Optimized

Optimization cookies allow us to analyze site usage so we can measure and improve our website.
This is the default level.

Personalized

Personalization cookies are used for social media and advanced personalization. They allow us to show you information related to your company.


Example functionality allowed

  • Store country preference
  • Store language preference

Example functionality not allowed

  • Saving personal data
  • Anonymous tracking via Google Analytics
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics

Example functionality not allowed

  • Saving personal data
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics
  • Serve content relevant to your interests
  • Serve ads relevant to your interests
  • Tracking for remarketing purposes

Example functionality not allowed

  • Saving personal data