Confirm Reservation

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.

POST/reservations/{bookingReferenceId}/confirmation

Path parameters

bookingReferenceId*string

The unique identifier of the pending reservation to be confirmed

Header parameters

Body

application/json

paymentMethod*enum

The method of payment for the reservation

CreditCardVirtualCreditCard

cardNumber*integer

The full number of the credit card or virtual credit card

cardholderName*string

The name of the cardholder as it appears on the card

cardExpiry*string

The expiry date of the card in MM/YYYY format

Pattern: ^\d{2}\/\d{4}$

cardType*enum

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

AXDNDSJCMCCUVI

cardCvv*string

The Card Verification Value (CVV) of the credit card

Pattern: ^\d{3,4}$

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.

Example: "2020-07-04T12:09:56.450-07:00"

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.

Example: "2020-07-04T12:09:56.450-07:00"

vccCurrencystring

The currency of the Virtual Credit Card (if applicable)

vccBalancenumber

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

guestTitle*string

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

guestFirstName*string

The first name of the primary guest

guestLastName*string

The last name of the primary guest

guestEmail*string

The email address of the primary guest

guestPhoneNumber*string

The phone number of the primary guest

guestAddressnullable string

The street address of the primary guest (optional)

guestCitynullable string

The city of residence for the primary guest (optional)

guestStatenullable string

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

guestPostcodenullable string

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

guestCountrynullable string

The country of residence for the primary guest (optional)

guestRemarksnullable string

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

rooms*array of object

An array of rooms in the reservation, each with its guest details

Response

200400401404500

Successful response. The reservation has been confirmed successfully.

Headers

Request

JavaScriptCurlPython

const response = await fetch('/reservations/{bookingReferenceId}/confirmation', {
    method: 'POST',
    headers: {
      "x-sm-api-id": "text",
      "x-sm-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "paymentMethod": "CreditCard",
      "cardholderName": "text",
      "cardExpiry": "text",
      "cardType": "AX",
      "cardCvv": "text",
      "guestTitle": "text",
      "guestFirstName": "text",
      "guestLastName": "text",
      "guestPhoneNumber": "text",
      "guestEmail": "text",
      "rooms": [
        {
          "roomUuid": "text",
          "guestTitle": "text",
          "guestFirstName": "text",
          "guestLastName": "text"
        }
      ]
    }),
});
const data = await response.json();

Response

400401404500

{
  "errors": [
    {
      "code": "text",
      "message": "text"
    }
  ]
}