Magento Plugin

The Worldline Direct Magento plugin provides comprehensive payment processing for Magento 2.4 installations, supporting 40+ payment methods through multiple integration approaches.

Features

• Hosted Checkout Page - Redirect to Worldline's secure payment interface
• Hosted Tokenization - Embedded card payment iframe
• Redirect Payments - Direct payment method buttons
• 40+ Payment Methods - Cards, wallets, bank transfers, BNPL
• Hyvä Theme Support - Full compatibility with Hyvä themes

Requirements

Component	Version
Magento	2.4.x
PHP	7.4 - 8.4
Hyvä Theme	>= 1.1.12 (optional)
Hyvä Checkout	>= 1.1.15 (optional)

Prerequisites

• Active Worldline Direct account (test or production)
• API Key and API Secret from the Merchant Portal
• Configured webhook endpoints

Installation

Option 1: Composer (Recommended)

Install the complete plugin package:

composer require worldline/module-magento-payment

Complete the setup:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy

Option 2: GitHub

Configure the repositories:

composer config repositories.worldline/module-magento-payment \
  git https://github.com/wl-online-payments-direct/plugin-magento.git
composer config repositories.worldline/module-magento-payment-core \
  git https://github.com/wl-online-payments-direct/plugin-magento-core.git
composer config repositories.worldline/module-magento-payment-hostedcheckout \
  git https://github.com/wl-online-payments-direct/plugin-magento-hostedcheckout.git
composer config repositories.worldline/module-magento-payment-redirectpayment \
  git https://github.com/wl-online-payments-direct/plugin-magento-redirect-payments.git
composer config repositories.worldline/module-magento-payment-creditcard \
  git https://github.com/wl-online-payments-direct/plugin-magento-creditcard.git

Then install:

composer require worldline/module-magento-payment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy

Modular Installation

Install only the payment methods you need:

# Credit Card only
composer require worldline/module-magento-payment-credit-card

# Hosted Checkout only
composer require worldline/module-magento-payment-hosted-checkout

# Redirect Payments only
composer require worldline/module-magento-payment-redirect-payment

Hyvä Theme Support

For Hyvä compatibility:

composer config repositories.worldline/module-magento-theme-hyva \
  git git@github.com:wl-online-payments-direct/plugin-magento-hyva.git

composer require worldline/module-magento-theme-hyva

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy

Configuration

Connection Settings

Navigate to Stores > WORLDLINE ONLINE PAYMENTS > Connection.

Setting	Description
Environment Mode	Test or Production
API Key	Your API key from Merchant Portal
API Secret	Your API secret from Merchant Portal
Merchant ID (PSPID)	Your merchant identifier

Environment Credentials

Never mix test and production credentials. Use test environment until fully validated, then switch to production.

Click Test Connection to verify your settings.

Webhook Configuration

Navigate to Stores > WORLDLINE ONLINE PAYMENTS > Connection > Webhooks.

Setting	Description
Allow Receiving Webhooks	Enable webhook processing
Webhook URL Configuration	Automatic (recommended) or Manual
Additional Webhooks	Up to 4 additional URLs

Automatic Configuration

The plugin automatically registers the webhook URL in the Merchant Portal when set to "Automatic" mode.

Payment Method Settings

Navigate to Stores > WORLDLINE ONLINE PAYMENTS > Payment methods.

Credit Card (Hosted Tokenization)

Setting	Description
Enable Module	Activate card payments
Title	Display name in checkout
HTML Template ID	Template for appearance
Payment Action	Authorize & Capture or Authorize Only
Skip 3D Secure	Not recommended
Request 3DS Exemption	Enable exemptions

Hosted Checkout

Setting	Description
Enable Module	Activate all payment methods
Title	Page heading
HTML Template ID	Template for appearance
Payment Action	Authorization mode
Group Cards	Show cards under single button
Submit Cart Data	Send cart details

Redirect Payments

Setting	Description
Enable Module	Activate redirect payments
Per-Method Configuration	Enable/sort individual methods

Payment Actions

Mode	Description	Use Case
Authorize & Capture	Immediate fund capture	Digital goods, immediate fulfillment
Authorize Only	Funds blocked until capture	Physical goods, ship-then-capture

For Authorize Only, capture manually via the Magento admin after shipment.

Supported Payment Methods

Cards

• Visa
• Mastercard
• American Express
• Discover
• JCB
• Diners Club
• Union Pay

Digital Wallets

• Apple Pay
• Google Pay
• WeChat Pay

Bank Transfers

• iDEAL (Netherlands)
• Bancontact (Belgium)
• Przelewy24 (Poland)
• Bizum (Spain)
• EPS (Austria)
• Giropay (Germany)

Buy Now, Pay Later

• Klarna (Pay Later, Pay Now, Slice It)
• Oney
• Sofinco

Order Management

Status Updates

The plugin uses multiple mechanisms for transaction synchronization:

1. Webhooks (Primary) - Real-time notifications
2. GET Call Fallback - Polls if webhooks fail
3. Cron Job Fallback - Regular status checks

Order Status Updater

Configure at Stores > WORLDLINE ONLINE PAYMENTS > Order status updater:

Setting	Default	Description
Fallback Timeout	1 minute	Wait before GET calls
Fallback Timeout Limit	3 hours	Duration of polling
Schedule (Cron)	Customizable	Execution schedule

Amount Discrepancy Handling

For price changes during checkout, configure at Settings & Notifications > Order creation on Amount Discrepancy:

Option	Behavior
Enable: Yes	Orders created with "On hold" status
Enable: No	Transactions rejected

Updating

Update the complete installation:

composer update worldline/module-magento-payment \
  worldline/module-magento-payment-core --with-all-dependencies

Uninstalling

Create a database backup first, then:

composer remove worldline/module-magento-payment

For complete removal including data:

bin/magento module:uninstall \
  Worldline_Payment \
  Worldline_PaymentCore \
  Worldline_CreditCard \
  Worldline_HostedCheckout \
  Worldline_RedirectPayment

Debugging

Enable debug mode per payment method for detailed logging.

View logs at Stores > Settings > Configuration > WORLDLINE > Debug:

• Debug Logs - Download or delete log files
• Worldline Request Logs - Filter by status, endpoint, date
• Webhook Logging - Capture webhook events

Best Practices

1. Test First - Always test in sandbox before production
2. Enable Webhooks - Ensure reliable order updates
3. Keep 3-D Secure Enabled - Required in regulated markets
4. Monitor Logs - Check for errors regularly
5. Regular Updates - Keep the plugin updated

No Code Modifications

Plugin code modifications void technical support. Use configuration options only.

Troubleshooting

Issue	Solution
Connection failed	Verify API credentials and PSPID
Webhooks not received	Check URL accessibility and firewall rules
3DS not working	Ensure 3DS is not disabled in settings
Orders stuck	Check Order Status Updater configuration

Resources

• GitHub Repository
• Merchant Portal
• API Reference

Next Steps

• Configure webhooks for reliable notifications
• Set up 3-D Secure for card security
• Explore payment methods to enable