Setup QuickBooks Online

Before you can access data from users using QuickBooks Online for their accounting, you need to set up a QuickBooks Online integration in the Dashboard. You'll need to:

1. Register a new application on Intuit's developer portal.
2. Enter details about your app and complete the app assessment questionnaire.
3. Intuit reviews your questionnaire to ensure your app meets their platform requirements. If your app is approved, you can access your keys to enable your integration.
4. Add your secure keys to Accounting Data as a Service™.

Register your Application

1. Visit Intuit Developer Portal and sign in or create an account.
2. When you're logged in, in the top navigation select My Apps.
3. Click + Create an app.

4. Enter your app name
5. Under Select a scope, select based on the below.
   1. Select com.intuit.quickbooks.accounting
   2. Select com.intuit.quickbooks.payment ( US only ) if you need datatypes like bank accounts, vendor bank accounts, customer bank accounts. Any integration using this will only work for US business connections.
6. Click on Create App

❗

App Development & Production Keys are not Interchangeable

Development keys do not work with live QuickBooks Online accounts and vice versa, Production keys will not work in the Sandbox environment.

7. To obtain the Production keys, go to the Production Menu > Keys & OAuth sub-menu and complete the requested details described in the Add details about your app checklist.
   1. Complete the app assessment questionnaire as described below.
8. When you've completed the requirements, the Keys & OAuth page for production is displayed. Copy your Client ID and Secret. You'll need these for a later stage in this process.
9. To obtain the Development/Sandbox keys, go to the Development Menu > Keys & OAuth sub-menu.

10. In the Redirect URIs section click Add URI and add the URI https://auth.railz.ai/quickbooks/

Enable QBO Payments

Support for QBO Payments is specifically designed for US-based QuickBooks Online (QBO) accounts.

📘

Note

This section is for updating an existing application in QBO. Refer to the section Register Your Application for guidance on creating new API keys.

🚧

Considerations

Ensure that QBO Payments is compatible with your operations by confirming that all your businesses are all US-based.
It is recommended to create new API keys specifically for enabling QBO Payments to ensure better manageability. Refer to the section Register Your Application for guidance on creating new API keys.

To successfully enable QBO Payments, follow these detailed steps:

1. Visit Intuit Developer Portal and sign in or create an account.
2. When you're logged in, in the top navigation select My Apps.
3. Select the desired application to modify.
4. In Production Settings, scroll to Scope for the API, check com.intuit.quickbooks.payment (US only), and save. Note: Scopes cannot be removed once saved.

Complete the App Assessment Questionnaire

Before you can access your application's production keys, you must complete an app assessment questionnaire. Intuit will review your answers to make sure your app meets their publishing requirements and guidelines.

To access the questionnaire:

1. Click Go to the app assessment questionnaire at the bottom of the page.
2. Enter your answers then submit the questionnaire to Intuit.
3. In most cases, Intuit's assessment process is fast. After successfully submitting the questionnaire and providing all other required information, production keys will be unblocked. If not, you’ll be prompted with a request for additional information and the next steps by Intuit. If you are unable to meet Intuit requirements, access to production keys will be blocked.

📘

Need Help With the App Assessment Questionnaire

For more details on how to fill the app assessment questionnaire see our Help Center.

Add your Secure Keys to Accounting Data as a Service™

1. Open the Dashboard and log in.
2. For Sandbox, ensure to Toggle Sandbox mode on.
3. In the left sidebar navigation menu, go to Integrations > Accounting.
4. Scroll down to the QuickBooks Online integration and click Configure.

4. Paste in your Client ID and Client Secret, and then click Save & Enable.