payments

Create a payment-first hotel checkout intent

Runs payment.createHotelCheckoutIntent. Public by design — guests can complete a payment-first checkout without an account (critical decision #4). Guest calls must include a contact email on the lead guest.

post/v1/payments/hotel-checkout-intent

Request

  • Base URL: https://api.getmyhotels.com
  • URL: https://api.getmyhotels.com/v1/payments/hotel-checkout-intent
  • Auth: none declared

Request body

offerRefstring
supplierCodestring
supplierHotelIdstring
supplierRoomIdstring
hotelNamestring required
hotelStarRatingnumber
hotelCitystring
hotelCountrystring nullable
roomNamestring required
roomMaxOccupancynumber nullable
roomBedTypestring
addressstring
propertyobject

Rich supplier-mapped property snapshot; invalid values are dropped, never rejected.

checkInstring nullable required
checkOutstring nullable required
roomsinteger
adultsinteger
childreninteger
childrenAgesinteger[]
totalPricenumber required
currencystring required
baseRatenumber
taxesnumber nullable
feesnumber nullable
specialRequestsstring
arrivalTimestring
departureFlightNumberstring
promoCodestring
language'en' | 'es' | 'fr' | 'de' | 'zh' | 'hi' | 'pt' | 'it' | 'ja' | 'te' | 'gu' | 'ko' | 'bn' | 'ru'
addonIdsstring[]
cancellationSummarystring
refundableboolean
freeCancellationUntilstring nullable
allowNonRefundableboolean
termsAcceptedboolean
termsVersionstring
idempotencyKeystring
savedPaymentMethodPublicIdstring
autoRebookboolean
turnstileTokenstring
buyerCompanyNamestring
buyerTaxIdCountry'IN' | 'GB' | 'AT' | 'BE' | 'BG' | 'CY' | 'CZ' | 'DE' | 'DK' | 'EE' | 'ES' | 'FI' | 'FR' | 'GR' | 'HR' | 'HU' | 'IE' | 'IT' | 'LT' | 'LU' | 'LV' | 'MT' | 'NL' | 'PL' | 'PT' | 'RO' | 'SE' | 'SI' | 'SK'
buyerTaxIdstring

Response

Success

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.