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.

​
Features

Worldline Connect supports the following features:
  • Delayed capture - Authorize a payment and capture it at a later time
  • Partial capture - Capture a portion of the authorized amount
  • Partial refunds - Refund a portion of the captured amount
  • Refunds - Refund a captured payment
  • Void - Cancel an authorized transaction before capture
  • Zero auth - Verify a card without charging it
  • Digital wallets - Support for Apple Pay and other digital wallet integrations
  • Network tokens - Network tokenization is enabled by default
  • Transaction sync - Synchronize transaction status with Worldline Connect
  • 3-D Secure - Pass-through 3DS authentication
  • Webhooks required - Webhooks are required for status updates

​
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

Worldline Connect supports transactions from buyers in the following countries:
Country codeCountry codeCountry codeCountry codeCountry codeCountry codeCountry codeCountry code
ADAEAGAIALAMAOAQ
ARASATAUAWAXAZBA
BBBDBEBFBGBHBIBJ
BLBMBNBOBQBRBSBT
BVBWBZCACCCDCFCG
CHCICKCLCMCNCOCR
CVCWCXCYCZDEDJDK
DMDODZECEEEGEHER
ESETFIFJFKFMFOFR
GAGBGDGEGFGGGHGI
GLGMGNGPGQGRGSGT
GUGWGYHKHMHNHRHT
HUIDIEILIMINIOIQ
ISITJEJMJOJPKEKG
KHKIKMKNKRKWKYKZ
LALBLCLILKLRLSLT
LULVLYMAMCMDMEMF
MGMHMKMLMNMOMPMQ
MRMSMTMUMVMWMXMY
MZNANCNENFNGNINL
NONPNRNUNZOMPAPE
PFPGPHPKPLPMPNPR
PSPTPWPYQARERORS
RWSASBSCSESGSHSI
SJSKSLSMSNSOSRST
SVSXSZTCTDTFTGTH
TJTKTLTMTNTOTRTT
TVTWTZUAUGUMUSUY
UZVAVCVEVGVIVNVU
WFWSYEYTZAZMZW

​
Supported currencies

Worldline Connect supports processing payments in the following currencies:
Currency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency code
AEDALLAMDAOAARSAUDAWGAZN
BAMBBDBDTBHDBIFBMDBNDBOB
BRLBSDBTNBWPBYNBZDCADCDF
CHFCLPCNYCOPCRCCVECZKDJF
DKKDOPDZDEGPERNETBEURFJD
FKPGBPGELGHSGIPGMDGNFGTQ
GYDHKDHNLHTGHUFIDRILSINR
IQDISKJMDJODJPYKESKGSKHR
KMFKRWKWDKYDKZTLAKLBPLKR
LRDLSLLYDMADMDLMGAMKDMMK
MNTMOPMURMVRMWKMXNMYRMZN
NADNGNNIONOKNPRNZDOMRPAB
PENPGKPHPPKRPLNPYGQARRON
RSDRWFSARSBDSCRSEKSGDSHP
SOSSRDSVCSZLTHBTJSTMTTND
TOPTRYTTDTWDTZSUAHUGXUSD
UYUUZSVNDVUVWSTXAFXCDXCG
XOFXPFYERZARZMW

​
Limitations

The following features are not supported by this connector:
  • Over capture - Capturing more than the authorized amount is not supported
  • Partial authorization - Partial authorization is not supported
  • Create session - Session creation is not supported
  • 3-D Secure hosted - Hosted 3DS flows are not supported
  • Payment method tokenization - Storing payment methods outside of transactions using a separate tokenization flow is not supported
  • Settlement reporting - Automatic settlement reporting is not supported

​
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.