Payments

Endpointhttps://api.kontier.eu/v1

Individual payments and payment reconciliation findings.

List payment reconciliation findings

GET

https://api.kontier.eu/v1

/payments/reconciliation-findings

What the daily payment reconciliation could not match between the provider's settlements and the local ledger — a provider charge with no local payment, a local success the provider never settled, an amount that disagrees, a refund or dispute the webhook rail lost — and what it repaired unattended (a lost success webhook, replayed). Most recently seen first. Filter with status=open for what still needs a person.

Required scope: payment.read (Read payments).

List payment reconciliation findings › query Parameters

limit

integer · min: 1

Page size (default 25, max 100)

Example: 50

cursor

string

Opaque continuation token from the previous response's pagination.cursor. Omit for the first page. Cursors are stateless and do not expire, but are only valid for the list and filters that produced them.

status

array | null · explode: true

Keep the findings in any of these statuses (ReconciliationFindingStatus: open, repaired, resolved). Repeatable or comma-separated; omit for all.

kind

array | null · explode: true

Keep the findings of any of these kinds (ReconciliationFindingKind: unknown_charge, unsettled_charge, amount_mismatch, unknown_refund, unknown_dispute, repaired_settlement, unapplied_payment). Repeatable or comma-separated; omit for all.

List payment reconciliation findings › Headers

X-Workspace-Id

string

Selects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.

Workspace UUID or slug.

List payment reconciliation findings › Responses

array | null · required

object · required

GET/payments/reconciliation-findings

curl --request GET \
  --url https://api.kontier.eu/v1/payments/reconciliation-findings

shell

Example Responses

{
  "data": [
    {
      "amount": {
        "currency": "EUR",
        "value": "49.5"
      },
      "customer_id": "c4e24a5c-163a-5cf1-ac3e-d65f4b1528cc",
      "detail": "detail",
      "first_seen_at": "2024-08-25T15:00:00Z",
      "id": "394e9877-065f-527e-9c00-0435e6014c14",
      "invoice_id": "ad796aee-fbf8-5e97-b688-00f2ce03f034",
      "kind": "unknown_charge",
      "last_seen_at": "2024-08-25T15:00:00Z",
      "payment_id": "692f7f06-6b5e-52e8-93df-2eb28e0974cc",
      "provider": "stripe",
      "provider_txn_id": "provider_txn_id",
      "related_source_id": "related_source_id",
      "resolved_at": "2024-08-25T15:00:00Z",
      "status": "open"
    }
  ],
  "pagination": {
    "counts": {
      "key": {
        "key": 0
      }
    },
    "cursor": "cursor",
    "has_more": true,
    "total_count": 0
  }
}

json

application/json

Resolve a payment reconciliation finding

PATCH

https://api.kontier.eu/v1

/payments/reconciliation-findings/{id}

Sets a finding's status to resolved: it is dealt with. The next reconciliation pass will not reopen it, even if the provider still shows the discrepancy. Returns the finding.

Required scope: payment.write (Manage payment methods).

Resolve a payment reconciliation finding › path Parameters

id

string · uuid · required

Finding UUID

Resolve a payment reconciliation finding › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Resolve a payment reconciliation finding › Request Body

status

string · enum · required

resolved: the finding needs nothing more. The next reconciliation pass does not reopen it, even if the provider still shows the discrepancy.

Enum values:

resolved

note

string · maxLength: 2000

Why the finding needs nothing more — what was checked or put right. Recorded on the audit trail with the resolution.

Resolve a payment reconciliation finding › Responses

object · required

PATCH/payments/reconciliation-findings/{id}

curl --request PATCH \
  --url https://api.kontier.eu/v1/payments/reconciliation-findings/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": "note",
  "status": "resolved"
}
'

shell

Example Request Body

{
  "note": "note",
  "status": "resolved"
}

json

Example Responses

