Record invoice payment
Apply a payment to an open invoice, optionally sending the customer a receipt.
MCP tool housecall_pro_write → record_invoice_payment
write Confirm
Applies a payment to one invoice, the same as Pay in the invoice preview: amount, payment method and an optional receipt email. A partial payment is allowed unless Progress Invoicing is on, and then the full amount is required. A card on file is used automatically and always notifies the customer. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| invoice_id string required | string | Invoice ID from list_invoices or get_job. |
| amount number required | number | Amount paid. |
| method string required | string | Payment method as listed in the Pay window, for example check or cash. |
| notify_customer boolean | boolean | Email a receipt. Default: false. A card on file always sends one. |
| receipt_email string | string | Address for the receipt. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "housecall_pro_write",
"arguments": {
"operation": "record_invoice_payment",
"arguments": {
"invoice_id": "invoice_8c41d2",
"amount": 1,
"method": "method"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoice_id": "inv_7c20be",
"payment_id": "pay_2c91",
"amount": 780,
"method": "check",
"status": "paid",
"receipt_sent": false
},
"isError": false
}