Filling out your app card

Your app listing (or app card) is your app’s display to potential customers on the QuickBooks app store. Use it to tell your potential customers what your app does for them, how it works, and what you charge. Include app features and benefits as well as any other information that helps readers decide if your app solves their problem.

The best app cards are clear, concise, and convey specific value to your customers. Think about the competitive differentiators of your app, and use the app card to explain them.

Access and modify your app listing

  1. From the menu at the top-right select Dashboard and open your app.

View Screenshot

qbo/docs/list-on-the-app-store/create-app-1-v1.png
  1. Click the List on the app store section.
  2. If you haven’t completed verification requirements you will have do this first.

View Screenshot

qbo/docs/list-on-the-app-store/List-app-on-store-account-verification.png
  1. Click Create a listing.
  2. You can fill out a listing by clicking start under App cards by country for any or all regions supported.

View Screenshot

qbo/docs/list-on-the-app-store/List-app-on-store-start-listing.png
  1. You can copy listing details from any region with the copy from dropdown.

HTML support in text fields

In general, the following HTML tags are allowed in app card descriptive text fields.

App listing fields

App icon

Click in the icon area (indicated by an image of an outlined green cube) to upload a thumbnail for your app listing.

Tagline

A short descriptive statement that sells your app, like: *Easy expense management for small businesses on the go!* Maximum 80 characters.

Company URL

Enter the web address (URL) for your company. This can be your company’s home page or a product page. Maximum 1024 characters.

Video

Highlight app features and benefits in a 30-60 second video. Enter only a Vimeo or YouTube URL that begins with https and follows this format:

Maximum 1024 characters.

Screenshots

Enter at least two and up to six screenshots.

These images appear as thumbnails that visitors click to enlarge. Illustrate specific portions of your app (not an entire screen, which is hard to read) and annotate or highlight important features. Images must be .png or .jpg format, and measure 640w x 400h pixels.

Key Benefits

Quick, short paragraphs that list the main benefits provided by your app. At least one is required in order to publish. Maximum 250 characters per benefit.

How it works with QuickBooks

Use this section to explain how your app interacts and enhances the user experience with QuickBooks Online.

Details

A short introductory description that shows on your app card. To enhance your search results, mention that your app integrates with QuickBooks Online. Lead with benefits your app provides so readers know how your app will help them save money, save time, or increase revenue. Maximum 250 characters.

Pricing

Intuit strongly recommends that you offer a free trial to let users test out your app. Free trials are usually 7 to 30 days long, depending on how complex an app is. Consider how long it takes to see the benefits your app offers, and be sure to include time for set-up and learning.

There’s no need to require a credit card for free trial, and doing so is a proven barrier to sign-ups.

FAQs

Enter 1 to 4 frequently-asked questions and their answers. FAQs appear on your app card’s Support tab. Each question is limited to 250 characters, each answer is limited to 500 characters.

*Tip: Common questions include: Is my data secure?, What QuickBooks data is synced with this app?, and Why should I use this app when QuickBooks already offers [blank] features? Enter only text. No HTML or bullets or list.

Support info

You must support your app. Your support contact information appears on your app card’s Support tab.

Analytics & Meta

This section contains additional optional fields.

qbo/docs/list-on-the-app-store/metatag_in_search.png

Preview your app card

At any point during the edit session, you can preview your app card by clicking Preview app card to the right of the edit panel.

Win more global business with country-specific app cards

Don’t just customize your app to work well for businesses in different countries, customize your marketing message too. Complete a custom app card for each individual country. Hone your message and speak directly to different international audiences with targeted product taglines, descriptions, pricing plans, support info, FAQ, and app features/screenshots.

Submit your app

Now that you’ve filled out all your app card information and you’re sure your app meets all technical and security requirements, check out the marketing requirements to ensure that your app listing complies. If so, you’re ready to submit.

Intuit Single Sign-On settings
These settings impact how your app interacts with the QuickBooks app store and how users sign into your app. Refer to the section below that corresponds to your app’s authentication model.
  • Permalink: Enter a string to customize your app’s URL on the QuickBooks app store. For example, entering “AccountingApp” sets your app listing’s URL to https://apps.intuit.com/AccountingApp.
  • Intuit Single Sign-On?: Specify whether your app uses Intuit Single Sign-On. If not, you must provide a URL that users can click to learn more details about your app (see Learn more URL below).
  • Category: To improve searchability as users browse for apps, select the category that your app belongs to.
For apps using Intuit Single Sign-On
  • Connect Request URI: For apps that implement OAuth 2.0, the location in your app to which users are directed upon clicking the Get App Now button. This location initiates the OAuth 2.0 workflow. Upon completion of the OAuth 2.0 workflow, the user is redirected to your app’s dashboard,fully connected to the QuickBooks company.

View Screenshot

qbo/docs/list-on-the-app-store/app_settings_sso.png

  • Host Domain: Your app site domain name. Since your production environment may be different than your development environment, you must provide URLs for both.
  • Launch URL: This is a placeholder for your app’s Launch link.For apps planning to publish on the QuickBooks App Store, this will be the link to the page that implements single sign-on. When Launch is clicked from Quickbooks company, Intuit will call this URL and your app should start the OpenIdConnect (OAuth2) process with OpenId+Email etc. scopes(Do not send accounting). You’ll get back the authorization code & realmId in the callback url and you should be able to obtain the id token and email to determine which user this is and take them to your app’s dashboard page.
  • Disconnect URL: This is a placeholder for your app’s Disconnect link.When Disconnect is clicked from Quickbooks company, Intuit will revoke the token internally and Your user lands on this page after the app disconnects from your user’s QuickBooks company. This url should again perform an OpenIdConnect (OAuth2) process as shown for Launch above, by sending scope as only OpenId+Email etc. (Do not send accounting). Implement the Connect to QuickBooks button and single sign-on on this page using API related scopes like for Accounting, Payments etc so that users can reconnect immediately. So, through this link, when a customer disconnects, Intuit passes your app an OpenID assertion about the user that just disconnected from your app. You can use that assertion to look up the user and mark them as disconnected or send them a message.

Note

Note

OAuth 1.0 will be disabled as of December 17, 2019. If you are currently using OAuth 1.0 for your apps (including apps still under development), be sure you migrate to OAuth 2.0 and (if applicable) OpenID Connect by December 17, 2019.

Intuit Non Single Sign-On settings
Refer to the section below that corresponds to your app’s authentication model.

For apps not using Intuit Single Sign-On

When you have selected No for the Intuit Single Sign-On field, these options will be available.

  • Learn more URL: This is the URL that the Learn More button uses. It redirects users to this link; ideally, the link should contain more information about your app, including pricing, demo/trial information (if available), and details on how to get or install the app. This page should also discuss how the app is used and how it integrates with QuickBooks.
  • Host Domain: Your app site domain name. Since your production environment may be different than your development environment, you must provide domains for both. Note, this is domain only, no protocol.
  • Launch URL: This is a placeholder for your app’s Launch link. The launch URL should be set to your app’s login page.
  • Disconnect URL: This is a placeholder for your app’s Disconnect link.The Disconnect URL should be a static page which informs the user that their QuickBooks connection has been terminated and provide instructions on how to reconnect to QuickBooks from within your app.