Skip to main content
Worldline is a global payment processing company providing tailored solutions for merchants across various industries. Worldline’s platforms deliver secure, reliable payment acceptance and processing services worldwide.

​
Setup

To create a Worldline Connect account, please contact Worldline directly. Note: if you intend to tokenize cards, ask the Worldline Merchant Services team to configure your account to return initialSchemeTransactionId in transaction responses.

​
Connector configuration

After setting up your Worldline Connect connector in the dashboard, configure how transactions are routed to it. Choose one of the following options:
  • Using Flow - Configure Worldline Connect as the target connector in Flow to automatically route card transactions to this connector
  • Using the API - Explicitly set the payment_service_id parameter to the Worldline Connect connector ID when creating transactions. This overrides any Flow routing rules.
The connector ID can be found in the dashboard under Connections -> Configured connections.

​
Credentials

When setting up Worldline Connect in the dashboard, configure the following credentials, which you can obtain from the Worldline configuration center under Account Settings.
  • Merchant ID - The numerical merchant ID.
  • API Key ID - The API key ID.
  • API Secret Key - The API secret key.
  • Webhook Secret Key (optional) - The webhook secret key used to sign webhooks.

​
Capabilities

​
Webhooks

In order for webhooks to be sent, at least one webhook key must be generated. This is done in the Worldline Configuration Center, under Webhooks keys.

​
Required checkout fields

Worldline Connect requires the following buyer fields during checkout:
  • address.country
  • first_name
  • last_name

​
Supported countries

​
Supported currencies

​
Integration

To accept card payments with Worldline Connect, use one of Gr4vy’s client-side integration methods to securely collect card details. Due to PCI compliance requirements, card data should never be sent directly to your servers. You can integrate using:
  • Embed - A pre-built, customizable payment form that handles the complete payment flow
  • Secure Fields - Embed card input fields for building custom payment forms while maintaining PCI compliance
  • Mobile SDKs - Native SDKs for iOS, Android, React Native, and other platforms
These methods handle card data collection and tokenization. Once the card details are collected and tokenized, create a transaction through the Gr4vy API, which routes the payment to your configured Worldline Connect connection based on your Flow rules or explicit payment_service_id parameter.

​
Testing

For sandbox testing, use the test credentials and card data provided by your Worldline representative. You can generate test card details using Worldline’s test card generator.