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

# Checkout.com - Card

> Connect to Checkout.com to accept card payments.

Checkout.com is a global payment platform that supports card payments across
multiple regions.

## Setup

Please follow the [common Checkout.com instructions](./checkoutcom) to create an
account.

## Connector configuration

After setting up your Checkout.com connector in the dashboard, configure how
transactions are routed to it. Choose one of the following options:

* **Using Flow** - Configure Checkout.com 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
  Checkout.com 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

Please follow the [common Checkout.com instructions](./checkoutcom) for how to
find each of the required credentials.

## Features

To use Checkout.com your account needs to be enabled for their `full API`
feature. To enable it, please contact the Checkout.com Integration team at
[integration@checkout.com](mailto:integration@checkout.com).

Checkout.com 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
* **Partial authorization** - Support partial approval responses
* **Void** - Cancel an authorized transaction before capture
* **Zero auth** - Verify a card without charging it
* **Refunds** - Refund a captured payment
* **Digital wallets** - Support for Apple Pay, Google Pay, and other wallet
  integrations
* **Network tokens** - Enable network tokenization when supported by Checkout.com
* **3-D Secure** - 3DS authentication

## Supported countries

Checkout.com supports transactions from buyers in the following countries:

| Country code | Country code | Country code | Country code | Country code | Country code | Country code | Country code |
| ------------ | ------------ | ------------ | ------------ | ------------ | ------------ | ------------ | ------------ |
| `AT`         | `AU`         | `BE`         | `BG`         | `BR`         | `CA`         | `CH`         | `CY`         |
| `CZ`         | `DE`         | `DK`         | `EE`         | `ES`         | `FI`         | `FR`         | `GB`         |
| `GR`         | `HK`         | `HU`         | `IE`         | `IN`         | `IT`         | `JP`         | `LT`         |
| `LU`         | `LV`         | `MT`         | `MX`         | `MY`         | `NL`         | `NO`         | `NZ`         |
| `PL`         | `PT`         | `RO`         | `SE`         | `SG`         | `SI`         | `SK`         | `US`         |

## Supported currencies

Checkout.com supports processing payments in the following currencies:

| Currency code | Currency code | Currency code | Currency code | Currency code | Currency code | Currency code | Currency code |
| ------------- | ------------- | ------------- | ------------- | ------------- | ------------- | ------------- | ------------- |
| `AED`         | `AFN`         | `ALL`         | `AMD`         | `AOA`         | `ARS`         | `AUD`         | `AWG`         |
| `AZN`         | `BAM`         | `BBD`         | `BDT`         | `BIF`         | `BMD`         | `BND`         | `BOB`         |
| `BRL`         | `BSD`         | `BWP`         | `BZD`         | `CAD`         | `CDF`         | `CHF`         | `CLP`         |
| `CNY`         | `COP`         | `CRC`         | `CVE`         | `CZK`         | `DJF`         | `DKK`         | `DOP`         |
| `DZD`         | `EGP`         | `ETB`         | `EUR`         | `FJD`         | `FKP`         | `GBP`         | `GEL`         |
| `GIP`         | `GMD`         | `GNF`         | `GTQ`         | `GYD`         | `HKD`         | `HNL`         | `HTG`         |
| `HUF`         | `IDR`         | `ILS`         | `INR`         | `ISK`         | `JMD`         | `JPY`         | `KES`         |
| `KGS`         | `KHR`         | `KMF`         | `KRW`         | `KYD`         | `KZT`         | `LAK`         | `LBP`         |
| `LKR`         | `LRD`         | `LSL`         | `MAD`         | `MDL`         | `MGA`         | `MKD`         | `MMK`         |
| `MNT`         | `MOP`         | `MUR`         | `MVR`         | `MWK`         | `MXN`         | `MYR`         | `MZN`         |
| `NAD`         | `NGN`         | `NIO`         | `NOK`         | `NPR`         | `NZD`         | `PAB`         | `PEN`         |
| `PGK`         | `PHP`         | `PKR`         | `PLN`         | `PYG`         | `QAR`         | `RON`         | `RSD`         |
| `RUB`         | `RWF`         | `SAR`         | `SBD`         | `SCR`         | `SEK`         | `SGD`         | `SHP`         |
| `SLE`         | `SOS`         | `SRD`         | `SZL`         | `THB`         | `TJS`         | `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
* **Payment method tokenization** - Storing payment methods outside of
  transactions using a separate tokenization flow
* **Transaction sync** - Transaction synchronization is not supported

## Integration

To accept card payments with Checkout.com, 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 Checkout.com connection based on
your Flow rules or explicit `payment_service_id` parameter.
