New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now

Docschargebeedocs

HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Developer Resources
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model context protocol)

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Invoices, Credit Notes and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Managing payments with ChargebeeJS
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
    • QuickBooks Online
      • Configuring QuickBooks
      • Record Mapping in QuickBooks
      • QuickBooks Customer Mapping
      • Reconciling Chargebee Invoices with QuickBooks
      • Reconnecting QuickBooks to Chargebee
      • Objects and Fields Mapped between Chargebee and QuickBooks
      • Quickbooks common sync errors
    • Xero
    • Sage Intacct
    • Oracle NetSuite
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Order Management
  • Mobile Subscriptions (Legacy)
  • Other Integrations
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Integrations
  3. Finance
  4. QuickBooks Online
  5. Reconciling Chargebee Invoices with QuickBooks
  1. Billing
  2. Integrations
  3. Finance
  4. QuickBooks Online
  5. Reconciling Chargebee Invoices with QuickBooks

Reconciling Chargebee Invoices with QuickBooks

Introduction

Reconciliation is the process of confirming that the balance in the Accounting books matches the balance in the Statement (gateway statement, bank statement, etc).

Reconciliation helps your accounting team confirm that all the amounts appearing in the statement are recorded in the books of accounts and a clear explanation emerges for the unreconciled items.

Note

  • Only Chargebee sites with Stripe gateway configured are supported.

Problem Statement

You have a number of invoices processed on a daily basis. The payments are initiated from Chargebee and processed by your gateway. The gateway transfers the final amount (as a lump sum) at the end of the day or after a few days depending on the gateway, with no correlation to the original invoices for which payments are processed. The problem statement is as follows:

How do you reconcile the invoices/transactions with the bank statement when one lump sum amount is deposited in the bank account (when you do not know which individual invoices make up the lump sum amount)?

Bank TransactionInvoices/Transactions
Sum of $490 credited to the Bank Account on 4th JanCustomer 1 - Invoice 001 - $99 (Paid on 2nd Jan)
Customer 2 - Invoice 002 - $99 (Paid on 2nd Jan)
Customer 3 - Invoice 003 - $99 (Paid on 2nd Jan)
Customer 4 - Invoice 004 - $99 (Paid on 2nd Jan)
Customer 5 - Invoice 005 - $99 (Paid on 2nd Jan)
image

Note

Stripe cannot be connected to QuickBooks to download the statement (as you can with your bank accounts).

Recommended Approach

The reconciliation process can be simplified by following the steps mentioned below [this is a recommendation from Chargebee and may vary depending on different accounting practices]:

  • Create a bank account for the gateway (in addition to your physical bank account).
  • Download gateway statement from Chargebee.
  • Upload gateway statement into this bank account.
  • Use Chargebee's Chrome plugin to perform reconciliation.

In the same example above, an account is created in QuickBooks and the gateway statement is uploaded.

image
Invoices/TransactionsGateway StatementBank Transactions
Customer 1 - Invoice 001 - $99 (Paid on 2nd Jan)Transaction processed, for $99 
Customer 2 - Invoice 002 - $99 (Paid on 2nd Jan)Transaction processed, for $99 
Customer 3 - Invoice 003 - $99 (Paid on 2nd Jan)Transaction processed, for $99 
Customer 4 - Invoice 004 - $99 (Paid on 2nd Jan)Transaction processed, for $99 
Customer 5 - Invoice 005 - $99 (Paid on 2nd Jan)Transaction processed, for $99 
 Processing Fee $5.00 
 Transfer $490 to Bank account on 4th JanSum of $490 credited to the account on 4th Jan

Note

The gateway processing fees will be aggregated and shown in the gateway statement export if multiple fee line items were applied in your gateway statement.

Set up Clearing Account

  • You can create a clearing account of type "Bank" in QuickBooks and select the account in Chargebee while setting up the integration.
  • Payment and refunds can be mapped to one bank account only. You cannot map payments to one bank account and refunds to another.
  • You can create more than one clearing account if you have multiple currencies or gateways configured in your Chargebee site so that payments and refunds can be mapped to multiple clearing accounts. Example: A clearing account for Stripe, another account for GoCardless, or based on currencies.
  • If you have selected a bank account and want to change the bank account to a clearing account, you can click Sync Preferences > Manage Mapping and edit the account selected.
image

Steps to Reconcile Payments between Chargebee and QuickBooks

1. Download Gateway Statement from Chargebee

If you have not enabled reconciliation during initial configuration, you can start the setup and select a clearing account.

  1. Connect your Chargebee and QuickBooks accounts. Click Apps > Go to Marketplace > Accounting > QuickBooks > Reconciliation to navigate to the QuickBooks integration sync settings page.

    image
  2. Click Generate New Statement under the Reconciliation tab. The Reconciliation tab displays up to five recently generated gateway statements. You can also view the generated time and the date range of these statements. Note that the date and time range should not exceed two months.

