QuickBooks Payments 

This feature is a Private Beta Release. Contact support  to enable Chargebee-QuickBooks integration for your Test and Live sites.

This document will guide you on how to integrate Quickbooks Payments with Chargebee. Intuit is considered a pioneer in financial accounting software and QuickBooksOnline (QBO) platform is used by numerous small and medium businesses. Thus allowing them to easily manage their accounting, taxes, reconciliation of payments, and generation of financial reports.

The addition of QuickBooks Payments gateway further strengthens QBO as a platform to manage your accounting and payment processing needs. Chargebee now allows you to integrate with QuickBooks Payments as an end-to-end subscription billing solution. This integration will support the following payment methods:

  • Cards
  • Automated Clearing House (ACH)

Choosing QuickBooks Payments Gateway 

Review the following conditions before choosing Quickbooks Payments as your payment solution:

  • Countries Supported: The Merchant Payment Services are available only in the United States (but not the U.S. Virgin Islands, Puerto Rico, and other U.S. territories and possessions). Read more here .
  • Currencies Supported: Click here  for a complete list of supported currencies.
  • Pricing: Click here  to learn more about QuickBooks Payments pricing information.


The following prerequisites must be met prior to setting up the QuickBooks Payments gateway with your Chargebee site:

  • Complete the sign-up process to QuickBooks Payments. Click here  to view the get started guide.
  • Ensure that you have an approved Merchant Account that can accept payments.
  • Enable all required payment methods in QuickBooks Payments that you would make available on your Chargebee integration.

The following prerequisites apply to QuickBooks Payments gateway integration with Chargebee:

  • You must have an active QuickBooks Online account to use the payment gateway.
  • The QuickBooks Payments account (company) connected to your Chargebee site cannot be changed. Additional profiles must be set up independently for each of your QuickBooks Payments companies.
  • Only payment methods that are configured on QuickBooks Payments can be set up on your Chargebee site.
  • The test site and live site must be configured independently. Hence, configurations or data in a test site will not be available on the live site and vice-versa.

Currently, ACH payments are not supported via Chargebee's Checkout and Self-Serve Portal.

Configure QuickBooks Payment Gateway 

Follow the steps below to configure your QuickBooks Payments gateway with Chargebee:

  1. Login to your Chargebee site .

  2. Click Settings > Configure Chargebee > Payment Gateways.

  3. Click Add Gateway > QuickBooks Payments.

  4. Click Connect to an existing account. Click Create one if you don't have an account or would like to create a new one.

  5. Login to your Intuit account and select the Company from the list to proceed.
    You have successfully integrated QuickBooks Payments with your Chargebee account. The details of the connected QuickBooks Payments account are now visible. This connection can be identified by the Company ID that belongs to the company you have selected.

  6. Click Manage in the Cards section.

  7. Always retain card information in QuickBooks Payments when the customer updates it: If you have configured multiple payment gateways in Chargebee, enabling this option stores the updated card information in QuickBooks Payments rather than the default gateway.

  8. Click Save to update your changes.

  9. Click toggle on to accept Direct Debit (ACH) payments.

  10. Configure your permission for customers who can set up Direct Debit(ACH) payments using Checkout and Self-Serve portal.

  11. Review your Smart Routing settings to update gateway preferences to payment methods.

Your QuickBooks Payments gateway is now set up on your Chargebee site and is ready for use.


Click Reconnect if you have any issues associated with the gateway.
Click Archive if you no longer would like to use the gateway on your Chargebee site.

Frequently Asked Questions (FAQs) 

Q1: Can I connect multiple QuickBooks Payments accounts to my Chargebee site?
Ans: Yes, you can configure multiple QuickBooks Payments accounts to a Chargebee site. However, each of these accounts must be configured individually. Additionally, you cannot edit the account details once a connection is established.

Q2: When can I view the status of an ACH payment using QuickBooks Payments?
Ans: With Direct Debit (ACH) payments, the confirmed status of the transaction is viewable three(3) days after the date of the payment.

Q3: Can I change the Company ID associated with an integration?
Ans: The Company ID identifies the integration with your Chargebee site and cannot be changed. You can choose to archive your existing integration and configure an independent integration with the new Company ID.

Was this article helpful?