Migrate to Direct
Why migrate?
We strive to offer the best service possible for online transaction processing. Our legacy solution has served you well for the last two decades. However, to continue providing first-class service, we will be shutting down the legacy platform and focusing entirely on our Direct solution.
To ensure uninterrupted service and to remain on top of the game, it is essential that you migrate to our Direct solution. This transition will require some effort on your part, but you will be well rewarded, as Direct
- Is actively developed and continuously enhanced new tools, payment methods and features.
- Implements a state-of-the-art REST API
- Follows a "mobile first" approach for all our features.
- Complies with the latest payment industry standards and GDPR requirements, ensuring both security and privacy.
Legacy integration settings
You will continue to use your existing account for both PROD (live) and PREPROD (test) in Direct. However, this will require some reconfiguration. To understand the necessary steps, follow the migration instructions outlined below.
Legacy migration steps
Your journey with Direct begins with these basic steps:
- Activate Direct on your existing PREPROD (test) account
- Review payment methods configuration for Direct
- Select your Direct integration method
- Start migration through SDKs or plugins
- Go live
Activate Direct on your existing PREPROD (test) account
You can keep using your existing PREPROD (test) account to get started. To activate Direct in your PREPROD (test) account, follow these steps:
- Log in to the PREPROD (test) Back Office.
- Go to Configuration > Account > Your options.
- 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.
Review payment methods configuration for Direct
Regarding your current configured payment methods, there are three scenarios:
- Payment methods that will function without any changes.
- Payment methods that require configuration updates.
- Payment methods that are no longer supported.
With Direct, you will also have access to new payment methods.
Payment methods that will function without any changes
You can already start using the following payment methods using our Direct API:
- All credit cards (American Express, Cartes Bancaire, Diners Club, Discover, JCB, Maestro, MasterCard, UPI, Visa) except Atu, Airplus and purchasing cards.
- Bancontact
- iDeal
- Twint
- Klarna
- Limonetik payment methods
Oney 3x-4x
Oney Financement Long
OneyBrandedGiftCard
Chèque-Vacances Connect
FloaPay
Illicado
Cadhoc
Payment methods that require configuration updates
Some payment methods require extra configuration steps:
Once activated for Direct, these payment methods will stop working on legacy. Activate them only when you are prepared to transition to Direct. To exclude them on legacy, use the parameter "EXCLPMLIST" (example: EXCLPMLIST=PayPal;Przelewy24;Eps;POSTFINANCEefinance).
To activate these payment methods for Direct, follow these steps:
- Log in to the Back Office.
- Go to Go to Configuration > Payment methods.
- In "Selected payment methods", click on the "Edit" button for the payment method you want to configure.
- Fill in the missing information in the subsequent screen. Click on "SUBMIT" to confirm.
Payment methods that are no longer supported
Some payment methods are no longer supported as they have been replaced by newer options.
You can activate them in PREPROD (test) on your own. However, for PROD (live), contact the payment method provider to sign a contract and activate the payment method.
KBC Online
|
|
Direct Debit
|
|
Direct eBanking DE |
|
FacilyPay 3x
|
|
Ancv |
|
in3 |
|
Banque Casino 4x |
Some payment methods are no longer supported and do not have any replacements:
- Pass ES
- Visa purchasing card
- Direct eBanking AT
- American Express CPC
- Direct eBanking
- Open Invoice NL
- PaySafeCard
- Direct eBanking BE
- Direct eBanking CH
- AirPlus
- MasterCard pc cm cic
- FashionCheque
- Atu
- Direct eBanking NL
- Direct eBanking FR
- GiroPay
- Ikano
- Direct eBanking IT
New payment methods
Direct features the latest trends in payment methods:
Select your Direct integration method
Based on your legacy integration methods choose you are currently using. Refer to our dedicated guide to identify the legacy integration method you are currently using.
Comparison table - Legacy to Direct
This table will help you pick the right one. Follow the respective link to learn more about the integration method:
Hosted payment page |
Hosted Checkout PageRedirect your customers from your checkout page to our platform for entering sensitive payment data. |
Flexcheckout |
Hosted Tokenization PageInclude an iFrame payment form hosted on our safe environment in your checkout page for entering sensitive payment data. |
Directlink |
Server-to-serverSend credit card data directly from your server to our platform. |
e-Terminal (Virtual terminal) |
New integration options
These are Direct-specific features and a key reasons to migrate if you want easier integration methods. From no code solutions to native mobile solutions.
Pay-by-link
Use our no-code solution to create payment links with just a few clicks.
Mobile/Client Integration
Develop state-of-the-art mobile apps with our Client SDK.
Are you all set? Then let us explain how you can build your integration.
Start migration through SDKs or plugins
Once you have chosen your Direct integration method(s), you can create the necessary infrastructure in your system. Direct offers various options to link your webshop software to our platform. Regardless of your current on your setup, either our plugins or Software Development Kits (SDKs) will prove highly useful and convenient:
Use our Plugins
The ideal short cut: Install one of our plugins you can use in parallel with the legacy version, providing a seamless link between your webshop and our platform.
By effectively wrapping our RESTful API, these plugins save you time on writing code and make integration quick and easy.
Jump right to the respective guide and get it up and running!
Use our SDKs
Use our Server SDKs to seamlessly connect your server environment to the Ingenico Direct platform's Server API. These SDKs simplify the API's functionality with easy-to-use platform-specific objects.
Create Custom Integrations
Freeing you from any possible dependency, all our REST API endpoints are also directly accessible via a specific authentication process.
Go live
Have you completed your integration on PREPROD (test)? Now it's time to migrate your PROD (live) account.
Now you need to replicate the configuration you established on PREPROD (test) by following the steps outlined in the "Legacy Migration Steps" chapter, using your PROD (live) account.
Mind that any errors could disrupt the payment flow of your legacy integration, so proceed with caution.
You're all set, now what? Start enjoying all the advantages of Direct!
- Effective fraud prevention modules.
- Manifold advanced features.
- Best practices guide lines.