> For the complete documentation index, see [llms.txt](https://docs.funnelish.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.funnelish.com/start/collecting-payments/card-payments/checkout.com.md).

# 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**](/start/collecting-payments.md), before you try adding a payment gateway.
* Add a [**payment form**](/start/funnel-builder/editor-forms.md) 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="/files/YPNX3RyGv9l2zPppuA8E" 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="/files/0tm1MG4NCkyIr3RAF28J" 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="/files/bPTxygA96Khnz187VgRR" 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="/files/kzV904A6Wv958lH9FC9c" 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 %}