worldline Direct
Sign up
Worldline Direct Server to Server Page screen

Intro

Server-to-server is the enhanced Direct version of the legacy Directlink integration method. Featuring the most straightforward payment flow, it allows full control of the payment experience.

  • Flexible and easy visual adaptation & customisation
  • Smooth customers' payment experience when using recurring payments or our Hosted Tokenization Page solution

Make the move

Thanks to the Direct REST API's and our platform's features, migrating from the legacy DirectLink to the Direct Server-to-server integration method easy.

Use this checklist to let us guide you through the whole migration proces:

  1. Get familiar with Server to Server
  2. Set up/Create a test account
  3. Choose the way you want to implement Direct
  4. Modify the target endpoint URL
  5. Configure your test account
  6. Adapt your checkout page
  7. Make sure to receive our platform’s transaction feedback
  8. Test your new integration

Get familiar with Server to Server

Get familiar with the Server-to-server integration method, the payment flow and its Direct-specific features.

View Server to Server


Set up/Create a 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:

  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. 


Choose the way you want to implement Direct

Use our SDKs

Our Server SDKs wrap the Direct API in a highly efficient and accessible way, allowing you to create your own application easily.


Modify the target endpoint URL

Modify the target endpoint URL and the data you need to send to our platform to process transactions.

The legacy parameters translate to Direct properties in JSON format in your CreatePayment request.To help you re-create your legacy integration for the new platform, use this legacy parameter – Direct properties mapping.


Configure your test account

Direct reduces your efforts by outsourcing most of the Back Office technical settings to the CreatePaymentAPI. However, you need to make 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.

Check out our comprehensive guide to learn about how your existing account settings translate to the Direct API.


Adapt your checkout page

As customers stay in your webshop environment, you are completely free in designing your checkout page. Follow our best practices for an optimized payment experience.


Make sure to receive our platform’s transaction feedback

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

Direct offers webhooks and endpoint 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.


Test your new integration

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.


Go live

Are you ready to go live?

Use your existing live account – no need to create a new one! But make sure to

You're all set, now what? Start enjoying all the advantages of Direct!

Was this page helpful?

Do you have any comments?

Thank you for your response.