A payment's AppliedToTxnRet lists as LinkedTxn every other payment and credit applied to that invoice, in the order applied, and reads the invoice as it is now; the invoice's own LinkedTxn lists them all, and a credit memo's lists the invoice its credit went to

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

A payment's AppliedToTxnRet lists, as LinkedTxn, everything else applied to that invoice: credit memos and other payments, in the order they were applied, each with LinkType AMTTYPE and a negative Amount. It never lists the payment itself, and it lists a credit memo even when this payment applied no credit. The list is built when the payment is read, so a credit applied later shows up, and the AppliedToTxnRet's own TxnDate and BalanceRemaining are the invoice's as it is now, not as the payment left it. Intuit's reference does not say which transactions the list holds, nor when BalanceRemaining is taken.

A 1.00 payment with no SetCredit, on an invoice that already had a 9.99 credit and then a 30.00 payment applied, answered:

qbXML
<AppliedToTxnRet>
<TxnID>4F49-1791591366</TxnID>
<TxnType>Invoice</TxnType>
<TxnDate>2026-10-10</TxnDate>
<RefNumber>INV-0003</RefNumber>
<BalanceRemaining>238.97</BalanceRemaining>
<Amount>1.00</Amount>
<LinkedTxn>
<TxnID>4F45-1791591365</TxnID>
<TxnType>CreditMemo</TxnType>
<TxnDate>2026-10-10</TxnDate>
<RefNumber>CM-0001</RefNumber>
<LinkType>AMTTYPE</LinkType>
<Amount>-9.99</Amount>
</LinkedTxn>
<LinkedTxn>
<TxnID>4F5C-1791591452</TxnID>
<TxnType>ReceivePayment</TxnType>
<TxnDate>2026-10-10</TxnDate>
<RefNumber>LT2-1001</RefNumber>
<LinkType>AMTTYPE</LinkType>
<Amount>-30.00</Amount>
</LinkedTxn>
</AppliedToTxnRet>

The invoice's own LinkedTxn lists every payment and credit applied to it the same way, and their amounts add up to its AppliedAmount. An InvoiceMod answer includes them; an InvoiceQuery needs IncludeLinkedTxns. A credit memo read with IncludeLinkedTxns lists the invoice its credit went to, not the payment that applied it.

What to do

Do not read a LinkedTxn under a payment's AppliedToTxnRet as something that payment applied: it may be another payment or a credit applied before or after it. Read a payment's BalanceRemaining as the invoice's balance at the time of the read. To know what one payment applied, use its own Amount, and for its credits, the SetCredit your application sent.

Not observed

  • The SetCredit of an InvoiceAdd, in its answer or on the credit memo.
  • A changed invoice RefNumber under an existing payment.
  • A credit memo applied to two invoices, and a ReceivePaymentMod that changes what a payment applies.

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