Migrate to e-Terminal

Get familiar with the e-Terminal, the payment flow and its Direct-specific features.

You can keep using your existing PREPROD (test) account to get started. To activate Direct in your PREPROD (test) account, follow these steps:

1. Log in to the PREPROD (test) Back Office.
2. Go to Configuration > Account > Your options.
3. In Available options, look for "DIR (Merchant using Ingenico Direct integration)" and click on "Activate". 

If you cannot find "DIR (Merchant using Ingenico Direct integration)", then it is activated by default. Look in the "Default options" to confirm. 

You do not have a test account yet? Get one in just a few steps.

You can upgrade to a paid account at any time.

Your account is being created and you will receive a message soon.

Cancel Create an account

Check your mail!

Check aaaaa for a link to set your password. This helps us keep your account secure.

If you cannot see the email please check your spam folder.

What's next?
After you secure your test account, you can build a test integration. The first step is deciding how to link your website with our platform.

Getting started

As the Direct e-Terminal is only available in the Merchant Portal, you need to switch from the legacy Back Office to the Merchant Portal.

You can do this easily in a few steps:

1. Login to your test account via the legacy Back Office portal.
2. Click on the "Try our new merchant portal" button in the Back Office header bar.
3. Follow the instructions on the subsequent pages.

To get you up and running, you need to makes some basic configurations in your account:

• Configure your API Key/API Secret to set up the Direct authentication mechanism. Read our dedicated guide to learn how to do this.
• Configure your Webhooks Key/Webhooks Secret to receive feedback for processed transactions. Read our dedicated guide to learn how to do this.

Access the e-Terminal in the Merchant Portal via Create payments > e-Terminal. Refer to the dedicated chapter in the Merchant Portal guide to learn how to process transactions.

Make sure your webshop infrastructure receives and processes our platform’s transaction feedback according to the payment id logic.

Direct offers Webhooks and endpoints GetHostedCheckout/GetPaymentDetails to get all information you need to follow-up on your orders.

To enhance transparency, Direct implements three properties to represent a transaction status:

• status
• statusCategory
• statusCode

For a quick manual check, look up the transactions status in the Merchant Portal. Read the dedicated chapter in our Merchant Portal guide to learn how to do this.

Check out our comprehensive Status guide for all possible return values, including a mapping of classic parameter STATUS to the aforementioned properties.

Use our Test cases to trigger specific scenarios for any given payment method. Our API Explorer allows you to build and test countless scenarios with just a few clicks!

Mind that test data / settings in the Back Office (Configuration > Technical Information > Test Info) are irrelevant for Direct.