---
title: "Add a payment to reservation"
method: POST
path: "/reservations/{id}/payments"
tags: ["Reservations"]
---

# Add a payment to reservation

`POST /reservations/{id}/payments`

Use this request to create an immediate or future payment, and to add a record to payment history. 

An immediate or future payment is charged using a credit card, where a rerocded payment indicates the funds were collected in other methods such as bank transfer, cash, e-check etc

## Path parameters

- `id` string, required

## Request body

- object
  - `paymentMethod` object, required
    - `method` 'CASH' | 'CREDIT' | 'DEBIT' | 'ECHECK' | 'AIRBNB' | 'BANK_TRANSFER' | 'CREDIT_NOTE' | 'VOUCHER' | 'CHECK' | 'STRIPE' | 'AMARYLLIS' | 'OTHER'
    - `saveForFutureUse` boolean
    - `id` string — Required only for payments processed using credit cards (i.e not cash, echeck etc). Please see 'List guest's payment methods' request for more info.
  - `amount` number, required
  - `shouldBePaidAt` string, date — Expected charge date. Not passing this param at all or passing it with a past date, will immediately charge the payment.
  - `paidAt` string, date — Used when adding a record to payment history - the actual charge date.
  - `note` string — Free text
  - `isAuthorizationHold` boolean — True in case of Authorization hold kind of payments

## Response `201`

Retrieve the created payment for reservation

- 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

- `400` — Invalid Input
- `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)