List document payments

GET

document-payments

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/document-payments \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": 801,
      "documentType": "invoice",
      "documentId": 301,
      "paymentMethod": {
        "id": 1,
        "name": "Bank transfer"
      },
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      },
      "paymentDate": "2026-03-07",
      "amount": 15.5,
      "currencyRate": 1,
      "receiptInvoice": {
        "id": 301,
        "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
        "type": "invoice",
        "number": "20260001",
        "clientId": 101,
        "client": {
          "name": "Acme s.r.o.",
          "type": "company",
          "subjectId": "12345678",
          "taxId": "2020123456",
          "vatId": "SK2020123456",
          "isVatPayer": true,
          "email": "billing@acme.test",
          "street": "Main Street 1",
          "city": "Bratislava",
          "zip": "81101",
          "countryId": 703,
          "country": {
            "id": 703,
            "name": "Slovakia",
            "code": "SK",
            "eu": true
          },
          "hasDeliveryAddress": true,
          "deliveryStreet": "Warehouse 9",
          "deliveryCity": "Kosice",
          "deliveryZip": "04001",
          "deliveryCountryId": 703,
          "deliveryCountry": {
            "id": 703,
            "name": "Slovakia",
            "code": "SK",
            "eu": true
          }
        },
        "issueDate": "2026-03-03",
        "dueDate": "2026-03-17",
        "deliveryDate": "2026-03-03",
        "currency": {
          "id": 1,
          "symbol": "EUR",
          "name": "Euro",
          "mark": "€"
        },
        "total": 200,
        "totalWithVat": 240,
        "toBePaid": 240,
        "status": "unpaid",
        "hasVat": true
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer token created for a specific company in Integrations → API.

Query Parameters

documentType

enum<string>

required

Document type whose payments you want to load. Only invoice, proforma, and credit-note are supported.

Available options:

invoice,

proforma,

credit-note

documentId

integer

required

ID of a document.

Response

Document payment list.

data

object[]

Payments of the selected document.

Show child attributes

Create document paymentCreates a new payment for a public document. ### Supported document types Only `invoice`, `proforma`, and `credit-note` are supported. ### Business behavior - The payment is always linked to one document via `documentType` + `documentId`. - The minimal create payload is only `documentType` + `documentId`; all other fields can be omitted and are derived server-side. - If `paymentDate` is omitted, today's date is used. - If `paymentMethodId` is omitted, the payment method from the source document is used. - If `currencyId` is omitted, the currency from the source document is used. - If `amount` is omitted, the current remaining `toBePaid` amount from the source document is used. This shortcut only works when the document still has a non-zero `toBePaid`; otherwise the endpoint returns `422`. - If `amount` is sent explicitly, it can have at most 2 decimal places. - If `amount` is sent explicitly, its magnitude must not exceed the current `toBePaid` and it must keep the same sign, so the payment cannot over-settle the document or move in the opposite direction. - If `currencyRate` is omitted, the system derives it from the final `paymentDate` using the previous day's rate. - If you send `currencyRate` for a currency other than `EUR`, that override value is used as-is. - If the final payment currency is `EUR`, the backend always stores and returns `currencyRate = 1.0`, even when you send a different value. - Creating a payment recalculates the document payment status exactly like the web and mobile flows. - If you later issue a payment receipt invoice for a proforma payment, the payment response may expose it in `receiptInvoice`. If you send an `Idempotency-Key`, the same key with the same payload returns the original response without creating the payment again.

List document payments

curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/document-payments \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": 801,
      "documentType": "invoice",
      "documentId": 301,
      "paymentMethod": {
        "id": 1,
        "name": "Bank transfer"
      },
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      },
      "paymentDate": "2026-03-07",
      "amount": 15.5,
      "currencyRate": 1,
      "receiptInvoice": {
        "id": 301,
        "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
        "type": "invoice",
        "number": "20260001",
        "clientId": 101,
        "client": {
          "name": "Acme s.r.o.",
          "type": "company",
          "subjectId": "12345678",
          "taxId": "2020123456",
          "vatId": "SK2020123456",
          "isVatPayer": true,
          "email": "billing@acme.test",
          "street": "Main Street 1",
          "city": "Bratislava",
          "zip": "81101",
          "countryId": 703,
          "country": {
            "id": 703,
            "name": "Slovakia",
            "code": "SK",
            "eu": true
          },
          "hasDeliveryAddress": true,
          "deliveryStreet": "Warehouse 9",
          "deliveryCity": "Kosice",
          "deliveryZip": "04001",
          "deliveryCountryId": 703,
          "deliveryCountry": {
            "id": 703,
            "name": "Slovakia",
            "code": "SK",
            "eu": true
          }
        },
        "issueDate": "2026-03-03",
        "dueDate": "2026-03-17",
        "deliveryDate": "2026-03-03",
        "currency": {
          "id": 1,
          "symbol": "EUR",
          "name": "Euro",
          "mark": "€"
        },
        "total": 200,
        "totalWithVat": 240,
        "toBePaid": 240,
        "status": "unpaid",
        "hasVat": true
      }
    }
  ]
}