A ReceivePaymentAdd whose PaymentAmount is more than the invoice's balance is refused with 3210, "You cannot pay more than the amount due.", and nothing is saved
Observed 2026-10-10 on QuickBooks Enterprise Solutions 24.0 (US), reporting qbXML 17.0.
QuickBooks refuses a ReceivePaymentAdd whose PaymentAmount on an AppliedToTxnAdd is more than that invoice's BalanceRemaining. It answers 3210 and saves nothing: no payment is created, and the invoice's balance is unchanged. It does not apply what it can and leave the rest as an unused payment.
This payment tried to put 5000.00 on an invoice that owed 239.97:
<ReceivePaymentAdd>
<CustomerRef><ListID>80000025-1791590451</ListID></CustomerRef>
<TxnDate>2026-10-10</TxnDate>
<RefNumber>LT2-BIG</RefNumber>
<TotalAmount>5000.00</TotalAmount>
<PaymentMethodRef><FullName>Check</FullName></PaymentMethodRef>
<AppliedToTxnAdd>
<TxnID>4F49-1791591366</TxnID>
<PaymentAmount>5000.00</PaymentAmount>
</AppliedToTxnAdd>
</ReceivePaymentAdd>
QuickBooks answered with no ReceivePaymentRet:
<ReceivePaymentAddRs statusCode="3210" statusSeverity="Error" statusMessage="The "AppliedToTxnAdd payment amount" field has an invalid value "5000.00". QuickBooks error message: You cannot pay more than the amount due." />
What to do
Query the invoice first and compare its BalanceRemaining with the amount you are about to apply. To record a payment larger than the invoice owes, apply only the balance to the invoice and leave the rest of TotalAmount unapplied.
Not observed
- Whether "the amount due" is the balance before or after a
SetCrediton the same line.
Error codes on this page
QuBe Sync is a JSON API for QuickBooks Desktop that is built on what these findings show.