# Checkout.com

Adding *Checkout.com* as a credit card gateway to Funnelish is easy. After you create a gateway one time, you can use it again on any number of funnels.

{% hint style="info" %}
This guide assumes you first create an account on the Checkout.com [`sandbox site`](https://www.checkout.com/get-test-account) for testing purposes. Or a [merchant account](https://www.checkout.com/) on the main site and generate live API keys.
{% endhint %}

## Before you start

* [Enable **Funnelish Pay**](https://docs.funnelish.com/start/collecting-payments), before you try adding a payment gateway.
* Add a [**payment form**](https://docs.funnelish.com/start/funnel-builder/editor-forms) to your funnel step.

{% hint style="info" %}
After you have created a gateway, you can use it again on any number of funnels.
{% endhint %}

## Locate your keys

To enable Checkout.com (sandbox version) on Funnelish, create and copy two API keys.

1. Log in to your [**Checkout.com sandbox**](https://www.checkout.com/get-test-account) account.
2. On the side menu, click ***Developers > Keys***.
3. Click the **Create a new key** button.
4. On the next page, click the radio button next to *Public API Key*.
5. Add a key description. (optional)
6. Scroll down to the *Select processing channels* heading and check the box. (required) 
7. Click the **Create key** button.

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FJSwRJoCtW36tO0Ik5LX2%2Fa-2.png?alt=media&#x26;token=ed1e52cc-d209-4c6c-848d-d515e538907a" alt=""><figcaption></figcaption></figure>

On the next page, copy the *Public API Key* and then paste it into a file (e.g., Notepad). Click the *Close* button.

{% hint style="warning" %}
**Do not** copy the ***Key ID** copy the actual **"Key"***.
{% endhint %}

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FuuEmnq5JbpUCYVfY0iBj%2Fa-3.png?alt=media&#x26;token=cac4f341-b5bd-45c8-afc1-9a8b4c084fbc" alt=""><figcaption></figcaption></figure>

### Secret API Key

Now it's time to create the second key.

1. Click the **Create a new key** button.
2. On the next page, click the radio button next to *Secret API Key*.
3. Add a key description. (optional)
4. Under the *Scopes* heading, select **"Default"** or **"Select all"** *(nearly all the scopes are needed for the proper functioning of the checkout.com gateway)*.
5. Scroll down to the *Select processing channels* heading and check the box. (required)&#x20;
6. Click the *Create key* button.

On the next page, copy the *Secret API Key* and then paste it into a file (e.g., Notepad). Click the *Close* button.

{% hint style="warning" %}
**Do not** copy the **Key ID** copy the actual **Secret API Key**.
{% endhint %}

## Create a gateway

Now you're ready to enable Checkout.com (sandbox version) on a funnel.

1. Open a funnel.
2. Click the payment form field.
3. In the left settings panel, click on **Edit payment options**.
4. Click **Connect a new gateway.**
5. In the pop-up window, click **Credit Card**.
6. Click **Add New Credit Card Gateway**. A new window will display, where you can pick **checkout.com**.

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FvcBlmt9oEQqjHmgD0itl%2Fcheckout.com%20gateway.png?alt=media&#x26;token=d396ee3d-1aa4-45d1-bbdc-779388b7fb9c" alt=""><figcaption><p>Checkout.com gateway.</p></figcaption></figure>

7. Now copy the sandbox **Secret Key** and **Public Key** from your file (e.g., Notepad). Paste the keys into the fields.

{% hint style="info" %}
Choose from the following 3D options:
{% endhint %}

* If **Enable 3DS** is toggled, 3D secure verification will be conducted before processing a payment.&#x20;
* If **Attempt non-3DS when possible** is toggled alongside 3DS, we will avoid 3D secure verification whenever possible to reduce friction.

<figure><img src="https://2613769297-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1AQCa9ckIWH7hGfrUV%2Fuploads%2FRR5mADGHjTYygtKmuHBx%2FScreenshot%202025-09-17%20at%2021.19.10.png?alt=media&#x26;token=ebfd73f3-abb7-4d66-8e08-d4b90733c4f9" alt=""><figcaption><p>Confinguring checkout.com gateway.</p></figcaption></figure>

## Test your gateway

1. Locate the funnel step with the payment form and click the URL.
2. Add a product to the cart.
3. Select the Checkout.com payment option.
4. Enter billing details.
5. Enter the following card details:

* Number: `4242 4242 4242 4242`
* Expiry date: any future date
* CVC: any three numbers

&#x20; 5\. Click the **Buy** button to complete the sandbox purchase.

To verify results on the processor end, login to your Checkout.com sandbox account and click **Payments** on the side menu. The test order displays the status of AUTHENTICATION REQUESTED.

Your payment gateway is ready to go live.&#x20;

{% hint style="info" %}
**Troubleshooting**

If the sandbox order does not appear on Checkout.com, verify the API keys. Do not copy the keys with the **ID** in the name.&#x20;
{% endhint %}

## Enable a live gateway

If you're happy with the test results and want to start taking payments right away, contact the [**Checkout.com sales team**](https://www.checkout.com/contact-sales) to move to a live merchant account.

{% hint style="warning" %}
Before you enable a live gateway, make sure you replace the two sandbox API keys in the Funnelish payment gateway with your merchant account API keys.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.funnelish.com/start/collecting-payments/card-payments/checkout.com.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.