Skip to main content
When you trigger a refund in Upflow for a payment that was previously exported to QuickBooks, Upflow automatically reflects that refund in QuickBooks as an Expense on the original payment’s deposit-to account. If the original payment was applied to one or more invoices, Upflow also creates a Credit Note for each invoice and applies it to the Expense. This applies to every QuickBooks integration. Full refunds no longer void the original payment in QuickBooks, and partial refunds are exported too.
Only Upflow Admin users can trigger a refund. Learn more about generating refunds.

Setup

Before refunds can be exported, make sure your QuickBooks integration settings are complete. From the Integrations settings page, configure:
  • Accounts Receivable (AR) account — the account the refund Expense line posts to. If you work in multiple currencies, set an AR account for each currency you refund in.
  • Partial invoice refund line item — the QuickBooks line item Upflow uses on a Credit Note when the refund covers only part of an invoice.
If either setting is missing when a refund is triggered, the export fails with a clear error message and no partial export is left in QuickBooks. To set an AR account, select the currency first. The account list then shows only QuickBooks accounts that match all of the following:
  • The account type is Accounts Receivable.
  • The account is active.
  • The account currency matches the currency you selected.
If the list is empty, create or reactivate an Accounts Receivable account in that currency in QuickBooks, then reload the Integrations settings page.

Refund of a payment not applied to an invoice

When the original payment is not applied to any invoice in Upflow, we generate the refund in QuickBooks as an Expense and apply it directly to the original payment.

Refund of a payment applied to an invoice

When the original payment was applied to an invoice, Upflow leaves the payment applied to the invoice and creates a Credit Note in QuickBooks. When the refund covers the full invoice, the Credit Note copies the invoice’s line items. The refund is then exported as an Expense, and the Credit Note is applied to that Expense. If the payment covered several invoices, Upflow creates one Credit Note per invoice and applies them all to the same refund Expense.

Partial refund

When a refund covers only part of an invoice, Upflow doesn’t know which invoice line items it corresponds to. The Credit Note uses a single line with the partial invoice refund line item configured in your QuickBooks integration settings, for the refunded amount. The remaining balance stays applied to the original invoice. Credit Notes never add up to more than the amount you refund. For example, a payment of $100 fully pays an invoice, and you refund $40 of it. Upflow creates a $40 Credit Note on that invoice, not a $100 one. When the payment covered several invoices, Upflow credits them one after the other until the refunded amount is used up.

Troubleshooting

If a refund fails to export, check the error message on the refund from the Payments list. The most common causes are a missing setting in your Integrations settings:
  • Refund could not be exported. Please make sure you have selected the AR account in the integration settings. → select the AR account for the refund’s currency and retry the export.
  • Credit note could not be exported. Please make sure you have selected the partial invoice refund item in the integration settings. → select a partial invoice refund line item and retry the export.
Once the setting is fixed, retry the export from the three-dot menu next to the refund on the Payments list.