Xero sync errors - A currency rate must be specified

Problem Statement

Invoices or credit notes fail to sync with "A currency rate must be specified." This often appears when the base currency in Chargebee does not match the base currency in your Xero organisation.

Solution

Use one of these approaches:

Option 1: Align base currencies. Change the base currency in Chargebee to match Xero (e.g. to GBP), or change the base currency in Xero to match Chargebee (e.g. to USD). Chargebee base currency changes require support; Xero changes are done in your Xero organisation settings.

Option 2: In Chargebee, under Settings > Apps > Xero > Manage mapping (or Third-party Integrations > Xero > Manage mapping), configure the same currency bank accounts for payments and refunds as in Xero. This ensures the integration uses the correct accounts and currency.

Chargebee mapping:

Xero bank accounts: