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

# Return unmatched credit transfer

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

## Request

- Base URL: `https://api.mollie.com`
- URL: `https://api.mollie.com/v2/unmatched-credit-transfers/{unmatchedCreditTransferId}/return`
- 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.

Returns an unmatched credit transfer, sending the funds back to the original sender.

## Headers

- `idempotency-key` string

## Response `201`

The unmatched credit transfer action object.

- UnmatchedCreditTransferActionResponse
  - `resource` string, required: The resource type of the object.
  - `id` string, required
  - `unmatchedCreditTransferId` string, required
  - `action` 'match' | 'return', required
  - `status` 'pending', required
  - `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` PaymentToken[]: 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.
- `429`: Rate Limit has been reached.

## Changes

> 102 revisions in range; 9 not diffed.

- **2026-05-19** `7cab62b21830`: 1 info
  - added the non-success response with the status `429`
- **2026-05-12** `ef4b5a97b56a`: 2 info
  - the endpoint scheme security `advancedAccessToken` was added to the API
  - the endpoint scheme security `organizationAccessToken` was removed from the API

[Operation history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/unmatched-credit-transfers/:unmatchedCreditTransferId/return/post.md)

---

[API](https://skmtc.dev/mollie/apis/mollie-api.md) - [All operations](https://skmtc.dev/mollie/apis/mollie-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/mollie-api/revisions/01847046d5d0?raw)