A ReceivePaymentAdd of TotalAmount 0.00 that only applies credits creates no payment, and answers a ReceivePaymentRet holding nothing but each applied transaction's TxnID and TxnType
Observed 2026-10-09 on QuickBooks Enterprise Solutions 24.0 (US), reporting qbXML 17.0.
A ReceivePaymentAdd with TotalAmount 0.00 that only applies a credit memo through SetCredit creates no payment. QuickBooks applies the credit, but its ReceivePaymentRet has no TxnID, TimeCreated, EditSequence or amounts: just an AppliedToTxnRet with the TxnID and TxnType of the invoice.
This request applied a 12.50 credit memo to an invoice:
<ReceivePaymentAddRq>
<ReceivePaymentAdd>
<CustomerRef><ListID>80000022-1791562995</ListID></CustomerRef>
<TxnDate>2026-10-09</TxnDate>
<RefNumber>LEDGERLY-PMT-3</RefNumber>
<TotalAmount>0.00</TotalAmount>
<Memo>Credit CM-0001</Memo>
<AppliedToTxnAdd>
<TxnID>4F08-1791563722</TxnID>
<SetCredit>
<CreditTxnID>4F04-1791563720</CreditTxnID>
<AppliedAmount>12.50</AppliedAmount>
</SetCredit>
</AppliedToTxnAdd>
</ReceivePaymentAdd>
</ReceivePaymentAddRq>
The complete answer:
<ReceivePaymentAddRs statusCode="0" statusSeverity="Info" statusMessage="Status OK">
<ReceivePaymentRet>
<AppliedToTxnRet>
<TxnID>4F08-1791563722</TxnID>
<TxnType>Invoice</TxnType>
</AppliedToTxnRet>
</ReceivePaymentRet>
</ReceivePaymentAddRs>
The invoice's balance fell by 12.50 and the credit memo's remaining credit went to 0. A ReceivePaymentQueryRq by the request's RefNumber then answered 500, "There was a required element ("LEDGERLY-PMT-3") that could not be found in QuickBooks.", and a query by customer listed only the customer's earlier payments. The credit shows up as a LinkedTxn to the credit memo, with a negative Amount, under the AppliedToTxnRet of a payment already applied to that invoice, and on the invoice's own LinkedTxn.
What to do
Do not expect a payment id from a credit-only ReceivePaymentAdd, and do not read the applied amount from its answer; read the invoice and the credit memo back to confirm what was applied. If such a request's answer is lost, do not look for the payment by RefNumber to decide whether to send it again: no payment exists either way, and sending it again could apply the credit twice. Check the credit memo's CreditRemaining instead.
Not observed
- A credit-only payment with
TotalAmountleft out, or with aPaymentAmountof0.00beside theSetCredit. - Several invoices in one credit-only payment.
- A
TotalAmountabove zero with only credits applied. - The request was sent as qbXML 16.0; other versions were not tried.
Error codes on this page
QuBe Sync is a JSON API for QuickBooks Desktop that is built on what these findings show.