The information in this section is for apps preparing to be listed on the QuickBooks app store. When published, your app is available to your users via the Get App Now button from your app card. In this model, the Get App Now button (implemented by Intuit) seamlessly initiates both user authentication and authorization workflows.
The user initiates the sign in process by finding your app, either on the QuickBooks app store or from the QuickBooks Online Apps tab, and clicking the Get App Now button. If the user is not already logged into their QuickBooks account, they are prompted for their Intuit ID and password. Control is then redirected to your app’s Intuit single sign-on endpoint, as defined in the app’s settings on developer.intuit.com. From there:
OAuth 2.0/OpenID Connect integrations
Implement the Connect Request URL endpoint
The Connect Request URL endpoint, as defined in the app’s settings on developer.intuit.com, is the location in your app to which Intuit OAuth 2.0 service redirects your user after they click the Get App Now button. Code at this endpoint initiates a request to the Intuit OAuth 2.0 server to both authenticate the user and to authorize your app’s access to your user’s QuickBooks company. Specify OpenID Connect authentication scopes along with one or both of the following authorization scopes:
com.intuit.QuickBooks.accounting—QuickBooks Online API
com.intuit.QuickBooks.payment—QuickBooks Payments API
OAuth 1.0a/OpenID 2.0 integrations
Implement the OpenID URL endpoint
The OpenID URL endpoint, as defined in the app’s settings on developer.intuit.com, is the location in your app to which Intuit OpenID services redirects your user after they click the Get App Now button. You provide code at this endpoint to perform the following tasks:
The call to directConnectToIntuit() redirects the user to the location in your code that implements the OAuth workflow. It’s as if the user clicked the Connect to QuickBooks button directly on your app. You provide code at this endpoint to implement the OAuth workflow. See Implement OAuth1.0a for details.
Test QuickBooks app store connect
For apps published on the QuickBooks app store, the user starts the app subscription and OpenID flow by clicking the Get app now button on the app card for the published app. To simulate this flow before your app is published, perform these steps:
From developer.intuit.com, select the My Apps tab and click on your app. The app’s dashboard is displayed.
In the Resources section click on the link labeled Test in production. The Create your account dialog may be displayed if the customer is not already signed in to their QuickBooks cmopany. If not already signed in, your customer can create an account or use their existing Intuit account.
After the user is signed in, the QuickBooks company selector is displayed. If the user has only one company in his account, this dialog is omitted from the workflow.
After the user selects a company, the authorize dialog is displayed.
Click Authorize and verify that the app’s landing page, as defined with the Launch URL in your app settings, appears.