Skip to main content

Migrate to Direct

Worldline Direct is the modernized payment platform replacing legacy Worldline systems. This guide helps you migrate to the contemporary REST API-based solution with enhanced capabilities.

Why Migrate?​

BenefitDescription
New Payment MethodsAccess to 10+ new payment methods
Modern APIState-of-the-art REST API architecture
Mobile FirstOptimized for mobile experiences
ComplianceGDPR and PSD2 compliant
Ongoing DevelopmentContinuous feature enhancements

Migration Overview​

Migration Steps​

Step 1: Activate Direct on Test Account​

  1. Log into your legacy Back Office
  2. Navigate to Configuration > Account > Your options
  3. Find "DIR (Merchant using Direct integration)" in Available options
  4. Click Activate
note

The DIR option may already be enabled by default. Check the Default options section if it's not visible.

Step 2: Review Payment Methods​

Supported Without Changes​

These payment methods work seamlessly in Direct:

  • Visa, Mastercard, American Express
  • Bancontact
  • iDEAL
  • Klarna
  • Intersolve
  • TWINT

Requires Configuration Updates​

MethodAction Required
PayPalConfigure in Merchant Portal
Przelewy24Contact payment provider
EPSContact payment provider
Transitional Period

When activating PayPal, Przelewy24, or EPS for Direct, they may stop working on legacy systems depending on your account status. Use the EXCLPMLIST parameter to exclude them from legacy operations during transition.

New in Direct​

Take advantage of these new payment methods:

  • Apple Pay, Google Pay, WeChat Pay
  • SEPA Direct Debit
  • Bank Transfer by Worldline
  • Bizum, MB Way, Multibanco
  • Oney, FloaPay (BNPL options)

Not Available in Direct​

Some legacy methods have no Direct equivalent:

  • Pass ES
  • Visa Purchasing Card
  • American Express CPC
  • PaySafeCard
  • GiroPay
  • Ikano

Step 3: Choose Integration Method​

Map your current integration to the Direct equivalent:

Legacy MethodDirect EquivalentDocumentation
Hosted Payment PageHosted Checkout PageView Guide
FlexCheckoutHosted Tokenization PageView Guide
DirectLinkServer-to-ServerView Guide
e-Terminale-TerminalMerchant Portal

New Integration Options:

  • Pay-by-link - No-code payment link generation
  • Mobile/Client SDKs - Native app integration

Step 4: Implementation Approach​

Choose your implementation method:

Plugins (Easiest)​

Pre-built integrations for major platforms:

PlatformPlugin Available
Magento 2.4Yes
WooCommerceYes
PrestaShopYes
ShopifyYes
BigCommerceYes
SAP Commerce CloudYes
Salesforce Commerce CloudYes

SDKs​

Server SDKs:

  • .NET
  • Java
  • Node.js
  • PHP
  • Python
  • Ruby

Client SDKs:

  • iOS (Swift/Objective-C)
  • Android
  • JavaScript
  • Flutter
  • React Native

Custom Integration​

Direct API access using standard authentication for fully custom implementations.

Step 5: Test Your Integration​

Important

Test data from the legacy Back Office is irrelevant for Direct. Use Direct-specific test data only.

Test thoroughly in the sandbox environment:

  1. Use the API Explorer for scenario testing
  2. Test all payment methods you plan to support
  3. Verify webhooks are received correctly
  4. Test 3-D Secure flows
  5. Validate error handling

Test Card Numbers:

CardNumberScenario
Visa (Success)4111 1111 1111 1111Approved
Visa (3DS)4012 0000 3333 00263DS Challenge
Visa (Decline)4000 0000 0000 0002Declined

Step 6: Go Live​

Once testing is complete:

  1. Replicate your test configuration in the production account
  2. Activate the DIR option in the production Back Office
  3. Switch your application to production endpoints
  4. Monitor transactions closely after go-live
Proceed Carefully

Errors in production configuration may disrupt your existing payment flows. Double-check all settings before activating.

API Endpoint Changes​

EnvironmentLegacyDirect
TestVarious legacy endpointshttps://payment.preprod.direct.worldline-solutions.com
ProductionVarious legacy endpointshttps://payment.direct.worldline-solutions.com

Key Differences from Legacy​

Authentication​

LegacyDirect
SHA signatureAPI Key + API Secret (HMAC)
Multiple signature methodsStandardized v1HMAC

API Architecture​

LegacyDirect
POST parametersRESTful JSON API
Various endpointsConsistent resource-based URLs
XML/HTML responsesJSON responses

Webhooks​

LegacyDirect
Email notificationsWebhook events
Back Office status checksReal-time HTTP callbacks
Limited event typesComprehensive event coverage

Account Continuity​

Your existing PREPROD and PROD accounts continue functioning under Direct. No new account creation is required—only reconfiguration.

Support During Migration​

  • Technical Support - Available for existing customers
  • API Documentation - Comprehensive API Reference and Explorer
  • Test Environment - Full sandbox for validation
  • Plugins - Pre-built solutions for major platforms
Need Help?

Contact your Worldline account manager or technical support for migration assistance.

Migration Checklist​

  • Activate DIR option on test account
  • Review payment method compatibility
  • Choose integration method (plugin/SDK/custom)
  • Update API endpoints
  • Implement new authentication
  • Configure webhooks
  • Test all payment flows
  • Test error scenarios
  • Activate DIR option on production
  • Update production configuration
  • Monitor post-migration

Next Steps​