ReceivePaymentAdd qbXML example
Records a customer's payment and applies it to an invoice.
qbXML
ReceivePaymentAddRq, version 16.0
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="16.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<ReceivePaymentAddRq>
<ReceivePaymentAdd>
<CustomerRef>
<FullName>Acme Corp</FullName>
</CustomerRef>
<TxnDate>2026-01-20</TxnDate>
<RefNumber>4417</RefNumber>
<TotalAmount>250.00</TotalAmount>
<PaymentMethodRef>
<FullName>Check</FullName>
</PaymentMethodRef>
<Memo>Check 4417</Memo>
<DepositToAccountRef>
<FullName>Undeposited Funds</FullName>
</DepositToAccountRef>
<AppliedToTxnAdd>
<TxnID>1A2B-1700000000</TxnID>
<PaymentAmount>250.00</PaymentAmount>
</AppliedToTxnAdd>
</ReceivePaymentAdd>
</ReceivePaymentAddRq>
</QBXMLMsgsRq>
</QBXML>
Open in the validator
Check it against the qbXML 16.0 schema, edit it, and run it in your own QuickBooks.
Things to know
- Name each invoice the payment pays in an AppliedToTxnAdd, or send IsAutoApply true and let QuickBooks choose.
- Write amounts with two decimals (40.00, not 40). QuickBooks refuses a whole-number amount with status 3040, though the schema allows it.
- A payment of more than an invoice's balance is refused with 3210, "You cannot pay more than the amount due."
- QuickBooks numbers an invoice that has no RefNumber, but not a payment: a payment without one is saved without one.
The same request with QuBe Sync's API
QuBe Sync takes this JSON, writes the qbXML for you and delivers QuickBooks' answer to your webhook as JSON.
POST
/api/v2/connections/{connection_id}/payments
{
"applied_to_txn_add": [
{
"payment_amount": 250.0,
"txn_id": "1A2B-1700000000"
}
],
"customer_ref": {
"full_name": "Acme Corp"
},
"deposit_to_account_ref": {
"full_name": "Undeposited Funds"
},
"memo": "Check 4417",
"payment_method_ref": {
"full_name": "Check"
},
"ref_number": "4417",
"total_amount": 250.0,
"txn_date": "2026-01-20"
}
Every field ReceivePaymentAdd takes is in Intuit's reference.
More requests
Customers and sales