---
title: "Match unmatched credit transfer"
method: POST
path: "/v2/unmatched-credit-transfers/{unmatchedCreditTransferId}/match"
tags: ["Unmatched Credit Transfers API"]
---

# Match unmatched credit transfer

`POST /v2/unmatched-credit-transfers/{unmatchedCreditTransferId}/match`

> 🚧 Beta feature
>
> This feature is currently in private beta, and the final specification may still change.

Matches an unmatched credit transfer to one or more payments, settling the funds accordingly.

## Headers

- `idempotency-key` string

## Request body

- UnmatchedCreditTransferMatchRequest
  - `paymentIds` PaymentToken[], required — The IDs of the payments to match against the unmatched credit transfer.

## Response `201`

The unmatched credit transfer action object.

## Other responses

- `404` — No entity with this ID exists.
- `422` — The request contains issues. For example, if the amount of the unmatched credit transfer does not match the amount of the payment(s).
- `429` — Rate Limit has been reached.

---

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