---
updatedAt: 2026-04-21T15:27:31.000Z
agentTools:
  projectIndex: https://developers.cloudbeds.com/llms.txt
---

# Gift card management

**(\*) Mandatory requirements for gift card category Certification.**

# Initial configuration

* Use [getPaymentMethods](https://developers.cloudbeds.com/reference/get_getpaymentmethods-2) to identify configured payment methods for the property.\*\*\*\*\*
* If the gift card payment method is not configured, use [postCustomPaymentMethod](https://developers.cloudbeds.com/reference/post_postcustompaymentmethodpost_postreservationnote-2) to create gift cards as a custom method.\*\*\*\*\*

# Redeem a gift card

In this use case, the guest can present a gift card during their stay to cover their reservation outstanding balance partially or totally.
The property user would then redeem the card in an app or any other system, and the payment would be automatically posted in the reservation folio.

* Use [getReservations](https://developers.cloudbeds.com/reference/get_getreservationspost_postreservationnote-2) with parameters status or CheckInFrom/CheckInTo and CheckOutFrom/CheckOutTo to get reservations for your specific purpose. e.g. Today's arrivals, today's departures.\*\*\*\*\*
* Check the outstanding balance on the reservation with [getReservation](https://developers.cloudbeds.com/reference/get_getreservation-2) and make sure that there is some balance on the gift card.\*
* Use [postPayment](https://developers.cloudbeds.com/reference/post_postpaymentpost_postreservationnote-2) to record a payment made with a gift card in the reservation folio, making sure to include the custom payment method created in the type parameter.\*
* Recorded payments can be voided with /[postVoidPayment](https://developers.cloudbeds.com/reference/post_postvoidpaymentpost_postreservationnote-2).

<br />