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:

qbXML
<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:

qbXML
<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 (&quot;LEDGERLY-PMT-3&quot;) 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 TotalAmount left out, or with a PaymentAmount of 0.00 beside the SetCredit.
  • Several invoices in one credit-only payment.
  • A TotalAmount above 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.