Payment Methods

List payment methods

Changed on

Lists payment methods for a guest or a reservation. Provide exactly one of guestId or reservationId.

Replaces the deprecated List a guest's payment methods, and can also list by reservation.

get/payment-methods

Request

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

Query parameters

guestIdstring
Example:5f293ca69fa6bd01659b645e

Guesty guest id. Provide exactly one of guestId or reservationId.

reservationIdstring
Example:6213b03e7f0ba50032296f4a

Guesty reservation id. Provide exactly one of guestId or reservationId.

Response

The payment methods

Example response

{
  "data": [
    {
      "_id": "5f92cbf10cf217478ba93561",
      "accountId": "5f293ca69fa6bd01659b645e",
      "guestId": "5f293ca69fa6bd01659b645e",
      "paymentProviderId": "5fe4b21675087f01a3c5ab5b",
      "method": "STRIPE",
      "saveForFutureUse": true,
      "last4": "4242",
      "brand": "visa",
      "status": "ACTIVE",
      "type": "PHYSICAL",
      "confirmationCode": "GY-123456",
      "createdAt": "2026-10-01T12:00:00.000Z",
      "updatedAt": "2026-10-01T12:00:05.000Z"
    }
  ]
}

Changes