Overview
The Bill Payments API manages payments to vendors for outstanding bills. Bill payments can pay a single bill or multiple bills and support various payment methods including checks, ACH, and wire transfers.Bill Payment Properties
| Property | Type | Description |
|---|---|---|
bill_payment_id | string | Unique identifier |
vendor_id | string | Vendor being paid |
account_id | string | Cash/bank account for payment |
ap_account_id | string | Accounts Payable account |
tran_date | string | Payment date |
posting_period_id | string | Accounting period |
total | number | Total payment amount |
currency | string | Payment currency |
exchange_rate | number | Exchange rate |
memo | string | Payment memo |
status | string | Payment status |
Payment Statuses
| Status | Description |
|---|---|
Draft | Initial state |
Pending Approval | Submitted for approval |
On Hold | Temporarily held |
Approved | Approved for processing |
Rejected | Rejected |
Voided | Payment voided |
Pending | Awaiting bank processing |
Cleared | Cleared by bank |
Endpoints
Create Payment
Create a new bill payment
Get Payment
Retrieve payment details
List Payments
List bill payments
Workflow
Submit, approve, reject, hold
Clear Payment
Mark as cleared (bank reconciliation)
Void Payment
Void a payment
Accounting Impact
When a bill payment is posted:- Debit: Accounts Payable (reduces liability)
- Credit: Cash/Bank Account (reduces asset)