This is a staging build of the docs
Skip to main content

Use the hosted app

Use the hosted demo app to connect to sandbox data, then view and pay bills. To close the loop, see how payments are reconciled in QuickBooks

🚀 In this section, you will:

  • Connect the demo app to QuickBooks Online
  • View bills
  • Pay a bill

Prerequisites

Before using the demo app, sign up for a QuickBooks Online account at https://quickbooks.intuit.com. You'll need to enter your account credentials when connecting the demo app to QuickBooks Online.

Your account will include a US sandbox company containing sample data; you can open this company and take a look at some bills, bill payments, and other relevant sandbox data.

Connect the demo app to QuickBooks Online

First, launch the demo app and complete the authorization flow.

  1. Open the demo app.
  2. On the Bill Pay start screen, click Get Started.

  3. Create a new company.

  4. Select the Intuit QuickBooks Sandbox integration.

  5. In the login dialog, enter your Intuit account credentials and select any sandbox QuickBooks Online company.

  6. The Connection Successful screen is displayed once you've connected your accounting platform:

    bill-pay_launch-bills-portal-screen

    Click Launch Bills Portal to open the demo app.

For more details about how the app creates a connection to QuickBooks Online via Hosted Link, see Understand the authorization flow.

View bills

Once you've connected your accounting platform, you'll see a table of open and paid bills from the company you just connected. These are pulled from your sandbox QuickBooks Online company and ordered by issue date.

bill-pay_app-view

  1. If you can only see paid bills, use the View unpaid bills only toggle to filter the list.

  2. Click View next to an unpaid bill to open the Bill view.

    bill-pay_invoice-detail-dialog

    This contains additional information about the bill, including the bill number, due date, and line items (if any).

  3. Click Pay Bill to make a payment against the bill.

Pay a bill

Next, you can make a payment against a bill. When you do so, the app automatically pushes a bill payment to the accounting platformin this case, QuickBooks Online. The payment is then reconciled against the source bill, which is marked as paid.

  1. In the Bill Payment view, choose an account from the Account name dropdown. This is the account in QuickBooks Online to which you want to assign the bill payment.

    bill-pay_payment-view

    Accounts displayed

    Only banking accounts in the same currency as the bill are displayed.

  2. (Optional) Enter mock payment card details.

    Card details

    We've included the card details section to show how Codat can be used with other systems, such as payment providers, to enhance bill payment apps.

  3. Click Pay Bill to pay the total amount of the bill.

You've now seen the app in action by viewing and paying bills.

Optional: See that the payment was reconciled in QuickBooks

Finally, you can check that your payment was reconciled correctly in QuickBooks Online. Bill payments are initially in a "pending" status, but this should change to "paid" after around a minute.

Asynchronous push

In Codat, create and update operations are asynchronous, which means that pushing data to an accounting platform returns a push operation in Pending status. Our webhooks allow your solution to be notified of a push operation change; alternatively you can poll as described in Polling.

  1. Sign in to the Intuit Developer Portal.

  2. From the API Docs & Tools tab, open the sandbox company you connected to the demo app.

  3. In the sidebar, select Get paid & pay.

  4. Check the status of the bill you paid in the demo app:

    1. Select Bills > Paid.
    2. Select the bill and check the payment status is Paid.

    bill-pay_bill-status-paid

  5. Check which bank account the payment was reconciled to:

    1. Go back to Bills > Paid.
    2. In the Action column, select Show payments to reveal the payment row.
    3. Click View details to open the bill payment that corresponds to the bill.
    4. Check the Bank/Credit account dropdown contains the account you assigned the payment to.

    bill-pay_bill-payment-status

Recap

You've used the demo app to view bills and make a payment. You also checked the source data in QuickBooks Online to understand the payment reconciliation process.


Now that you've tried out the demo app, you can:


Was this page useful?
❤️
👍
🤔
👎
😭