{
  "data": {
    "amount": {
      "currency": "EUR",
      "value": "49.5"
    },
    "customer_id": "c4e24a5c-163a-5cf1-ac3e-d65f4b1528cc",
    "detail": "detail",
    "first_seen_at": "2024-08-25T15:00:00Z",
    "id": "394e9877-065f-527e-9c00-0435e6014c14",
    "invoice_id": "ad796aee-fbf8-5e97-b688-00f2ce03f034",
    "kind": "unknown_charge",
    "last_seen_at": "2024-08-25T15:00:00Z",
    "payment_id": "692f7f06-6b5e-52e8-93df-2eb28e0974cc",
    "provider": "stripe",
    "provider_txn_id": "provider_txn_id",
    "related_source_id": "related_source_id",
    "resolved_at": "2024-08-25T15:00:00Z",
    "status": "open"
  }
}

json

application/json

deprecated

Resolve a payment reconciliation finding

POST

https://api.kontier.eu/v1

/payments/reconciliation-findings/{id}/resolve

Deprecated: use PATCH /payments/reconciliation-findings/{id} instead. Removed on 2026-11-30.

Marks a finding as dealt with. The next reconciliation pass will not reopen it, even if the provider still shows the discrepancy.

Required scope: payment.write (Manage payment methods).

Resolve a payment reconciliation finding › path Parameters

id

string · uuid · required

Finding UUID

Resolve a payment reconciliation finding › Headers

Idempotency-Key

string · required

Unique key that makes this POST safe to retry: repeats with the same key replay the first response instead of re-executing. Replays are scoped to the retrying principal (same API key / user) and kept for 24 hours. Required on every POST.

Client-generated idempotency key (e.g. a UUID).

X-Workspace-Id

string

Workspace UUID or slug.

Resolve a payment reconciliation finding › Request Body

note

string · maxLength: 2000

Why the finding needs nothing more — what was checked or put right. Recorded on the audit trail with the resolution.

Resolve a payment reconciliation finding › Responses

object · required

POST/payments/reconciliation-findings/{id}/resolve

curl --request POST \
  --url https://api.kontier.eu/v1/payments/reconciliation-findings/:id/resolve \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <string>' \
  --data '{
  "note": "note"
}'

shell

Example Request Body

{
  "note": "note"
}

json

Example Responses

{
  "data": {
    "amount": {
      "currency": "EUR",
      "value": "49.5"
    },
    "customer_id": "c4e24a5c-163a-5cf1-ac3e-d65f4b1528cc",
    "detail": "detail",
    "first_seen_at": "2024-08-25T15:00:00Z",
    "id": "394e9877-065f-527e-9c00-0435e6014c14",
    "invoice_id": "ad796aee-fbf8-5e97-b688-00f2ce03f034",
    "kind": "unknown_charge",
    "last_seen_at": "2024-08-25T15:00:00Z",
    "payment_id": "692f7f06-6b5e-52e8-93df-2eb28e0974cc",
    "provider": "stripe",
    "provider_txn_id": "provider_txn_id",
    "related_source_id": "related_source_id",
    "resolved_at": "2024-08-25T15:00:00Z",
    "status": "open"
  }
}

json

application/json

Get a payment

GET

https://api.kontier.eu/v1

/payments/{id}

Returns one payment: what it pays for, its amount, where it stands at the provider and why it failed, if it did. 404 when the payment does not exist or is not in the caller's organization.

Required scope: payment.read (Read payments).

Get a payment › path Parameters

id

string · uuid · required

Payment UUID

Get a payment › query Parameters

include

string[] · explode: true

Extra data to add to the response: provenance. Send a comma-separated list or repeat the parameter. An unknown name is refused with 400. provenance is sent without being asked until 2026-11-30; after that date it is sent only when named here.

Enum values:

provenance

Get a payment › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get a payment › Responses

object · required

GET/payments/{id}

curl --request GET \
  --url https://api.kontier.eu/v1/payments/:id

shell

Example Responses

