Voiding an invoice that a payment paid in full succeeds, and the payment stays with its whole amount unused

Observed 2026-10-10 on QuickBooks Enterprise Solutions 24.0 (US), reporting qbXML 17.0.

Voiding an invoice that a payment paid in full succeeds. QuickBooks does not void or delete the payment: the payment keeps its whole amount, and all of it becomes unused. The payment's TimeModified moves to the time of the void, but its EditSequence does not change.

The invoice was paid in full by this payment:

qbXML
<ReceivePaymentAdd>
  <CustomerRef><ListID>80000026-1791590533</ListID></CustomerRef>
  <TxnDate>2026-10-10</TxnDate>
  <TotalAmount>80.00</TotalAmount>
  <PaymentMethodRef><FullName>Cash</FullName></PaymentMethodRef>
  <Memo>Cash</Memo>
  <AppliedToTxnAdd>
    <TxnID>4F4E-1791591367</TxnID>
    <PaymentAmount>80.00</PaymentAmount>
  </AppliedToTxnAdd>
</ReceivePaymentAdd>

A plain TxnVoidRq for the invoice was answered:

qbXML
<TxnVoidRs statusCode="0" statusSeverity="Info" statusMessage="Status OK">
<TxnVoidType>Invoice</TxnVoidType>
<TxnID>4F4E-1791591367</TxnID>
<TimeCreated>2026-10-09T17:16:07-08:00</TimeCreated>
<TimeModified>2026-10-09T18:02:01-08:00</TimeModified>
<RefNumber>INV-0004</RefNumber>
</TxnVoidRs>

The payment then read back as:

qbXML
<ReceivePaymentRet>
<TxnID>4F63-1791591453</TxnID>
<TimeCreated>2026-10-09T17:17:33-08:00</TimeCreated>
<TimeModified>2026-10-09T18:02:01-08:00</TimeModified>
<EditSequence>1791591453</EditSequence>
...
<TotalAmount>80.00</TotalAmount>
...
<UnusedPayment>80.00</UnusedPayment>
<UnusedCredits>0.00</UnusedCredits>
...
</ReceivePaymentRet>

Before the void the same payment answered <UnusedPayment>0.00</UnusedPayment>. The query did not ask for line items, so that the application to the invoice is gone is read from UnusedPayment, not from the payment's AppliedToTxnRet.

What to do

Do not expect a paid invoice's void to be refused, or to take its payment with it. After voiding an invoice, read its payments again: their money is now unused, and nothing in the void's answer says so. An EditSequence you hold for such a payment still works for a Mod, so do not rely on EditSequence alone to notice the change; TimeModified moves.

Not observed

  • An invoice paid down by a credit memo.
  • A part payment, or several payments on one invoice.
  • Whether the payment's AppliedToTxnRet lists the voided invoice with an Amount of 0 or not at all.
  • Voiding a paid bill, or a credit memo already refunded.

QuBe Sync is a JSON API for QuickBooks Desktop that is built on what these findings show.