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

# Match unmatched credit transfer

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

## Request

- Base URL: `https://api.mollie.com/v2`
- URL: `https://api.mollie.com/v2/unmatched-credit-transfers/{unmatchedCreditTransferId}/match`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://my.mollie.com/oauth2/authorize`
    - Token URL: `https://api.mollie.com/oauth2/tokens` scopes: `unmatched-credit-transfers.write`

> 🚧 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.

> 🔑 Access with
>
> [API key](/reference/authentication)
>
> [Advanced access token with **unmatched-credit-transfers.write**](/reference/authentication)
>
> [OAuth access with **unmatched-credit-transfers.write**](/reference/authentication)

## Request body

- object
  - `paymentIds` string[], required: The IDs of the payments to match against the unmatched credit transfer.

## Response `201`

The unmatched credit transfer action object.

- object
  - `resource` string, required: The resource type of the object.
  - `id` string, required: The identifier uniquely referring to this unmatched credit transfer action.
  - `unmatchedCreditTransferId` string, required: The identifier of the unmatched credit transfer this action belongs to.
  - `action` 'match' | 'return', required: The action performed on the unmatched credit transfer.
  - `status` 'pending', required: The current status of the action.
  - `createdAt` string, required: The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `details` object: Additional details about the action.
    - `paymentIds` string[]: The IDs of the payments matched to the unmatched credit transfer.
  - `_links` object, required: Links to related resources.
    - `self` object: The URL to this action.
      - `href` string
      - `type` string
    - `documentation` object: The URL to the documentation of this endpoint.
      - `href` string
      - `type` string

## 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.dev/mollie/apis/accepting-payments.md) - [All operations](https://skmtc.dev/mollie/apis/accepting-payments/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/accepting-payments/revisions/64fc448adebb?raw)