[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Record payment

> Record money received against an invoice, with date, type and bank reference. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/invoice-ninja/record_payment

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Record money received against an invoice, with date, type and bank reference.

Invoice Ninja API: https://cotlet.dev/docs/api/invoice-ninja.md

`POST https://cotlet.dev/api/v1/invoice-ninja/invoices/{invoice_number}/payments`

Access: write. Confirm: waits for the user's OK before it runs.

Records a payment for the invoice client and applies it to the invoice. Without an amount it covers the full balance. A smaller amount leaves the invoice in Partial status, and an amount above the balance leaves the extra on the payment as an unapplied balance. Payment date defaults to today; set it to the day the money arrived, because reports use it. Send email is on by default, as in Invoice Ninja, and sends the client a payment confirmation. By default you confirm each call; you can switch that off for this tool.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `company` | string | no | Company name, for accounts with several companies. Default: the company open when you signed in. |
| `invoice_number` | string | yes | Invoice number from list_invoices or create_invoice, e.g. INV-0038. |
| `amount` | number | no | Amount received. Default: the full invoice balance. |
| `payment_date` | date | no | Day the money arrived. Default: today. |
| `payment_type` | string | no | Payment type as listed in Invoice Ninja, e.g. Bank Transfer, Cash or Cheque. |
| `transaction_reference` | string | no | Bank reference or cheque number. |
| `private_notes` | string | no | Internal note, never shown to the client. |
| `send_email` | boolean | no | Send the client a payment confirmation. Default: true. |

## Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/invoice-ninja/invoices/INV-0034/payments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":1200,"payment_date":"2026-10-12","payment_type":"Bank Transfer","transaction_reference":"INV-0034 Oct"}'
```

**Python**

```python
result = client.call("invoice-ninja", "record_payment", {"invoice_number":"INV-0034","amount":1200,"payment_date":"2026-10-12","payment_type":"Bank Transfer","transaction_reference":"INV-0034 Oct"})
```

**Node.js**

```js
const result = await cotlet.call('invoice-ninja', 'record_payment', {"invoice_number":"INV-0034","amount":1200,"payment_date":"2026-10-12","payment_type":"Bank Transfer","transaction_reference":"INV-0034 Oct"});
```

**CLI**

```bash
cotlet call invoice-ninja record_payment --data '{"invoice_number":"INV-0034","amount":1200,"payment_date":"2026-10-12","payment_type":"Bank Transfer","transaction_reference":"INV-0034 Oct"}'
```

## Example response

```json
{
  "payment_number": "0021",
  "client": "Northwind Studio",
  "payment_date": "2026-10-12",
  "payment_type": "Bank Transfer",
  "transaction_reference": "INV-0034 Oct",
  "amount": 1200,
  "status": "Paid",
  "applied_to": [
    {
      "invoice_number": "INV-0034",
      "amount": 1200
    }
  ],
  "invoice_status": "paid",
  "invoice_balance": 0,
  "confirmation_email": true
}
```

Previous: [Convert quote to invoice](https://cotlet.dev/docs/api/invoice-ninja/convert_quote_to_invoice.md)
Next: [Cancel invoice](https://cotlet.dev/docs/api/invoice-ninja/cancel_invoice.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.

## For AI agents: sign your user up

Is your user asking you to sign them up for Cotlet? You can do it for them, no account or key needed.

1. Read the fields and their allowed values: GET https://cotlet.dev/api/v1/access-requests
2. Ask the user for each value: email, apps, what you will do with them. If they leave the password to you, generate a strong one and show it to them.
3. Show the user what you will send, then POST it as JSON to https://cotlet.dev/api/v1/access-requests.

One call creates the account and sends the access request; we email the user when access is granted.