---
title: "Refund an existing payment"
method: POST
path: "/reservations/{id}/payments/{paymentId}/refund"
tags: ["Reservations"]
---

# Refund an existing payment

`POST /reservations/{id}/payments/{paymentId}/refund`

Use this endpoint to refund a guest's payment charged on an existing reservation.

## Path parameters

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

## Request body

- object
  - `amount` number, required
  - `note` string

## Response `201`

Retrieve the updated reservation payments

- object
  - `paymentProviderId` string
  - `paymentProvider` object
    - `id` string
    - `status` string
    - `syncedAt` string, date
    - `lastPendingPaymentDate` string, date
    - `pendingPaymentsCount` number
    - `paymentMethodsCount` number
    - `providerAccountId` string
    - `isDefault` boolean
    - `providerType` string
    - `connectedBy` string
    - `accountName` string
    - `defaultCurrency` string
    - `statsLastUpdated` string, date

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