Checkout.com - Card

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

​

Setup

Please follow the common Checkout.com instructions 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 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 for how to find each of the required credentials.

​

Capabilities

This connector supports the Mastercard Transaction Link Identifier (TLID). Gr4vy stores the TLID from the first customer-initiated payment and sends it on later merchant-initiated payments, with nothing to enable. This connector only accepts Visa and Mastercard network tokens. A network token for another scheme fails with the unsupported_scheme error code, so use a Flow rule on the card scheme to route those cards elsewhere.

​

Supported countries

​

Supported currencies

​

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 - 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 - Embed SDKs for iOS, Android, and React Native

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.

​

Testing

For testing in sandbox environments, use the test cards listed in the Checkout.com testing documentation.