---
title: "Cancel an authorised payment"
method: POST
path: "/cancels"
tags: ["Modifications"]
---

# Cancel an authorised payment

`POST /cancels`

Cancels the authorisation on a payment that has not yet been [captured](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments/{paymentPspReference}/captures), and returns a unique reference for this request. You get the outcome of the request asynchronously, in a [**TECHNICAL_CANCEL** webhook](https://docs.adyen.com/online-payments/cancel#cancellation-webhook).

If you want to cancel a payment using the [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference), use the [`/payments/{paymentPspReference}/cancels`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments/{paymentPspReference}/cancels) endpoint instead.

If you want to cancel a payment but are not sure whether it has been captured, use the [`/payments/{paymentPspReference}/reversals`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments/{paymentPspReference}/reversals) endpoint instead.

For more information, refer to [Cancel](https://docs.adyen.com/online-payments/cancel).

## Headers

- `Idempotency-Key` string

## Request body

- StandalonePaymentCancelRequest
  - `applicationInfo` ApplicationInfo
    - `adyenLibrary` CommonField
      - `name` string — Name of the field. For example, Name of External Platform.
      - `version` string — Version of the field. For example, Version of External Platform.
    - `adyenPaymentSource` CommonField
      - `name` string — Name of the field. For example, Name of External Platform.
      - `version` string — Version of the field. For example, Version of External Platform.
    - `externalPlatform` ExternalPlatform
      - `integrator` string — External platform integrator.
      - `name` string — Name of the field. For example, Name of External Platform.
      - `version` string — Version of the field. For example, Version of External Platform.
    - `merchantApplication` CommonField
      - `name` string — Name of the field. For example, Name of External Platform.
      - `version` string — Version of the field. For example, Version of External Platform.
    - `merchantDevice` MerchantDevice
      - `os` string — Operating system running on the merchant device.
      - `osVersion` string — Version of the operating system on the merchant device.
      - `reference` string — Merchant device reference.
    - `shopperInteractionDevice` ShopperInteractionDevice
      - `locale` string — Locale on the shopper interaction device.
      - `os` string — Operating system running on the shopper interaction device.
      - `osVersion` string — Version of the operating system on the shopper interaction device.
  - `merchantAccount` string, required — The merchant account that is used to process the payment.
  - `paymentReference` string, required — The [`reference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_reference) of the payment that you want to cancel.
  - `reference` string — Your reference for the cancel request. Maximum length: 80 characters.

## Response `201`

Created - the request has been fulfilled and has resulted in one or more new resources being created.

- StandalonePaymentCancelResponse
  - `merchantAccount` string, required — The merchant account that is used to process the payment.
  - `paymentReference` string, required — The [`reference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_reference) of the payment to cancel.
  - `pspReference` string, required — Adyen's 16-character reference associated with the cancel request.
  - `reference` string — Your reference for the cancel request.
  - `status` 'received', required — The status of your request. This will always have the value **received**.

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

---

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