---
title: "Return a transfer"
method: POST
path: "/transfers/{transferId}/returns"
tags: ["Transfers"]
---

# Return a transfer

`POST /transfers/{transferId}/returns`

Initiates the return of previously transferred funds without creating a new `transferId`.

## Path parameters

- `transferId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- ReturnTransferRequest
  - `amount` Amount, required
    - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
    - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `reference` string — Your internal reference for the return. If you don't provide this in the request, Adyen generates a unique reference. This reference is used in all communication with you about the instruction status. We recommend using a unique value per instruction. If you need to provide multiple references for a transaction, separate them with hyphens ("-").

## Response `200`

OK - the request has succeeded.

- ReturnTransferResponse
  - `id` string — The unique identifier of the return.
  - `reference` string — Your internal reference for the return.
  - `status` 'Authorised' | 'Declined' — The resulting status of the return. Possible values: **Authorised**, **Declined**.
  - `transferId` string — The unique identifier of the original transfer.

## Other responses

- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

- **2026-06-01** (v3) `2188d062ff1b` — 1 info
  - the `amount/currency` request property's minLength was decreased from `3` to `0`
- **2024-10-30** (v3) `b53fe3b6fff6` — 1 info
  - added the new optional `header` request parameter `Idempotency-Key`
- **2024-06-05** (v3) `69a555a91daf` — 4 info
  - added the optional property `routingDetails` to the response with the `401` status
  - added the optional property `routingDetails` to the response with the `403` status
  - added the optional property `routingDetails` to the response with the `422` status
  - added the optional property `routingDetails` to the response with the `500` status
- **2023-12-20** (v3) `ec02d539f754` — 1 info
  - the endpoint scheme security `clientKey` was added to the API
- **2023-10-27** (v3) `073f244a0263` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adyen/apis/transferservice/changes/transfers/:transferId/returns/post.md)

---

[API](https://skmtc.dev/adyen/apis/transferservice.md) · [All operations](https://skmtc.dev/adyen/apis/transferservice/llms.txt) · [OpenAPI document](https://skmtc.dev/adyen/apis/transferservice/revisions/59603902985d?raw)