Record MYOB customer payments automatically

1. Open Sales > Record invoice payment and choose the customer from the Customer list; their unpaid invoices appear under it.
2. Set Bank account to the account or credit card that received the money, and check the Date and the Reference number, because changing the reference also changes the automatic numbering of later payments.
3. Select the invoices being paid. The Amount received calculates by itself, and an early-payment discount goes into the Discount ($) field of the invoice.
4. Click Save. If the customer paid more than the invoices add up to, enter the full amount and MYOB creates a customer credit for the excess, which you can refund or apply to another open invoice.
5. A payment that is already reconciled or matched cannot be changed, so an invoice settled against the wrong customer has to be unmatched in Banking before it is fixed.

Here are yesterday's incoming payments. Find the matching open invoice in MYOB by invoice number or by customer and exact amount, record the payment into the bank account I name, and list anything that does not match.

1. 01

   Pick the bank account

   list_bank_accounts returns the accounts MYOB offers in the Bank account field. The agent uses the one you named and stops if it matches none, rather than recording money into a different account.

2. 02

   Collect open invoices

   list_invoices runs with status open, and with the customer when your list names one, so payments are only compared with invoices that still have a balance.

3. 03

   Match by number, then by amount

   A payment is matched on invoice number first. Without one, the agent matches on customer plus exact balance, and only when exactly one open invoice fits.

4. 04

   Read the balance before paying

   get_invoice shows the balance due. A short payment is recorded as a partial payment and the invoice stays open. An amount above the balance is not recorded, because MYOB would create a customer credit that you may not want.

5. 05

   Record and report

   record_invoice_payment saves the payment with the date you gave, not today's date, so the books follow the bank statement. Each call asks for your OK by default, and unmatched payments are listed with the reason.

Payments in the list: 9
Recorded 7, e.g. invoice 00000142 Harbour Cafe Pty Ltd: AUD 1,100.00, now closed
Partial: 1 (invoice 00000139, AUD 500.00 of AUD 1,320.00, AUD 820.00 left)
Left for you 1: AUD 640.00 from "Coast Hardware" fits two open invoices

curl -X POST https://cotlet.dev/api/v1/myob/customers/CUS000012/invoice-payments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bank_account":"1-1110","date":"2026-10-13","reference":"00000087","payments":[{"invoice_number":"00000142","amount":1100}]}'

{
  "payment_reference": "00000087",
  "customer_id": "CUS000012",
  "bank_account": "1-1110",
  "date": "2026-10-13",
  "amount_received": 1100,
  "applied": [
    {
      "invoice_number": "00000142",
      "amount": 1100,
      "balance_due": 0,
      "status": "closed"
    }
  ]
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is myob_write → record_invoice_payment. Example data.

• Create and email MYOB invoices from a list
• Enter and pay MYOB supplier bills from a list
• MYOB API and MCP server: every tool
• All use cases