Payments

List payments

GET /payments · requires payment_entry (view)

string

default:"due"

due | overdue | reconcile | invoice | all

integer

default:"1"

integer

default:"20"

Max 200.

string

boolean

Payment stats

GET /payments/stats · requires payment_entry (view) Summary counts for the current tenant (and subjectScope, if restricted) — this is what backs the Dashboard receivables numbers.

Record a receipt

PATCH /payments/:paymentId/receipt · requires payment_entry (edit)

number

Minimum 0.

string

ISO date.

string

File reference.

string

pending | matched | exception

string

curl -X PATCH https://api.alforse.com/api/v1/payments/pay_123/receipt \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"receivedAmount": 250000, "receivedDate": "2026-08-05", "method": "bank_transfer"}'

Record invoice evidence

PATCH /payments/:paymentId/invoice · requires invoice (edit)

number

Minimum 0.

string

ISO date.

string

File reference.

All fields on both endpoints are optional — send only what changed. See Payments & Invoices for how this fits into the contract lifecycle, and Files for how proof / invoiceAttachment file references are produced.

Get Started

Tenant API

List payments

Payment stats

Record a receipt

Record invoice evidence

​List payments

​Payment stats

​Record a receipt

​Record invoice evidence

List payments

Payment stats

Record a receipt

Record invoice evidence