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

All qbXML examples