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 code
ADAEAGAIALAM
AOAQARASATAU
AWAXAZBABBBD
BEBFBGBHBIBJ
BLBMBNBOBQBR
BSBTBVBWBZCA
CCCDCFCGCHCI
CKCLCMCNCOCR
CVCWCXCYCZDE
DJDKDMDODZEC
EEEGEHERESET
FIFJFKFMFOFR
GAGBGDGEGFGG
GHGIGLGMGNGP
GQGRGSGTGUGW
GYHKHMHNHRHT
HUIDIEILIMIN
IOIQISITJEJM
JOJPKEKGKHKI
KMKNKRKWKYKZ
LALBLCLILKLR
LSLTLULVLYMA
MCMDMEMFMGMH
MKMLMNMOMPMQ
MRMSMTMUMVMW
MXMYMZNANCNE
NFNGNINLNONP
NRNUNZOMPAPE
PFPGPHPKPLPM
PNPRPSPTPWPY
QARERORSRWSA
SBSCSESGSHSI
SJSKSLSMSNSO
SRSTSVSXSZTC
TDTFTGTHTJTK
TLTMTNTOTRTT
TVTWTZUAUGUM
USUYUZVAVCVE
VGVIVNVUWFWS
YEYTZAZMZW

​
Supported currencies

Worldline Connect supports processing payments in the following currencies:
Currency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency code
AEDALLAMDAOAARSAUDAWGAZNBAMBBD
BDTBGNBHDBIFBMDBNDBOBBRLBSDBTN
BWPBYNBZDCADCDFCHFCLPCNYCOPCRC
CVECZKDJFDKKDOPDZDEGPERNETBEUR
FJDFKPGBPGELGHSGIPGMDGNFGTQGYD
HKDHNLHTGHUFIDRILSINRIQDISKJMD
JODJPYKESKGSKHRKMFKRWKWDKYDKZT
LAKLBPLKRLRDLSLLYDMADMDLMGAMKD
MMKMNTMOPMURMVRMWKMXNMYRMZNNAD
NGNNIONOKNPRNZDOMRPABPENPGKPHP
PKRPLNPYGQARRONRSDRWFSARSBDSCR
SEKSGDSHPSOSSRDSVCSZLTHBTJSTMT
TNDTOPTRYTTDTWDTZSUAHUGXUSDUYU
UZSVNDVUVWSTXAFXCDXCGXOFXPFYER
ZARZMW

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