Guides
  1. processors
  2. QuickBooks Payments

Connecting QuickBooks Payments

Connecting to QuickBooks Payments is an OAuth process. It requires you to log into QuickBooks, which then shares a security token with us. To complete this you need:

  • A QuickBooks login with administrator access on your QuickBooks Payments account.
  • A QuickBooks Online account with QuickBooks Payments enabled. This is available on the Essentials plan and above.

  1. When prompted, select Connect QuickBooks Payments to log in to your QuickBooks Payments account.

    Connect QuickBooks Payments dialog

  2. You will be prompted with a login screen. Log in as an administrator of the account.

    📘

    Tip

    On the QuickBooks authorization screen, the application is listed as "Online Invoice Payments - Stripe, PayPal + more".

    Intuit login screen

  3. You will be prompted to select your company.

    Select your QuickBooks company

    📘

    Tip

    If you see the screen below, you do not have the right type of QuickBooks Online account, or the appropriate permission to complete the OAuth process. Log into QuickBooks, check which users are on your account and their access rights, then retry logging in with an admin / account owner email.

    Create a company to use with your app

  4. When you select your company you will see one of the following screens:

    Better: You have a company but Payments are not yet enabled. Select Set up to enable payments before you can proceed.

    Company selected, payments not yet enabled

    Best: You have a company that is set up and Payments are enabled. Select Next to continue.

    Company selected, payments enabled

  5. Once you select Next, you will be prompted to authorise the connection. Select Connect.

    Authorise the connection

  6. When you are returned to the app, the connection is tested and you are shown a green "Connected to QuickBooks Payments" message. If there is an error with the connection, use the Reconnect button — but take care to connect to the same account, otherwise saved payment methods and refunds will return an error message.

    📘

    Tip

    In some circumstances QuickBooks only authorises the connection for one year. After this you will be required to Reconnect to QuickBooks via the reconnect button.

    Connected to QuickBooks Payments confirmation

Connection options

Our integration with QuickBooks Payments offers several options:

  • Require address (AVS): Requires the customer to enter their billing address.
  • Enable ACH: Enables ACH as a payment method. ACH is available for USD only. You must also enable this option on QuickBooks.