---
title: "Record a payment for a document"
method: POST
path: "/api/finances/documents/{document_id}/payment"
tags: ["Finances"]
---

# Record a payment for a document

`POST /api/finances/documents/{document_id}/payment`

## Request

- Base URL: `https://api.typless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.typless.com/api/finances/documents/{document_id}/payment`
- Auth: none declared

## Path parameters

- `document_id` string, uuid, required

## Request body

- RecordPaymentRequest
  - `payment_type` 'BANK_TRANSFER' | 'CASH' | 'OTHER', required
  - `amount` union
    - number
    - string
  - `currency` string, nullable
  - `notes` string, nullable

## Response `200`

Successful Response

- PaymentRecordDTO
  - `id` string, uuid, required
  - `document_id` string, uuid, required
  - `transaction_id` string, uuid, nullable, required
  - `payment_type` 'BANK_TRANSFER' | 'CASH' | 'OTHER', required
  - `amount` string, required
  - `currency` string, required
  - `document_amount` string, nullable
  - `matched_at` string, date-time, required
  - `matched_by` string, required
  - `match_method` 'AUTO_EXACT' | 'MANUAL' | 'SUGGESTED', required
  - `confirmed` boolean, required
  - `notes` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/typless/apis/typless-api.md) · [All operations](https://skmtc.dev/typless/apis/typless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typless/apis/typless-api/revisions/d614787a47ef?raw)