Set up 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

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 API Key (your Secret API key) and, if required, Processing Channel ID.
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 Total Fraud Protection

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

Without Total 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

• With Total Fraud Protection: Checkout.com supports manual dispute submissions.
• Without Total Fraud Protection: Follow Checkout.com's chargebacks process.

Testing

Use Checkout.com test cards.

Limitations

This integration does not support:

• Level 2/3 data
• ACH

Related

• Payment processors
• Total Fraud Protection