---
title: "cancel a payment"
method: DELETE
path: "/v3/payments/{id}"
tags: ["Merchant Endpoints"]
---

# cancel a payment

`DELETE /v3/payments/{id}`

Endpoint responsible for canceling a payment on the request of a merchant.
The caller has to be one of the participants of the payment.
A payment can be cancelled only if has the status in PENDING or IDENTIFIED.
When a payment is cancelled the status will be set to CANCELLED.

The token neccessary to call this endpoint as a **merchant** has to have:
- `subjectType` : `INTEGRATOR` or `MERCHANT`
- `authority`: `MERCHANT_PAYMENT`
- `resourceType` : `PAYMENTPROFILE`

## Path parameters

- `id` string, required

## Response `204`

Payment is successfully cancelled

## Other responses

- `401` — * `UNAUTHORIZED`: user doesn't have an access token
- `403` — * `ACCESS_DENIED`: access token is invalid * `CALLER_NOT_ALLOWED_TO_CANCEL`: if caller is not a participant of the payment
- `404` — * `PAYMENT_NOT_FOUND`: payment is not found in the system
- `422` — * `PAYMENT_NOT_PENDING`: payment is not in pending or identify state
- `429` — **Error Codes**
- `500` — * `TECHNICAL_ERROR`: Technical error in Payment service
- `503`

---

[API](https://skmtc.net/bancontactpro/apis/payment-v3-api.md) · [All operations](https://skmtc.net/bancontactpro/apis/payment-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bancontactpro/payment-v3-api/versions/4093d799b771/schema)