Configuration

In the Magento root directory, execute php bin/magento module:enable Worldline_Connect
Then execute php bin/magento setup:upgrade
Go to Magento Admin > Stores > Configuration > Sales > Payment Methods > Other Payment Methods > Worldline
Configuration > Save Configuration
In the Magento root directory, execute php bin/magento cache:clean

In case of any appeared questions or configuration issues, don't hesitate to get in touch with us!

General Settings

Field	Setting details	Mandatory / Optional / Recommended	Comments
Magento webhook endpoint	Configure the Webhooks URL in the Worldline Configuration Center.	Recommended to use Webhooks for timely status updates	Enable all checkboxes for "payment" and "refund"
Email for manual review		Recommended for transactions that require review/approval
Limit API field length	Yes	Recommended to switch this setting on
Log client side API communication	Yes	Recommended to switch this setting on	If you enable logging, you should clear or rotate the log files regularly
Log all server side webhooks and API communication	Yes	Recommended to switch this setting on	If you enable logging, you should clear or rotate the log files regularly
Soft descriptor	Your preferred descriptor per store	Optional	Please note that this service needs to be enabled on Worldline side as well
Active environment	The environment you’re using for testing/processing	Mandatory

Sandbox/Pre-Production/Production settings

You can find this information in the applicable Worldline environment's Configuration Center (Sandbox, Pre-Production, Production). After adding the fields you can test the connection to verify the setup is correct.

Field	Setting details	Mandatory / Optional / Recommended
Merchant ID (MID)	Your Worldline merchant ID from the Configuration Center “Merchant IDs”	Mandatory
API key ID	Your Worldline API key ID from the Configuration Center “API keys”	Mandatory
API secret	Your Worldline Secret API Key from the Configuration Center “API keys”	Mandatory
Webhooks key ID	Your Worldline Webhooks Key ID from the Configuration Center “Webhooks keys”	Recommended to use Webhooks for timely status updates
Webhooks secret key	Your Worldline Webhooks secret key from the Configuration Center “Webhooks keys”	Recommended to use Webhooks for timely status updates

Payments Product settings

Field	Setting details	Mandatory / Optional / Recommended	Comments
Enabled	Yes	Mandatory
Sort Order	Priority of the product	Optional	Priority of the product. If not changed, the default setup will apply.
Allowed Countries	Select which countries are allowed for this payment product	Optional	If not changed, the default setup will apply.
Minimum Order Total		Optional	If not changed, no limitation will apply.
Maximum Order Total		Optional	If not changed, no limitation will apply.
Payment Action	Direct Capture: payments are automatically captured and reported as paid as soon as the capture is complete on the gateway. An invoice is created automatically. Delayed Settlement: you have to manually capture payments by accepting the payment on the order details page.	Mandatory	Only applicable for cards. In case of delayed capture, manual approval is needed. See more information below.
Payment flow type	Hosted: redirect customers to Worldline’s payment pages Inline: use your payment pages	Mandatory	See more information below.

Payment action

When a new payment is made, you have the power to decide what happens next. And there are two options for you to choose from:

1. Direct Capture

Payments will be automatically captured and reported as paid as soon as the capture process is complete on the gateway. Plus, to make things even easier, an invoice will be also automatically created.

2. Delayed Settlement

New payments will be captured manually by creating an invoice from the order details page.

Payment flow type

Configure how payment information is going to be captured by the customer, by choosing one of the options:

1. Inline payments

The payment data (e.g. credit card information) is requested directly in your checkout and encrypted via the Connect JavaScript SDK. The encrypted data is then sent to your shop and forwarded to the Connect platform through the Connect Server SDK.

However, not all payment methods support this payment data capture: for those who don't, the MyCheckout hosted payment pages are being used.

2. Hosted payments

The customer will be redirected to MyCheckout hosted payment pages for all available payment products after completing the Magento checkout.

Hosted Payment Pages

Select this option if you would like to process all payment products via MyCheckout hosted payment pages. This allows you to process additional payment products offered by us, which are not yet integrated in the plugin. You can rename the product in the Title section.

Vault

Please note that the tokenization option first needs to be enabled on your Worldline account in order to start working. You’ll see the Webhooks messages coming in Sales > Events.

The capture mode of Vault follows the setup of the underlying card, but we suggest having the same setup for the Cards and Vault sections in order for it to operate flawlessly.