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

All qbXML examples