worldline Direct
Sign up

Introduction

Our Commercetools plug-in comes with regular updates and full integration support, guaranteeing a versatile out-of-the-box solution to accept online payments easily.

Supported integration & payment methods

Offers the following integration methods on our platform:

Hosted checkout page

Redirect your customers from your checkout page to our platform for entering sensitive payment data.

Hosted tokenization page

Include an iFrame payment form hosted on our save environment in your checkout page for entering sensitive payment data.

  • Offers the following payment methods on our platform:
    Alipay+
    American Express
    Apple Pay
    Bancontact
    Bizum
    Carte Bancaire
    Cpay
    Diners Club
    iDEAL
    Illicado
    Intersolve
    JCB
    Multibanco
    OneyBrandedGiftCard
    PayPal
    SEPA Direct Debit
    Maestro
    MasterCard
    Visa
    WeChatPay
  • Manages multiple stores
  • Accepts payment operations (Refunds, authorisations, captures etc.) directly from the plugin

Keep an eye on our Release Notes to stay informed about updates and new features (i.e. payment methodsfeaturesintegration modes) we have added to this plugin!

Check out our documentation to learn how to link your store with our platform to profit from all these features!

    Download plugin (Github)

    • Entrust a system integrator or a technical consultant with the installation and the configuration of the plugin
    • Accordingly, the target audience of this documentation are system administrators with a profound knowledge of Commercetools platform.

    To process transactions with this plugin, you need an account on our platform.

    This plugin works with both our test and live environment. A test account is a great way to get familiar with both the plugin and our platform. Once you want to go live, create a production account or contact us!

    Install plugin

    The first step to use the plugin is the installation process. Before you proceed, make sure your infrastructure meets these system requirements:

    Item

    Description

    Plugin package

    Download the plugin

    Direct credentials

    Commercetools Frontend

    Compatible with all Frontend versions.

    PCI compliancy

    SAQ A (14)

    The plugin’s in-built features ensure this security level, but you still need to get the certificate from your acquirer

     Detailed installation process can be found out in README document available with the package or on Github.

    Configure plugin

    • Navigate to “My Account” section in Commercetools merchant center.
    • Select Test or Live mode as necessary.

    Enter the following information:

    Property

    Description/Actions

    Merchant ID

    Enter your PSP ID or merchant ID that you used to sign up with Worldline

    API Key

    Enter the API key of your test or live PSPID. Read our dedicated guide to learn how to generate one

    API Secret

    Enter the API secret of your test or live PSPID. Read our dedicated guide to learn how to generate one

    API Endpoints

    The test or live endpoint on our platform. Copy them from our dedicated guide.

    Webhook Key

    Enter the Webhooks Secret of your test/live PSPID from the Merchant Portal as described in our dedicated guide.

    Webhook Secret

    Enter the Webhooks Secret of your test/live PSPID from the Merchant Portal as described in our dedicated guide.

    Timeout in Minutes

    Set the interval for API timeout (Set to ‘180’ by default)

    Webhook URL

    Copy this URL into the Endpoint URLs fields in the Merchant Portal as described in our dedicated guide.

    SMTP Server credentials

    Setup your mailbox to be notified about failed payments. Also, send emails to Worldline and request new features. Available for both test and live modes.
    Use this option to conceal/show sensitive server information:

    • Server URL: Enter the SMTP server URL for your chosen mode.
    • Server Port: Specify the server port (default: 25, may differ for live mode).
    • Username: Enter the server username for the SMTP Server
    • Password: Provide the server password for the SMTP Server
    • Server Timeout: Set the server timeout in seconds (e.g., 100).
    • Sender's Email: Enter the email address for sending notifications (may differ for test and live modes).

    Click Save/Update to ensure all information is reflected as expected. The system will automatically test the API connection using the provided API credentials.

    • If a valid response is received from Worldline, the configuration will be saved.
    • If the connection test fails, an error message will be displayed, allowing you to review and edit the settings.

    Read our dedicated guides about API endpoints and authentication to get a thorough understanding about the test/live environment and API key/API secret.

    We strongly recommend configuring a separate name for both our test and live environment. This will allow you to manually switch from one environment to the other easily. Make sure not to mix up credentials from test with live and vice versa.

    Configure payment methods and integration modes

    We categorise payment methods in two different clusters

    • Card payments
    • Alternative payment methods

    You can process card payments either via Hosted Tokenization Page or Hosted Checkout Page, whereas the alternative payment methods are available only via Hosted Checkout Page

    Follow these steps to make your choice:

    • Go to Worldline > Payment Methods in the merchant center.
    • Multiple payment modes are available. Please make sure to activate using the toggle as per your reference.

    Here is a quick summary of each payment mode:

    ID value

    Description/Actions

    On Site Mode: Card payments only

    Covers all card-based payment methods

    • All card brands bundled together in a single iFrame on your checkout page itself via our Hosted Tokenization Page. Your customers stay on your checkout page while entering their card details in an iframe hosted on our server. The iframe presents a single payment method “Credit card” which autodetects the card brand based on card number input
      Bancontact is available only on Hosted Checkout Page in both QR code and URL (Payconiq) mode

    Configuration options:

    • Pay button Title – Allows the customer to add the localised title of payment and is also editable as per the merchant preference.
    • Template File Name – Enter the file name of your template to adapt the iframe to the look and feel of your shop. To learn how to create templates, see our dedicated chapter in the  Hosted Tokenization Page guide.
    • Accepted card brands – Display images of card brands that you accept on your store. Upload multiple images using this option.
    • 3DS Enablement – Enable or Disable 3DS completely. There are two additional options here-
    • 3DS Challenge – Enforce strong customer authentication for all transactions.
    • 3DS Exemption – For amounts <30 Euros. The merchant is liable for frauds in this case.

     *If both of the options are set to Yes, 3DS Challenge takes precedence and no transactions will be exempt.

    Redirect Mode A: Payment method selection before redirection

    Covers all cards and alternative payment methods.
    Each payment method is listed individually for redirect upon selection to Hosted Checkout Page. Upon selection of the brand, the plugin redirects your customers to our Hosted Checkout Page or to the third-party provider for entering the payment credentials.
    Configuration options:

    • Refresh available payment methods – Fetches all available payment methods on merchant’s Worldline account.
    • Send Order Data – Send order line items details in your transaction request and display on Worldline payment page.
    • Template File Name –  Enter the file name of your template to adapt the Hosted Checkout Page to the look and feel of your shop. To learn how to create templates, see our dedicated chapter in the Hosted Checkout Page guide.
    • 3DS Enablement – Enable or Disable 3DS completely. There are two additional options here.
    • 3DS Challenge – Enforce strong customer authentication for all transactions.
    • 3DS Exemption – For amounts <30 Euros. The merchant is liable for frauds in this case.

     *If both of the options are set to Yes, 3DS Challenge takes precedence and no transactions will be exempt.

    The payment methods are displayed in grid format and can be enabled or disabled from here. Once enabled, the customer can also use the Settings option to upload images for each payment method activated.

    Redirect Mode B: Payment method selection after redirection

    Covers all alternative payment methods (digital wallets, mobile payment methods, gift cards etc.) in full redirect mode.
    Configuration options:

    • Generic logo – Upload a generic image (ex: Worldline) for it to be displayed next to payment method on checkout page.
    • Pay button Title – Allows the customer to add the localised title of payment and is also editable as per the merchant preference.
    • Template File Name – Enter the file name of your template to adapt the Hosted Checkout Page to the look and feel of your shop. To learn how to create templates, see our dedicated chapter in the Hosted Checkout Page guide.
    • Group Cards – Enable grouping all cards payment methods under one single option “Cards” on the payment page.
    • 3DS Enablement – Enable or Disable 3DS completely. There are two additional options here-
    • 3DS Challenge – Enforce strong customer authentication for all transactions.
    • 3DS Exemption – For amounts <30 Euros. The merchant is liable for frauds in this case.

     *If both of the options are set to Yes, 3DS Challenge takes precedence and no transactions will be exempt.

    Please note that the configuration will be stored based on the Store and Country basis. Whenever you select the locale in the Frontend the data for that Store and Country will be rendered.

    There are some additional configurations which are applicable across different payment modes. Please see the table below for that configuration.

    Property

    Description/Actions

    Merchant reference ID

    Use this identifier to customize your order reference and match with Worldline Merchant Portal.
    If you want the acquirer to show it on the customer's bank account, limit the characters between 2 to 12.

    Transaction Type

    Define whether to process the transactions in authorisation mode or as direct sale. Select one of the following options:

    • Authorisation (FINAL_AUTHORISATION): the amount is only blocked on your customer's card. Successful transactions will have StatusCode=5 (this is used when you wish to capture a transaction only after shipping the article). There are two options:
    • Preauthorization – Block funds for 30 days.
    • Final Authorization – Block funds for 7 days. These cannot be reversed and need to capture the full amount always.
    • Sale (SALE): the amount has been ordered to be paid out in one go. Successful transactions will have StatusCode=9.

    If you authorise payments only, make sure that you capture them later. Only then will the transaction reach StatusCode=9, for which you receive funds.

    Capture configuration

    This allows you to set automatic capture procedure using and Automatic Capture Job. This job allows you to set the capture delay of X days in the given field. At the end of this duration, a cron job will capture the transaction automatically.

    Enable Debugging Logging

    Allows logging for transactions for debugging in case of issues.

    You can also download them to share further.

    Manage payments

    We have designed the plugin to follow-up on your orders automatically and autonomously, freeing you from the administration involved. Learn here how to use our plugin effectively which could help your business to thrive!

    Perform maintenance operations
    Captures, refunds and cancellations of authorisations are standard processes (also known as maintenance operations) in your everyday business logic. Learn here how to perform these operations directly from the Commercetools merchant center:

    • Go to Worldline > Orders. The Order details page segregates the orders based on the combinations of Stores and Countries. The Sample Orders page looks like-

     Depending upon the payment status, the following buttons are available in the "Actions":

    Maintenance operations

    Description/Actions

    Capture

    Capture authorised transactions ((StatusCode=5 / Status=PENDING_CAPTURE / AUTHORIZED/ PARTIALLY CAPTURED / PARTIALLY CANCELLED) to effectively receive funds for the order-

    • Click on the “Capture” button.
    • Enter the amount and click “Capture”.

    If you want our plugin to capture transactions automatically, please make sure to setup capture configuration in payment methods setup.

    Cancel

    Cancel authorised transactions (StatusCode=5 / Status=PENDING_CAPTURE / AUTHORIZED / PARTIALLY CAPTURED / PARTIALLY CANCELLED)

    • Click on the “Cancel” button.
    • Enter the amount and click “Cancel”.

    Please note that currently, partial cancellation is not supported by Worldline. Hence, irrespective of the amount mentioned, the order will be cancelled fully.

    Refund

    Reimburse your customers for captured transactions (StatusCode=9 / Status=COMPLETED / CAPTURED / PARTIALLY CAPTURED / PARTIALLY REFUNDED)

    • Click on the “Refund” button.
    • Enter the amount and click “Refund”.


    Perform test transactions

    Use our platform's test environment to make sure your plugin works as intended. We offer test data sets on our dedicated Test cases page. Target our test environment as described in the Configure Plugin section.

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

    Was this page helpful?

    Do you have any comments?

    Thank you for your response.