Payments

GET /v1/invoices/{invoiceId}/payments

List invoice payments

Scope: payments:read

curl

curl https://app.rieck.nu/api/v1/invoices/9b2f1c1e-…/payments \
  -H "Authorization: Bearer $RIECK_API_KEY"

TypeScript

const svar = await rieck.request("GET", "/v1/invoices/9b2f1c1e-…/payments");

---

POST /v1/invoices/{invoiceId}/payments

Register manual payment

Your Idempotency-Key IS the bookkeeping key — the same key never registers twice.

Scope: payments:write

curl

curl -X POST https://app.rieck.nu/api/v1/invoices/9b2f1c1e-…/payments \
  -H "Authorization: Bearer $RIECK_API_KEY" \
  -H "Idempotency-Key: order-2041" \
  -d '{
    "amountOere": 125000,
    "paymentDate": "2026-08-15"
  }'

TypeScript

const svar = await rieck.request("POST", "/v1/invoices/9b2f1c1e-…/payments", {
  body: {
    "amountOere": 125000,
    "paymentDate": "2026-08-15"
  },
});

Request body — fuldt JSON Schema

{
  "type": "object",
  "properties": {
    "amountOere": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100000000000
    },
    "paymentDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "amountOere",
    "paymentDate"
  ],
  "additionalProperties": false
}

---

GET /v1/invoices/{invoiceId}/payment-link

Get payment link

Scope: payments:read

curl

curl https://app.rieck.nu/api/v1/invoices/9b2f1c1e-…/payment-link \
  -H "Authorization: Bearer $RIECK_API_KEY"

TypeScript

const svar = await rieck.request("GET", "/v1/invoices/9b2f1c1e-…/payment-link");

---

POST /v1/invoices/{invoiceId}/payment-link

Mint payment link (idempotent)

Scope: payments:write

curl

curl -X POST https://app.rieck.nu/api/v1/invoices/9b2f1c1e-…/payment-link \
  -H "Authorization: Bearer $RIECK_API_KEY" \
  -H "Idempotency-Key: order-2041"

TypeScript

const svar = await rieck.request("POST", "/v1/invoices/9b2f1c1e-…/payment-link");

---

GET /v1/payments

List payments (org-wide)

Scope: payments:read

Query
limit	Page size, 1-200 (default 50)
cursor	Opaque cursor from meta.nextCursor

curl

curl https://app.rieck.nu/api/v1/payments \
  -H "Authorization: Bearer $RIECK_API_KEY"

TypeScript

const svar = await rieck.request("GET", "/v1/payments");

---

GET /v1/payments/{paymentId}/receipt

Receipt PDF

Scope: payments:read

curl

curl https://app.rieck.nu/api/v1/payments/9b2f1c1e-…/receipt \
  -H "Authorization: Bearer $RIECK_API_KEY"

TypeScript

const svar = await rieck.request("GET", "/v1/payments/9b2f1c1e-…/receipt");