Sign in
Purchase

Insert a payment for a purchase

Record a payment made against a purchase order. Each call adds one payment; there is no upsert here, so calling it again adds another payment rather than editing an existing one. The response is the created payment.

The payment rolls up into the purchase: the purchase's paid total increases by this amount and its payment_status is recomputed (NOT_PAID → PARTIALLY_PAID → FULLY_PAID, or OVER_PAID if payments exceed the total). Fetch the purchase again to observe the new totals. If your company is integrated with QuickBooks Online, the payment is also recorded against the linked bill using the deposit account you supply.

A 404 is returned if the purchase does not exist or is not in your company.

Required permission: purchases_permissions_make_payments. The authenticated user must also be allowed to view purchases under their team restrictions.

post/public/v1/purchases/{id}/payments

Path parameters

idstring required

The purchase's ID — the id returned by the list and show purchase endpoints.

Request body

payment_method_idstring required

ID of the payment method this payment was made with (e.g. cash, check, ACH). Must reference an existing payment method in your company.

amountnumber required

Amount of the payment in the purchase's currency, rounded to 2 decimal places. Adds to the purchase's paid total; exceeding the purchase total leaves it OVER_PAID.

payment_datetimestring required

The datetime the payment was made, as a full ISO8601 datetime (e.g. 2026-08-18T00:00:00Z).

descriptionstring required

A free-text note describing the payment.

quickbooks_deposit_account_idstring

QuickBooks Online deposit account ID. Cannot include both this and quickbooks_deposit_account_name. If your company is integrated with QuickBooks Online, either this or quickbooks_deposit_account_name must be provided. Account type must be "Bank" or "Credit Card"

quickbooks_deposit_account_namestring

QuickBooks Online deposit account name. Cannot include both this and quickbooks_deposit_account_id. If your company is integrated with QuickBooks Online, either this or quickbooks_deposit_account_id must be provided. Account type must be "Bank" or "Credit Card"

Response

A single payment

Changes

No recorded changes to this endpoint across all 2 revisions of this API.