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
  • 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. Articles and FAQ
  4. QuickBooks Online
  1. Billing
  2. Integrations
  3. Articles and FAQ
  4. QuickBooks Online

Steps to Reconcile Payments between Chargebee and QuickBooks

Scope

Chargebee plugin for QBO not reconciling

Need help running the Chargebee chrome plugin for QBO reconciliation. Currently not matching transactions.

Summary

To ensure reconciling happens between Chargebee and Quickbooks. Please follow the below steps

  1. Download Gateway Statement from Chargebee

  2. Upload Gateway Statement in QuickBooks

  3. Start Reconciliation Process

  4. Review the Reconciled Payments

  5. Map the Gateway Processing Fees

  6. Transfer Settlement Amount to a Bank Account

Solution

1. Download Gateway Statement from Chargebee

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

  1. Connect your Chargebee and QuickBooks accounts. Click Settings > Third-Party Integrations > QuickBooks > Reconciliation to navigate to the QuickBooks integration sync settings page

  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.

image
  1. In the Generate Gateway Statement pop-up, select a gateway account for which you want to download the statement.
image
  1. 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.

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

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

image
  1. 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.

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 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 the 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 which 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.

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

Click here to know more.

Related Articles

QuickBooks - Error code:6000; Business validation error
QuickBooks error code 620: TxnID cannot be linked
QuickBooks - Error code:2500; Third-party request failed
QuickBooks (QBO) sync errors
QuickBooks Online sync error 6140 and 6430
How to change the date format for Payment Gateway statements?
Accounting code provided doesn't exist in QuickBooks
QuickBooks Online - Error code 6200/6210: Account period closed
QBO Error Code:2050
Quickbooks Online error: Sync has failed to complete, you can try again after some time or contact Chargebee Support.
Quickbooks sync error: TRANSACTION - CREATE_FAILED (null)
QuickBooks - Invoice mapping and sync
Prerequisites of Xero/QuickBooks Reconciliation Plug-in
Error 'Null/No' while syncing invoices with QuickBooks Online
How to download gateway statements in QuickBooks/Xero?
Plan could not be created as the Account name you provided does not exist in Quickbooks Online
Error "Entity is not present in Quickbooks" in Quickbooks Online
'How to solve the error "Error: Not a valid product or service name. Names must have at least one character and cannot include tabs, newlines or '':''?'
QB error: Sync status: CREATE_FAILED, The payment chart of account for the invoice payment gateway ELAVON and currency USD was not mapped

Show more

Was this article helpful?