Overview
The QuickBooks Online integration is a native OAuth connector. After a business admin connects their QuickBooks company, Audara Pay pushes invoices when you send them and records payments when an invoice is marked paid.
What this integration does
- Create or update QuickBooks invoices from Audara Pay invoices
- Record QuickBooks payments when AUDD settlement is confirmed
- Store the QuickBooks invoice ID on each Audara Pay record for sync status and retry
- Keep amounts in AUD with transaction hash in private notes for audit
What it does not do
- Hold or move AUDD. Settlement stays on-chain between wallets
- Import your full QuickBooks history into Audara Pay
- Replace your bookkeeper or chart of accounts decisions
How it works
- 1
Connect QuickBooks
Admin clicks "Connect QuickBooks" in Settings, signs in with Intuit, selects a company, and approves scopes.
- 2
Invoice sent
When you send an invoice, Audara Pay creates an invoice in QuickBooks Online.
- 3
Payment confirmed
When AUDD settlement is confirmed, Audara Pay posts a payment linked to the QuickBooks invoice.
- 4
Sync status
Invoice detail shows sync status and QuickBooks document number. Failed syncs can be retried.
| Event in Audara Pay | Action in QuickBooks |
|---|---|
| Invoice sent | Create Invoice |
| Invoice updated (before paid) | Update linked invoice |
| Payment confirmed | Create Payment against invoice |
| Invoice voided | Void or credit workflow (TBD) |
Setup
- 1
Connect QuickBooks
Settings → Integrations → QuickBooks → Connect. Sign in with Intuit, select company, approve scopes. Status should show Connected.
- 2
Map defaults
Set income account, GST tax code, deposit account, and customer matching (create vs match by email).
- 3
Send an invoice
Create and send as usual. On send, the connector pushes to QuickBooks. Invoice detail shows sync status and document number.
- 4
Confirm payment
When AUDD is confirmed, Audara Pay records payment in QuickBooks with amount, date, reference, and tx hash in private notes.
Field mapping
Invoice
| Audara Pay | QuickBooks Online | Notes |
|---|---|---|
| invoice_number | Invoice.DocNumber | Must be unique |
| customer.name | Customer.DisplayName | Created if not matched |
| customer.email | Customer.PrimaryEmailAddr | Used for matching |
| issue_date | Invoice.TxnDate | ISO date |
| due_date | Invoice.DueDate | ISO date |
| line_items | Invoice.Line[] | Description, qty, unit AUD, tax |
| hosted_payment_url | CustomerMemo | Optional payer link |
Payment
| Audara Pay | QuickBooks Online | Notes |
|---|---|---|
| amount_aud | Payment.TotalAmt | AUD |
| paid_at | Payment.TxnDate | |
| payment_reference | Payment.PaymentRefNum | |
| tx_hash + network | Payment.PrivateNote | Audit trail |
API reference
You do not call QuickBooks directly from the browser. Audara Pay's connector runs server-side using the QuickBooks Online API.
| Entity | API resource | Use |
|---|---|---|
| Customer | Customer | Create or query by email |
| Invoice | Invoice | Create sales invoice |
| Payment | Payment | Apply payment to invoice |
Troubleshooting
| Symptom | Likely cause | Action |
|---|---|---|
| Connect fails | Redirect URI mismatch | Verify Intuit app config |
| GST calculation differs | Tax code mismatch | Align QBO tax codes with Audara Pay GST |
| Customer duplicate | Name collision | Query QBO by email before create |
| Payment not applied | Invoice already paid | Reconcile manually; check duplicates |
| OAuth token expired | Refresh failed | Reconnect in Settings → Integrations |
FAQ
Will QuickBooks show AUDD as a currency?
No. Invoices and payments are recorded in AUD. AUDD settlement details appear in private notes and references.
One QuickBooks company per Audara Pay org?
Yes, in the initial release.
Does this replace my bookkeeper?
No. It reduces manual entry. Your bookkeeper still owns chart of accounts, BAS, and compliance.