1 Introduction
2 Create Ingenico account
3 Install plugin
4 Configure plugin
5 Select payment methods
6 Customise your payment page
7 Upgrade Plugin to use payment button

1 Introduction

As a dedicated Shopify partner, Ingenico offers you an ideal shopping cart solution: No need to bother with technical challenges, but focus on the essentials to make your business thrive!

All you need is a Shopify and an Ingenico account and start your online business in no time!

2 Create Ingenico account

To process transaction on our platform with your plugin, you need an account on our platform.

Before you process live transactions, feel free to use our test environment to learn more about our solution without costs or any commitments involved! Shopify will also work with our test environment, so this is a great way to get familiar with both the plugin and our platform.

Once you want to go live, check out here how to get a production account or contact us!

3 Install plugin

  • Go to our Shopify portal to create an account.
  • Enter your store name and click on “Install”. 

Shopify--Enter_your_store_name

 Shopify--EnterYourStoreName2

  • Click on “Install unlisted app”. The installation is executed automatically. Once done, you need to finalize the installation by entering some data in the Shopify Back Office. Check out the next chapter how to do it.

4 Configure plugin

Login to your Shopify account. Go to Apps > Ingenico ePayments Gateway > Settings. Fill in the following fields. The table below explains where you find the respective data in your Ingenico Back Office

Shopify-ConfigurePlugin

Field namePossible actions
Environment

For TEST transactions with no financial impact, select TEST. The transactions will be sent to our test environment and thereby to

your test account

For LIVE transactions with financial impact, select “Production”. The transactions will be sent to our live environment thereby to

your live account.

Make sure to switch to LIVE as soon as you have finalised your tests.

PSPID

The name of your account on our platform.

Please be aware that you might have different names for your account in our test / live environment.

Make sure to enter the name of the account of the respective environment you have configured in the “Environment” field

Title Define a title that appears on our Hosted Payment Page
Language The language used to present our Hosted Payment Page to you customers
Operation

Define whether to process the transactions as authorisations or as direct sale only

-          Authorisation: the amount is only blocked on your customer's card. Successful transactions will have status 5

-          Direct Sale: the amount has been ordered to be paid out in one go. Successful transactions will have status 9

If you authorise payments only, make sure that you capture them later. Only then the transaction will reach status 9, for which you receive the payment for the transaction. Please check our dedicate guide on how to do this

SHA-IN

The passphrase to ensure that requests sent to our platform are legitimate orders from your shop.

This is a standard check we perform before we redirect your customers to our Hosted Payment Page.

 Check this chapter in our documentation if you want to learn more.

You need to configure the exact same value in both your Shopify account and your Ingenico Back Office

(“Configuration > Technical information > Data and origin verification > Checks for e-Commerce & Alias Gateway> SHA-IN pass phrase”)

SHA-OUT

The passphrase to ensure that transaction feedback sent to your shop is legitimately sent from our platform. Your web shop will perform an automatic check each time we provide feedback on the outcome of the transactions.

Check this chapter in our documentation if you want to learn more.

 

You need to configure the exact same value in both your Shopify account and your Ingenico Back Office

(“Configuration > Technical information > Transaction feedback > All transaction submission modes > Security for request parameters”)

API user

The name of a technical user profile that is needed for performing maintenance operations (ie refunds) on your transactions.

You can find this user in your Ingenico Back Office via Configuration > Users

You need to configure the exact same value in both your Shopify account and your Ingenico Back Office. Learn here how to create your API user.

Password

The password assigned to the API user.

You can define the password of the user in your Ingenico Back Office via Configuration > Users

You need to configure the exact same value in both your Shopify account and your Ingenico Back Office. Learn here how to create your API user.

5 Select payment methods

Finally, you need to add the payment methods you want to offer to your customers. To do so,
follow these steps:

  • Login to the Ingenico Back Office. Check via Configuration > Payment methods for active payment methods. You can add all those to your Shopify account via the next steps

 Shopify--configurePaymentMethodBO

  • Login to your Shopify account. Go to Apps > Ingenico app > Install Gateway. Click on “Install” for each payment method you would like to offer to your customers. Then click on “Install payment provider

 Shopify-ConfigurePaymentMethod

  • Enter your Shopify ID and the SHA sign. Check out chapter Configure Shopify account where to find the SHA sign in our Ingenico Back Office. Click then “Save”

 Shopify-ConfigurePaymentMethod-credentials

  • Repeat these steps for any payment method that is active in your Ingenico Back Office

6 Customise your payment page

Make sure your customers go all the way through the payment stage thanks to a customised payment page. Learn how to do it here for the Hosted Payment Page.

7 Upgrade Plugin to use payment button

If you are already using our plugin version 3 (called “Ingenico ePayments Gateway"), you might be interested in upgrading it to our latest version 4 (“Ingenico Pay Buttons”).

The standard checkout process requires your customers to choose their payment method on our Hosted Payment Page. Our plugin version 4 contains a feature that allows your customers to make their choice of payment in your webshop already! Using this upgrade will make your customer’s payment experience even more seamless!

Just follow these steps to perform the upgrade

 Shopify--Enter_your_store_name

  • Login to your Shopify account. Go to Apps. Click on “Ingenico Pay Buttons Settings”.

 Shopify-UpgradeToPaymentButton

  • Click on “Install Gateway”. Click on “Install” for the payment method you want to use this feature for. If the payment method has not been added before, follow the steps as described in chapter Setup payment methods in Shopify account.

 Shopify-ConfigurePaymentMethod

  • Once you have installed all your payment methods, go to Apps > Configuration. Make sure that the following settings are still aligned with your Ingenico Back Office The screenshots in the menu itself will tell you where to find them in the Ingenico Back Office.
  • Go to Apps. Remove the old app “Ingenico ePayments Gateway

 Shopify--upgradePluginToUsePaymentButton4

Now you are all set!

If need help with the upgrade, our support team will be glad to help!