Guests

Add a payment method for a guest

Changed on

Attach a payment method to a guest. Card details are never sent to this endpoint — tokenize the card first, then pass the resulting token: stripeCardToken when the payment provider is Stripe, or the _id returned by Guesty's tokenization process for Guesty Pay.

post/guests/{id}/payment-methods

Request

  • Base URL
    https://open-api.guesty.com/v1
  • URL
    https://open-api.guesty.com/v1/guests/{id}/payment-methods
  • Auth
    API key in header authorization

Path parameters

idstring required

Guest ID

Request body

OR

Example request

{
  "stripeCardToken": "pm_...",
  "paymentProviderId": "5fe4b21675087f01a3c5ab5b",
  "reservationId": "563e0b6a08a2710e00057b82"
}

Response

Payment method created

_idstring
accountIdstring
guestIdstring
paymentProviderIdstring
methodstring
payloadobject

Provider-specific payload

saveForFutureUseboolean
reuseboolean
createdAtstring date-time
last4string
brandstring
statusstring
typestring
confirmationCodestring
updatedAtstring date-time
__vinteger

Changes