---
title: "Cancels a pending or recorded payment"
method: PATCH
path: "/reservations/{id}/payments/{paymentId}/cancel"
tags: ["Reservations"]
---

# Cancels a pending or recorded payment

`PATCH /reservations/{id}/payments/{paymentId}/cancel`

Use this endpoint to cancel a pending or recorded payment

## Path parameters

- `id` string, required
- `paymentId` string, required

## Response `201`

Retrieve the updated reservation payments

- object
  - `status` string — Payment status
  - `paymentMethod` object — Payment method object **"Recorded" cash payment method example**
    - `method` 'RECORDED_CASH' | 'STRIPE' | 'AMARYLLIS' | 'CREDIT' | 'DEBIT' | 'ECHECK' | 'AIRBNB' | 'BANK_TRANSFER' | 'CREDIT_NOTE' | 'VOUCHER' | 'CHECK' | 'OTHER', required
    - `id` string
  - `amount` number
  - `cancelledAt` string, date — Date of cancellation
  - `note` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Unhandled exception. Something went wrong on server.

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)