# Set up Checkout.com

> Connect Checkout.com to your Bolt merchant account.

Source: https://help.boltapp.com/integrations/payment-processors/checkout-com

Connect Checkout.com to Bolt so Bolt can authorize and capture payments through your Checkout.com account.

## Step 1: Obtain Checkout.com keys [#step-1-obtain-checkoutcom-keys]

1. Log into [The Hub](https://hub.checkout.com/login).
2. Locate your [Secret API key](https://www.checkout.com/docs/the-hub/update-your-hub-settings#Manage_the_channel_settings).
3. If your account uses multiple processing channels, also copy the Processing Channel ID (PCID).

## Step 2: Add keys and edit payment settings [#step-2-add-keys-and-edit-payment-settings]

1. Log into the [production](https://merchant.boltapp.com) or [sandbox](https://merchant-sandbox.boltapp.com) Merchant Dashboard.
2. Go to **Settings** > **Payments**.
3. Click **Set Up Checkout.com**.
4. Enter **Private Key** and, if required, **PCID**.
5. Click **Next**.
6. Edit payment settings, then click **Complete Setup**.

**Expected result:** Checkout.com appears as your active processor under **Settings** > **Payments**.

## Step 3: Set up webhooks [#step-3-set-up-webhooks]

Webhooks keep Bolt and Checkout.com in sync for disputes and disbursements.

1. Log into [The Hub](https://hub.checkout.com/login).
2. Go to **Settings** > **Channels** > **New webhook**.
3. From the Bolt Merchant Dashboard:
   * **URL:** **Settings** > **Payments** > **Manage Checkout.com** (copy the Bolt webhook URL)
   * **Public ID:** **Developers** > **Public ID** (replace `<public-id>` in the URL)
4. Select the [event types](https://www.checkout.com/docs/reporting-and-insights/events-api/event-types) to subscribe to.
5. Click **Create Webhook**.

## Step 4: Configure Checkout.com risk settings [#step-4-configure-checkoutcom-risk-settings]

For saved cards, Bolt does not transmit CVV match data.

### With Fraud Protection [#with-fraud-protection]

Use Checkout.com's [fraud detection rules](https://www.checkout.com/docs/risk-management/fraud-detection/understand-fraud-detection#Manage_rule_groups) to allow shipping and billing address mismatches.

### Without Fraud Protection [#without-fraud-protection]

Tell your fraud provider that payments through this processor will not include CVV match information.

## Step 5: Set up chargeback notifications [#step-5-set-up-chargeback-notifications]

Configure Checkout.com communication preferences for digital chargeback notifications.

## Chargeback handling [#chargeback-handling]

* **With Fraud Protection:** Checkout.com supports manual dispute submissions.
* **Without Fraud Protection:** Follow [Checkout.com's chargebacks process](https://www.checkout.com/docs/risk-management/disputes).

## Testing [#testing]

Use [Checkout.com test cards](https://www.checkout.com/docs/testing/test-card-numbers).

## Limitations [#limitations]

This integration does not support:

* Level 2/3 data
* ACH

## Related [#related]

* [Payment processors](/integrations/payment-processors)
* [Fraud Protection](/products/add-ons/fraud-protection)
