Skip to main content

Connect Chargebee to Chargeback.io

Connect your Chargeback.io account to Chargebee.

Written by Theodore

Use this guide to connect Chargebee to Chargeback.io so Prevent can automatically refund transactions linked to Ethoca Alerts and Cardholder Dispute Resolution Network (CDRN) alerts. You’ll also learn how to find your Site Key and Site Value and troubleshoot connection issues; and disconnect Chargebee from Chargeback.io.

For auto-refund settings and thresholds, follow Set up auto-refunds for alerts.

How to Connect Chargebee to Chargeback.io

Follow these steps to connect Chargebee to Chargeback.io:

  1. In the sidebar, click Alerts, then select Configure from the dropdown.

  2. On the Configure page, click the Integrate tab.

  3. Find Chargebee.

  4. Click Connect.

  5. When prompted, enter your Site Key and Site Value from Chargebee.

The connection completes instantly in most cases.

If needed, set an auto-refund threshold to limit automatic refunds. See the auto-refund guide for more information.

How to Find Your Site Key and Site Value

This section walks you through finding your Site Key and Site Value in Chargebee.

Part 1: Navigate to API Key Configuration

  1. Log in to your Chargebee account and select the live site containing the transactions you want Chargeback.io to refund.

  2. In the left menu, open the Settings dropdown.

  3. Click Configure Chargebee.

Part 2: Create an API Key

  1. Scroll to the API Keys and Webhooks section.

  2. Click API Keys, then Add API Key.

  3. On the pop-up, choose Full-Access Key (Chargeback.io requires full access).

  4. In the next step, select All, name your API key, and click Create Key.

  5. Click the copy icon next to the key you created. This is your Site Key.

Part 3: Copy Your Site Value

From your browser's URL, copy the text before .chargebee.com/, not including "https://". This is your Site Value.

Example: from https://chb-2-test.chargebee.com/, your Site Value is chb-2-test. This example shows the format only. For live transactions, use your live site's Site Value and an API key from that same live site.

How to Disconnect Chargebee from Chargeback.io

  1. In the sidebar, click Alerts, then select Configure from the dropdown.

  2. On the Configure page, click the Integrate tab.

  3. Find Chargebee in the list.

  4. Click Disconnect.

The disconnection is immediate. After disconnecting, automatic refunds for CDRN and Ethoca alerts stop.

Disconnecting Chargebee does not stop alerts. To stop receiving alerts, fill out the unenrollment form.

Troubleshooting

The connection spins and returns to the connect screen

This usually means the connection didn't complete. Chargebee connections normally finish almost instantly, so a long spin that returns to the connect screen points to a credential issue.

Fix: Confirm you pasted your full-access API key (not the key's name or ID), confirm the key has full access in Chargebee, and double-check your site name is correct. If it still won't connect, take a screenshot of the screen after the spin and contact support.

Your alerts are going to Attention instead of being auto-refunded

If Chargebee was connected before but alerts have started landing in the Attention status, Chargeback.io has likely lost API access to Chargebee, often because the API key was changed or removed.

Fix: Check whether your Chargebee API key was recently changed or revoked, then reconnect Chargebee in your dashboard to restore access.

💬 Still need help? Contact Chargeback.io support.

Related Articles
Did this answer your question?