{
  "data": {
    "amount": {
      "currency": "EUR",
      "value": "49.5"
    },
    "attempt_number": 0,
    "confirmed_at": "2024-08-25T15:00:00Z",
    "created_at": "2024-08-25T15:00:00Z",
    "currency": "EUR",
    "customer_id": "c4e24a5c-163a-5cf1-ac3e-d65f4b1528cc",
    "decline_code": "decline_code",
    "failed_at": "2024-08-25T15:00:00Z",
    "failure_code": "failure_code",
    "failure_message": "failure_message",
    "id": "692f7f06-6b5e-52e8-93df-2eb28e0974cc",
    "idempotency_key": "idempotency_key",
    "initiator": "customer",
    "metadata": {},
    "next_action": {},
    "organization_id": "24d3775d-4115-5ce8-8a24-75b73041d2ca",
    "parent_payment_id": "b02b9378-f25d-5c22-a9b0-1e03c095c399",
    "payment_method_id": "2ba2d930-de18-5690-96c7-2aaad42e0035",
    "provider": "stripe",
    "provider_payment_id": "provider_payment_id",
    "purpose": "invoice_payment",
    "purpose_ref_id": "b9dbd528-61d0-52f2-9b2c-4c77c3cdab02",
    "state": "pending",
    "status": "pending",
    "succeeded_at": "2024-08-25T15:00:00Z",
    "updated_at": "2024-08-25T15:00:00Z",
    "workspace_id": "4a82f969-6228-5ab1-8d01-b41ed73ee6ca"
  }
}

json

application/json

E-Invoicing Checkout Links

List payment reconciliation findings

GET

https://api.kontier.eu/v1

/payments/reconciliation-findings

Required scope: payment.read (Read payments).

List payment reconciliation findings › query Parameters

limit

integer · min: 1

Page size (default 25, max 100)

Example: 50

cursor

string

status

array | null · explode: true

Keep the findings in any of these statuses (ReconciliationFindingStatus: open, repaired, resolved). Repeatable or comma-separated; omit for all.

kind

array | null · explode: true

List payment reconciliation findings › Headers

X-Workspace-Id

string

Workspace UUID or slug.

List payment reconciliation findings › Responses

array | null · required

object · required

Resolve a payment reconciliation finding

PATCH

https://api.kontier.eu/v1

/payments/reconciliation-findings/{id}

Sets a finding's status to resolved: it is dealt with. The next reconciliation pass will not reopen it, even if the provider still shows the discrepancy. Returns the finding.

Required scope: payment.write (Manage payment methods).

Resolve a payment reconciliation finding › path Parameters

id

string · uuid · required

Finding UUID

Resolve a payment reconciliation finding › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Resolve a payment reconciliation finding › Request Body

status

string · enum · required

resolved: the finding needs nothing more. The next reconciliation pass does not reopen it, even if the provider still shows the discrepancy.

Enum values:

resolved

note

string · maxLength: 2000

Why the finding needs nothing more — what was checked or put right. Recorded on the audit trail with the resolution.

Resolve a payment reconciliation finding › Responses

object · required

Resolve a payment reconciliation finding

POST

https://api.kontier.eu/v1

/payments/reconciliation-findings/{id}/resolve

Deprecated: use PATCH /payments/reconciliation-findings/{id} instead. Removed on 2026-11-30.

Marks a finding as dealt with. The next reconciliation pass will not reopen it, even if the provider still shows the discrepancy.

Required scope: payment.write (Manage payment methods).

Resolve a payment reconciliation finding › path Parameters

id

string · uuid · required

Finding UUID

Resolve a payment reconciliation finding › Headers

Idempotency-Key

string · required

Client-generated idempotency key (e.g. a UUID).

X-Workspace-Id

string

Workspace UUID or slug.

Resolve a payment reconciliation finding › Request Body

note

string · maxLength: 2000

Why the finding needs nothing more — what was checked or put right. Recorded on the audit trail with the resolution.

Resolve a payment reconciliation finding › Responses

object · required

Get a payment

GET

https://api.kontier.eu/v1

/payments/{id}

Returns one payment: what it pays for, its amount, where it stands at the provider and why it failed, if it did. 404 when the payment does not exist or is not in the caller's organization.

Required scope: payment.read (Read payments).

Get a payment › path Parameters

id

string · uuid · required

Payment UUID

Get a payment › query Parameters

include

string[] · explode: true

Enum values:

provenance

Get a payment › Headers

X-Workspace-Id

string

Workspace UUID or slug.

Get a payment › Responses

object · required