---
title: "Changes to Record a payment or pre-issue credit against an invoice. payment_method=manual_bank_transfer requires ISSUED (records received funds); issue_credit allowed on DRAFT or ISSUED (write-off / pre-issue discount, requires `notes`). Idempotent on (invoice_id, external_reference)."
method: POST
path: "/api/v1/admin/invoices/{invoiceId}/payments"
---

# Changes to Record a payment or pre-issue credit against an invoice. payment_method=manual_bank_transfer requires ISSUED (records received funds); issue_credit allowed on DRAFT or ISSUED (write-off / pre-issue discount, requires `notes`). Idempotent on (invoice_id, external_reference).

`POST /api/v1/admin/invoices/{invoiceId}/payments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 8 revisions.

- **2026-06-17** `b372e7d5563d`: 1 info
- **2025-11-02** `919eb7a392aa`: 1 breaking

## Changes

- **2026-06-17** `b372e7d5563d`: 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/banqzinc/apis/quidkey-api/docs/api/v1/admin/invoices/:invoiceId/payments/post.md) - [API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) - [Page](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/admin/invoices/:invoiceId/payments/post)