A payment's UnusedCredits is the credit the customer's credit memos still have when the payment is read, whether or not the payment applied any

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

A payment's UnusedCredits is not a leftover of the payment's own SetCredit, as Intuit's ReceivePaymentAdd reference describes it. QuickBooks works it out each time the payment is answered: the CreditRemaining of the customer's credit memos plus the UnusedPayment of the customer's other payments. The payment's own UnusedPayment does not count.

A customer had one credit memo with <CreditRemaining>12.50</CreditRemaining>. A ReceivePaymentAdd of 40.00 to one of the customer's invoices, with one AppliedToTxnAdd and no SetCredit, was answered with:

qbXML
<TotalAmount>40.00</TotalAmount>
...
<UnusedPayment>0.00</UnusedPayment>
<UnusedCredits>12.50</UnusedCredits>

A second payment of 50.00 to another invoice, again with no SetCredit, also answered <UnusedCredits>12.50</UnusedCredits>. After a later payment applied all 12.50 of the credit memo, both payments read back with <UnusedCredits>0.00</UnusedCredits>, though neither had changed.

For a customer with no credit memos, a payment of 150.00 that applied 100.00 left UnusedPayment 50.00. A second payment of 40.00 with IsAutoApply false, which left UnusedPayment 40.00, answered:

qbXML
<UnusedCredits>50.00</UnusedCredits>

The first payment then read back with <UnusedCredits>40.00</UnusedCredits>.

What to do

Do not store a payment's UnusedCredits as a fact about that payment, or read it as credit the payment left over. It describes the customer's open credit at the moment the payment was read, and it changes when other transactions of the customer change. To know what a payment itself left unapplied, read its UnusedPayment.

Not observed

  • Whether credit memos on a customer's jobs, or on a job's parent customer, count.
  • Whether credits from sales receipts or refunds count.
  • A ReceivePaymentMod answer.

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