---
title: "Cancel a payout"
method: POST
path: "/declineThirdParty"
tags: ["Reviewing"]
---

# Cancel a payout

`POST /declineThirdParty`

> This endpoint is **deprecated** and no longer supports new integrations. Do one of the following:
>- If you are building a new integration, use the [Transfers API](https://docs.adyen.com/api-explorer/transfers/latest/overview) instead.
> - If you are already using the Payout API, reach out to your Adyen contact to learn how to migrate to the Transfers API.
>
> With the Transfers API, you can:
> - Handle multiple payout use cases with a single API.
> - Use new payout functionalities, such as instant payouts to bank accounts.
> - Receive webhooks with more details and defined transfer states.
>
> For more information about the payout features of the Transfers API, see our [Payouts](https://docs.adyen.com/payouts/payout-service) documentation.


Cancels a previously submitted payout.

To confirm and send a payout, use the `/confirmThirdParty` endpoint.

## Request body

- ModifyRequest
  - `additionalData` object — This field contains additional data, which may be required for a particular payout request.
  - `merchantAccount` string, required — The merchant account identifier, with which you want to process the transaction.
  - `originalReference` string, required — The PSP reference received in the `/submitThirdParty` response.

## Response `200`

OK - the request has succeeded.

- ModifyResponse
  - `additionalData` object — This field contains additional data, which may be returned in a particular response.
  - `pspReference` string, required — Adyen's 16-character string reference associated with the transaction. This value is globally unique; quote it when communicating with us about this response.
  - `response` string, required — The response: * In case of success, it is either `payout-confirm-received` or `payout-decline-received`. * In case of an error, an informational message is returned.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `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

- **2023-04-19** (v30) `2545ac72463d` — 7 breaking
  - the request's body type/format changed from ``/`` to `object`/``
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - the response's body type/format changed from ``/`` to `object`/`` for status `400`
  - the response's body type/format changed from ``/`` to `object`/`` for status `401`
  - …3 more
- **2021-08-07** (v30) `3678fe50cd78` — 3 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BasicAuth` was added to the API
  - api tag `Reviewing` added
- **2021-04-24** (v30) `d3222f72d182` — 7 breaking, 3 info
  - the request's body type/format changed from `object`/`` to ``/``
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - the response's body type/format changed from `object`/`` to ``/`` for status `400`
  - the response's body type/format changed from `object`/`` to ``/`` for status `401`
  - …6 more

[Change history](https://skmtc.dev/adyen/apis/payoutservice/changes/declineThirdParty/post.md)

---

[API](https://skmtc.dev/adyen/apis/payoutservice.md) · [All operations](https://skmtc.dev/adyen/apis/payoutservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/payoutservice/revisions/a2c38f8801fa/schema)