---
title: "Create reconciliation"
method: POST
path: "/reconciliations"
tags: ["Reconciliations"]
---

# Create reconciliation

`POST /reconciliations`

Create a reconciliation by matching a transaction with a payment.

## Headers

- `Idempotency-Key` string

## Request body

- object — At least one of `transaction_id` or `payment_id` must be provided. Providing both reconciles the transaction with the payment. Providing only one (on an `unreconciled` object) excludes that object from reconciliation (`reconciliation_status` = `excluded`).
  - `transaction_id` string — The ID of the transaction to be reconciled. If empty and the payment is unreconciled (`reconciliation_status` = `unreconciled`), will exclude the payment from reconciliation (`reconciliation_status` = `excluded`).
  - `payment_id` string — The ID of the `payment_order`, `incoming_payment`, `return`, `expected_payment` or `payment_capture` to be reconciled. If empty and the transaction is unreconciled (`reconciliation_status` = `unreconciled`), will exclude the transaction from reconciliation (`reconciliation_status` = `excluded`).
  - `amount` integer — The amount of the reconciliation, in the related payment and transaction currency’s smallest unit. For euro, the smallest unit is cents. €20 is represented as `2000`. If unspecified, the system will try to create a reconciliation with the maximum amount possible. It must be left empty if `payment_id` is empty.
  - `metadata` object — Additional client data in JSON format. See [Metadata](https://docs.numeral.io/reference/metadata).

## Response `200`

200

- object
  - `id` string
  - `amount` integer
  - `match_type` string
  - `object` string
  - `metadata` object — Additional client data in JSON format. See [Metadata](https://docs.numeral.io/reference/metadata).
  - `transaction_id` string
  - `payment_id` string
  - `payment_type` string
  - `canceled_at` unknown
  - `created_at` string

## Other responses

- `400` — 400
- `415` — Unsupported Media Type.

---

[API](https://skmtc.net/numeral/apis/payments.md) · [All operations](https://skmtc.net/numeral/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral/payments/revisions/220f101cc2ef/schema)