Skip to content

Set up Checkout.com

Connect Checkout.com to your Bolt merchant account.

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

Step 1: Obtain Checkout.com keys

  1. Log into The Hub.
  2. Locate your Secret API key.
  3. If your account uses multiple processing channels, also copy the Processing Channel ID (PCID).

Step 2: Add keys and edit payment settings

  1. Log into the production or sandbox 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

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

  1. Log into The Hub.
  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 to subscribe to.
  5. Click Create Webhook.

Step 4: Configure Checkout.com risk settings

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

With Fraud Protection

Use Checkout.com's fraud detection rules to allow shipping and billing address mismatches.

Without Fraud Protection

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

Step 5: Set up chargeback notifications

Configure Checkout.com communication preferences for digital chargeback notifications.

Chargeback handling

Testing

Use Checkout.com test cards.

Limitations

This integration does not support:

  • Level 2/3 data
  • ACH

On this page