image
  1. In the Generate Gateway Statement pop-up, select a gateway account for which you want to download the statement.

    image
  2. Select the date range for which the statement should be downloaded. You can choose to download from Last reconciliation till current date or select start and end date, as required.

    image
  3. You can optionally select Include pending transactions for charges, payments and refunds that are in progress status to be included in the reconciliation statement.

  4. Similarly, select Include unsettled payouts to include settlements and bank transfers that are in progress status to be included in the reconciliation statement.

    image
  5. Click Generate to generate a new gateway statement for the selected date range. Once the statement is generated, you can download the statement and upload it to your QuickBooks account.

Note

  • Gateway statement can be downloaded for transactions made after March 15, 2017 only.
  • When you provide a date range, you can select dates within two months range only while exporting the gateway statement.

2. Upload Gateway Statement in QuickBooks

If you have an existing gateway account in QuickBooks to manage the gateway statement, you can use that, or you can create a new bank chart of account and import the Gateway statement.

image

Note

  • When you upload the gateway statement and map the bank account fields with the CSV file fields, make sure that the date format is in sync with the date format selected while generating the payment gateway statement in Chargebee.

3. Start Reconciliation Process

  1. Download and install the Chargebee's browser extension for Chrome.
  2. After the gateway transactions have been imported into QuickBooks, run the Chargebee's Payment Reconciliation plugin.
  3. Before running the plugin, make sure that the date format in your QuickBooks account is in sync with the date format selected while generating the payment gateway statement in Chargebee.
  4. The plugin will start searching for transactions and find matches automatically.

Chargebee's plugin is compatible with the current reconciliation logic and User Interface (UI) of QuickBooks. Any further updates on the QuickBooks reconciliation logic or UI will not be supported automatically by the plugin and might disrupt the reconciliation process.

image

Note

  • If a match is not found, the extension will skip the entry and proceed to the next transaction.
  • The extension will not match Gateway Fees and Settlement/transfers to Bank, these should be reconciled as explained in the following steps.

4. Review the Reconciled Payments

  1. Click Reconciliation option in the menu from Settings.
  2. Select the clearing/gateway account, enter the date and bank balance to begin the review process.
  3. The transactions that have matched will be auto-selected.
  4. Click Finish Now.

5. Map the Gateway Processing Fees

  1. Navigate to the Gateway account.
  2. Select an expense (or any Account) and map the gateway processing fees.
image

6. Transfer Settlement Amount to a Bank Account

After the Payments and refunds are reconciled, the settlement entries should be reconciled. You need to transfer the lump sum amount from the Gateway account to an actual Bank Account.

image

Now run the Reconciliation process for the Bank Account as well. Reconciliation is now complete and all entries are processed.

image

Reconciling Multi-currency Invoices

  • Chargebee's plugin does not support reconciliation if you have set up multi-currency in your QuickBooks account. You can contact support to obtain gateway statement based on currencies.
  • If you have multiple currencies in Chargebee and a single bank account in Stripe, Stripe applies the exchange rate while processing payments. Chargebee syncs the exchange rate used in Stripe to QuickBooks. You should manually reconcile such transactions. For example, if the base currency in QuickBooks is CAD, the reconciliation account has CAD currency, and exchange rate is applied on the payment.
  • Chargebee's plugin works only when the reconciliation account currency and the payment currency are the same.

FAQ

1. Will the gateway statement be converted into QuickBooks format?

When you download the statement from Chargebee, Chargebee will convert it to a format accepted by QuickBooks, so you do not have to convert the files again.

2. How are multi-currency invoices managed?

For multi-currency users, the exchange rate will be derived from the Gateway involved.

3. Why should I enable Include pending transactions and Include unsettled payouts?

Payment transactions and payment gateway payouts between your bank and gateway accounts do not happen in real-time. Let's say you are using the Stripe payment gateway for payment processing and you have a few transactions initiated via Stripe for the last week of May. You might actually see these amounts credited in your bank account only in the first week of June, until when they are marked "in progress" in your gateway statement. Similarly, Stripe payouts towards your bank account that includes settlements might take a while to be processed and does not happen in real time with every transaction.

image

Some businesses may find this sort of time lag difficult because it could come in the way of the reconciliation process. To address this time lag and to help you with successful reconciliation during any given period of time, you can enable Include pending transactions and Include unsettled payouts. This will help reconcile all amounts successfully, even those that are in pending status.

4. Where does the payment reconciliation plugin operate within QuickBooks Online (QBO)?

The plugin will be initialized only at the Transaction > Bank transactions page of QBO and will run on the same page.

image

Articles & FAQs

How to change the date format for Payment Gateway statements?
Steps to Reconcile Payments between Chargebee and QuickBooks

Was this article helpful?