BillPaymentCheckAdd qbXML example
Pays one or more of a vendor's bills by check.
qbXML
BillPaymentCheckAddRq, version 16.0
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="16.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<BillPaymentCheckAddRq>
<BillPaymentCheckAdd>
<PayeeEntityRef>
<FullName>Northwind Supplies</FullName>
</PayeeEntityRef>
<TxnDate>2026-02-10</TxnDate>
<BankAccountRef>
<FullName>Checking</FullName>
</BankAccountRef>
<RefNumber>2051</RefNumber>
<Memo>INV-2291</Memo>
<AppliedToTxnAdd>
<TxnID>1A2B-1700000000</TxnID>
<PaymentAmount>138.50</PaymentAmount>
</AppliedToTxnAdd>
</BillPaymentCheckAdd>
</BillPaymentCheckAddRq>
</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
- Write amounts with two decimals (40.00, not 40). QuickBooks refuses a whole-number amount with status 3040, though the schema allows it.
- A *Ref that names a record QuickBooks doesn't have answers 3120 when it gives a ListID and 3140 when it gives a FullName.
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}/bill-payment-checks
{
"applied_to_txn_add": [
{
"payment_amount": 138.5,
"txn_id": "1A2B-1700000000"
}
],
"bank_account_ref": {
"full_name": "Checking"
},
"memo": "INV-2291",
"payee_entity_ref": {
"full_name": "Northwind Supplies"
},
"ref_number": "2051",
"txn_date": "2026-02-10"
}
Every field BillPaymentCheckAdd takes is in Intuit's reference.
More requests
Vendors and purchases