> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Worldline Connect - Card

> Connect to Worldline Connect to accept card payments.

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](https://worldline.com/) 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](/guides/dashboard/flow/overview) 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 code | Country code | Country code | Country code | Country code | Country code | Country code | Country code |
| ------------ | ------------ | ------------ | ------------ | ------------ | ------------ | ------------ | ------------ |
| `AD`         | `AE`         | `AG`         | `AI`         | `AL`         | `AM`         | `AO`         | `AQ`         |
| `AR`         | `AS`         | `AT`         | `AU`         | `AW`         | `AX`         | `AZ`         | `BA`         |
| `BB`         | `BD`         | `BE`         | `BF`         | `BG`         | `BH`         | `BI`         | `BJ`         |
| `BL`         | `BM`         | `BN`         | `BO`         | `BQ`         | `BR`         | `BS`         | `BT`         |
| `BV`         | `BW`         | `BZ`         | `CA`         | `CC`         | `CD`         | `CF`         | `CG`         |
| `CH`         | `CI`         | `CK`         | `CL`         | `CM`         | `CN`         | `CO`         | `CR`         |
| `CV`         | `CW`         | `CX`         | `CY`         | `CZ`         | `DE`         | `DJ`         | `DK`         |
| `DM`         | `DO`         | `DZ`         | `EC`         | `EE`         | `EG`         | `EH`         | `ER`         |
| `ES`         | `ET`         | `FI`         | `FJ`         | `FK`         | `FM`         | `FO`         | `FR`         |
| `GA`         | `GB`         | `GD`         | `GE`         | `GF`         | `GG`         | `GH`         | `GI`         |
| `GL`         | `GM`         | `GN`         | `GP`         | `GQ`         | `GR`         | `GS`         | `GT`         |
| `GU`         | `GW`         | `GY`         | `HK`         | `HM`         | `HN`         | `HR`         | `HT`         |
| `HU`         | `ID`         | `IE`         | `IL`         | `IM`         | `IN`         | `IO`         | `IQ`         |
| `IS`         | `IT`         | `JE`         | `JM`         | `JO`         | `JP`         | `KE`         | `KG`         |
| `KH`         | `KI`         | `KM`         | `KN`         | `KR`         | `KW`         | `KY`         | `KZ`         |
| `LA`         | `LB`         | `LC`         | `LI`         | `LK`         | `LR`         | `LS`         | `LT`         |
| `LU`         | `LV`         | `LY`         | `MA`         | `MC`         | `MD`         | `ME`         | `MF`         |
| `MG`         | `MH`         | `MK`         | `ML`         | `MN`         | `MO`         | `MP`         | `MQ`         |
| `MR`         | `MS`         | `MT`         | `MU`         | `MV`         | `MW`         | `MX`         | `MY`         |
| `MZ`         | `NA`         | `NC`         | `NE`         | `NF`         | `NG`         | `NI`         | `NL`         |
| `NO`         | `NP`         | `NR`         | `NU`         | `NZ`         | `OM`         | `PA`         | `PE`         |
| `PF`         | `PG`         | `PH`         | `PK`         | `PL`         | `PM`         | `PN`         | `PR`         |
| `PS`         | `PT`         | `PW`         | `PY`         | `QA`         | `RE`         | `RO`         | `RS`         |
| `RW`         | `SA`         | `SB`         | `SC`         | `SE`         | `SG`         | `SH`         | `SI`         |
| `SJ`         | `SK`         | `SL`         | `SM`         | `SN`         | `SO`         | `SR`         | `ST`         |
| `SV`         | `SX`         | `SZ`         | `TC`         | `TD`         | `TF`         | `TG`         | `TH`         |
| `TJ`         | `TK`         | `TL`         | `TM`         | `TN`         | `TO`         | `TR`         | `TT`         |
| `TV`         | `TW`         | `TZ`         | `UA`         | `UG`         | `UM`         | `US`         | `UY`         |
| `UZ`         | `VA`         | `VC`         | `VE`         | `VG`         | `VI`         | `VN`         | `VU`         |
| `WF`         | `WS`         | `YE`         | `YT`         | `ZA`         | `ZM`         | `ZW`         |              |

## Supported currencies

Worldline Connect supports processing payments in the following currencies:

| Currency code | Currency code | Currency code | Currency code | Currency code | Currency code | Currency code | Currency code |
| ------------- | ------------- | ------------- | ------------- | ------------- | ------------- | ------------- | ------------- |
| `AED`         | `ALL`         | `AMD`         | `AOA`         | `ARS`         | `AUD`         | `AWG`         | `AZN`         |
| `BAM`         | `BBD`         | `BDT`         | `BHD`         | `BIF`         | `BMD`         | `BND`         | `BOB`         |
| `BRL`         | `BSD`         | `BTN`         | `BWP`         | `BYN`         | `BZD`         | `CAD`         | `CDF`         |
| `CHF`         | `CLP`         | `CNY`         | `COP`         | `CRC`         | `CVE`         | `CZK`         | `DJF`         |
| `DKK`         | `DOP`         | `DZD`         | `EGP`         | `ERN`         | `ETB`         | `EUR`         | `FJD`         |
| `FKP`         | `GBP`         | `GEL`         | `GHS`         | `GIP`         | `GMD`         | `GNF`         | `GTQ`         |
| `GYD`         | `HKD`         | `HNL`         | `HTG`         | `HUF`         | `IDR`         | `ILS`         | `INR`         |
| `IQD`         | `ISK`         | `JMD`         | `JOD`         | `JPY`         | `KES`         | `KGS`         | `KHR`         |
| `KMF`         | `KRW`         | `KWD`         | `KYD`         | `KZT`         | `LAK`         | `LBP`         | `LKR`         |
| `LRD`         | `LSL`         | `LYD`         | `MAD`         | `MDL`         | `MGA`         | `MKD`         | `MMK`         |
| `MNT`         | `MOP`         | `MUR`         | `MVR`         | `MWK`         | `MXN`         | `MYR`         | `MZN`         |
| `NAD`         | `NGN`         | `NIO`         | `NOK`         | `NPR`         | `NZD`         | `OMR`         | `PAB`         |
| `PEN`         | `PGK`         | `PHP`         | `PKR`         | `PLN`         | `PYG`         | `QAR`         | `RON`         |
| `RSD`         | `RWF`         | `SAR`         | `SBD`         | `SCR`         | `SEK`         | `SGD`         | `SHP`         |
| `SOS`         | `SRD`         | `SVC`         | `SZL`         | `THB`         | `TJS`         | `TMT`         | `TND`         |
| `TOP`         | `TRY`         | `TTD`         | `TWD`         | `TZS`         | `UAH`         | `UGX`         | `USD`         |
| `UYU`         | `UZS`         | `VND`         | `VUV`         | `WST`         | `XAF`         | `XCD`         | `XCG`         |
| `XOF`         | `XPF`         | `YER`         | `ZAR`         | `ZMW`         |               |               |               |

## 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](/guides/payments/embed/quick-start)** - A pre-built, customizable
  payment form that handles the complete payment flow
* **[Secure Fields](/guides/payments/secure-fields/quick-start)** - Embed card
  input fields for building custom payment forms while maintaining PCI
  compliance
* **[Mobile SDKs](/guides/get-started#sdks-and-plugins)** - 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](https://docs.connect.worldline-solutions.com/testing/test-card-generator).