Sign in

v1

latestOpenAPI 3.0.32026-07-23183961.3 KB

Confirm a pending reservation by providing guest details and payment information. This endpoint finalizes the booking process, transforming a temporary hold into a confirmed reservation.

Payment Methods:

  • CreditCard: Standard credit card payment.
  • VirtualCreditCard (VCC): Virtual card issued for the booking. VCC details include activation/deactivation dates, currency, and balance.

Credit Card Validation:

  • The card type provided must match one of the property's accepted card types
  • Invalid or expired cards will result in a 400 error

Important Notes:

  • Pending reservations expire after the time specified in expiresInMinutes from the pending reservation response
  • Attempting to confirm an expired reservation will result in a 404 error
  • Room availability is re-validated during confirmation to ensure inventory is still available
  • Guest information provided during confirmation cannot be empty for required fields
post/reservations/{bookingReferenceId}/confirmation

Path parameters

bookingReferenceIdstring required

The unique identifier of the pending reservation to be confirmed

Headers

x-sm-api-idstring required

The api id for channel

x-sm-api-keystring required

The api key for channel

Request body

paymentMethod'CreditCard' | 'VirtualCreditCard' required

The method of payment for the reservation

cardNumberinteger required

The full number of the credit card or virtual credit card

cardholderNamestring required

The name of the cardholder as it appears on the card

cardExpirystring required

The expiry date of the card in MM/YYYY format

cardType'AX' | 'DN' | 'DS' | 'JC' | 'MC' | 'CU' | 'VI' required

The type of credit card (AX=American Express, DN=Diners, DS=Discover, JC=JCB, MC=Mastercard, CU=China UnionPay, VI=Visa)

cardCvvstring required

The Card Verification Value (CVV) of the credit card

vccActivationDateTimestring date-time

VCC activation date/time. Expressed in ISO 8601 extended format. Date Format - YYYY-MM-DDThh:mm:ss<.sss>(+|-)hh:mm where <.sss> is optional and can be 1 to 3 digits.

vccDeactivationDateTimestring date-time

VCC deactivation date/time. Expressed in ISO 8601 extended format. Date Format - YYYY-MM-DDThh:mm:ss<.sss>(+|-)hh:mm where <.sss> is optional and can be 1 to 3 digits.

vccCurrencystring

The currency of the Virtual Credit Card (if applicable)

vccBalancenumber

The balance available on the Virtual Credit Card (if applicable)

guestTitlestring required

The title of the primary guest (e.g., Mr., Mrs., Ms., Dr.)

guestFirstNamestring required

The first name of the primary guest

guestLastNamestring required

The last name of the primary guest

guestEmailstring required

The email address of the primary guest

guestPhoneNumberstring required

The phone number of the primary guest

guestAddressstring nullable

The street address of the primary guest (optional)

guestCitystring nullable

The city of residence for the primary guest (optional)

guestStatestring nullable

The state or region of residence for the primary guest (optional)

guestPostcodestring nullable

The postal or zip code of the primary guest (optional)

guestCountrystring nullable

The country of residence for the primary guest (optional)

guestRemarksstring nullable

Any additional remarks or special requests from the primary guest (optional)

Response

Successful response. The reservation has been confirmed successfully.