Worldline Online Payments (formerly Ingenico) Direct Integration

Introduction

Worldline Online Payments is a payment solution that offers comprehensive and seamless payment processing services to its customers. Chargebee allows you to easily connect with Worldline Online Payments to process your payments.

Here are a few things that you need to know before you choose Worldline Online Payments:

Countries Supported: Worldline Online Payments is available for companies based in Europe. Contact the Worldline Online Payments team to confirm availability in your preferred countries.

Payment Methods: Chargebee currently supports only card payments with Worldline Online Payments.

Integration Options

Listed below are the integration options available between Chargebee and Worldline Online Payments:

#	Methodology	Description	PCI Requirements	3DS supported?
1	Chargebee Checkout + Worldline Online Payments Gateway	Card information of the customers are collected by Chargebee's checkout and passed on to Worldline Online Payments.	Low (Your PCI compliance requirements are greatly reduced because of Chargebee's checkout. As a merchant using Chargebee's checkout, all you have to do is submit a Self Assessment Questionnaire to stay compliant.)	Yes
2	Chargebee JS + Worldline Online Payments gateway	Card information of the customers are collected by Chargebee's js and passed on to Worldline Online Payments.	Low (card details are tokenized by Worldline Online Payments)	Yes
3	Chargebee API + Worldline Online Payments Gateway	Collection of card information should be handled at your end and passed on to Chargebee via the API. Chargebee will route this card information to Worldline Online Payments.	High (card information will be collected by you directly, you will have to take care of PCI Compliance requirements)	No For more info, contact support/a>

Prerequisites

Following are the prerequisites for configuring the Worldline Online Payments gateway in your Chargebee site:

• You must have a merchant account with Worldline Online Payments. Create one, if you don't have it already.
• You need to retrieve the following details from your Worldline Online Payments account:
  • PSPID (Merchant ID): To get the merchant ID from your Worldline Online Payments account, log in to your Worldline Online Payments account, click Configuration > Account > Your invoicing information.
    
  • API ID: To get the API ID from your Worldline Online Payments account, click Configuration > Technical Information > Worldline Online Payments Direct Settings > Direct API Key.
    
  • API Secret Key: To get the API Secret Key from your Worldline Online Payments account, click Configuration > Technical Information > Worldline Online Payments Direct Settings > Direct API Key.
  • Webhook Key: To get the Webhook Key from your Worldline Online Payments account, click Configuration > Technical Information > Worldline Online Payments Direct Settings > Direct API Key.
  • Webhook Secret Key: To get the Webhook Secret Key from your Worldline Online Payments account, click Configuration > Technical Information > Worldline Online Payments Settings > Webhooks Configuration.
    

Configuring Worldline Online Payments

To configure Worldline Online Payments in Chargebee, follow the below steps:

1. Click Settings > Configure Chargebee > Payment Gateway > Add payment Gateway.
2. Click Worldline Online Payments.
   
3. Enter the PSPID (Merchant ID), API ID, API Secret Key, Webhook Key, and Webhook Secret Key of your Worldline Online Payments account.
   
4. Click Connect.

Once done, the Configure Worldline Online Payments appears as shown below:

Configuring Card Settings

To update the Cards Settings for Worldline Online Payments, follow these steps:

1. Click the Manage link in the Cards section. The Cards Settings page is displayed. Configure the following settings based on your business requirements:
   
2. Cards verification: Chargebee allows you to verify the customer's card before adding them. In this process, a small amount will be debited from the customer's card and will be refunded instantly. In case this authorization fails, the customer cannot add their card. If you wish to activate this authorization, enable card verification.
3. Allow Prepaid cards: Enabling this option allows your customers to use a prepaid card for their transactions.
4. Always retain card information in Worldline Online Payments when the customer updates it: If you have configured multiple payment gateways in Chargebee, enabling this option stores the updated card information in Worldline Online Payments rather than the default gateway.
5. Enable 3D Secure: Check with your gateway whether Payment Authentication for 3DS is enabled for your account. If not, enable it at your gateway and then in Chargebee. Also, make sure you complete the SCA checklist in Chargebee before accepting 3DS payments. This is to ensure that you can recover failed payments easily, without compromising your revenue. Learn more about PSD2 and Strong Customer Authentication.
6. Display Card Logo for: Click the drop-down, and select the card brands for which you want to display logos, on your Checkout and Self-serve Portal pages. (This setting is only applicable for Single Page Checkout and Self-serve portal).
7. Click Save > Apply.

Configuring Webhooks

Webhooks are indispensable when it comes to integrating Chargebee with Worldline Online Payments as they pass crucial payment information such as payment status, based on which users can take action. Webhooks in this integration should be configured manually. Learn more about webhooks.

To configure webhook in your Worldline Online Payments account, follow the below steps:

1. Click Settings > Configure Chargebee > Payment Gateways > Worldline Online Payments, and copy the Notification URL under Webhooks.
   
2. Log in to your Worldline Online Payments account.
3. Click Configuration > Technical Information > Worldline Online Payments Direct Settings > Webhooks Configuration.
4. Paste the Notification URL from Chargebee into the Endpoints URL field.
   
5. Click Save.

Automated Account Updater

This integration supports automated account update for cards.

Payment failures and recovery are the most difficult aspects of recurring billing businesses due to the sheer complexities involved. In most cases, payment failures occur as a result of an expired or updated card. Chargebee supports an automated account update for Worldline Online Payments. Each time there is an update to the customer's card number, expiry, or Customer Verification Value (CVV), the details are updated in Chargebee (in real-time) with the help of card networks and the Worldline Online Payments gateway. This helps avoid any manual efforts for your customers and more importantly avoid payments failing due to outdated card information.