Record Payment
Finance confirms receipt of payment against an invoice.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
Records a payment receipt against an invoice.
Endpoint: POST /api/v1/invoices/{invoice_id}/payments
Required role: finance:confirm_payment
Multiple payments can be recorded against the same invoice to support installment/partial payment workflows.
Amount received in this payment. Must be greater than zero.
x > 0Channel used: RTGS, EFT, MPESA, CHEQUE, INTERNAL_LEDGER, or OTHER.
RTGS, EFT, MPESA, CHEQUE, INTERNAL_LEDGER, OTHER Bank reference, M-PESA transaction ID, or cheque number for audit trail.
Date funds were received, e.g. '2026-05-31'.
ID of the payment receipt uploaded to document-service (bank advice, M-PESA confirmation, cheque scan, etc.). Upload to document-service first, then pass the ID here.
Optional internal notes for the finance team.
Response
Successful Response
