---
title: "Changes to Return a transfer"
method: POST
path: "/transfers/{transferId}/returns"
---

# Changes to Return a transfer

`POST /transfers/{transferId}/returns`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 51 revisions.

- **2026-06-01** (v3) `2188d062ff1b` — 1 info
- **2024-10-30** (v3) `b53fe3b6fff6` — 1 info
- **2024-06-05** (v3) `69a555a91daf` — 4 info
- **2023-12-20** (v3) `ec02d539f754` — 1 info
- **2023-10-27** (v3) `073f244a0263` — 1 info

## 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

---

[Operation](https://skmtc.dev/adyen/apis/transferservice/docs/transfers/:transferId/returns/post.md) · [API](https://skmtc.dev/adyen/apis/transferservice.md) · [Page](https://skmtc.dev/adyen/apis/transferservice/changes/transfers/:transferId/returns/post)