Confirm Reservation

Used to confirm a locked reservation that is still within the locked period.

Request

To successfully call this endpoint, you must provide the following data points:

• Payment Method: Whether the payment card is a credit card or a virtual credit card

• Card Type: The card scheme that the booking guests card belongs to (e.g. Mastercard, Visa, American Express)

• Card Number: The booking guest’s card number

• Cardholder Name: The Name on the booking guest’s card

• Card Expiry: The card’s expiry date

• Card CVV: The 3 or 4 digit verification code typically on the back of the card

• If Payment method is Virtual Credit Card, the following fields are required:

  • VCC Activation Date Time: Must be on or before the end of the free cancellation period

  • VCC Deactivation Date Time: Must be at least 1 week after the check-out date

  • VCC Balance: Must be the same as the total reservation amount

  • VCC Currency: Must be the same as the reservation currency for the hotel

• Primary booking guest’s details:

  • Title

  • First and Last Name

  • Email address

  • Phone number

  • Address with city, state, postal code and country

  • Any remarks provided by the guest for the booking

• An array of unique identifiers for each room in the locked reservation

  • For each room in the array you may specify:

    • The room guest’s title

    • The room guest’s first and last name

    • Individual room level remarks

Response

On successful confirmation, you will receive a 200 response from the API.

Confirm reservation with guest details

POST/reservations/{bookingReferenceId}/confirmation

Path parameters

bookingReferenceId*string

The id of the reservation

Header parameters

Body

application/json

paymentMethod*enum

CreditCardVirtualCreditCard

cardNumber*integer

cardholderName*string

cardExpiry*string

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

cardType*enum

AXDNDSJCMCCUVI

cardCvv*string

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

vccBalancenumber

guestTitle*string

guestFirstName*string

guestLastName*string

guestEmail*string

guestPhoneNumber*string

guestAddressnullable string

guestCitynullable string

guestStatenullable string

guestPostcodenullable string

guestCountrynullable string

guestRemarksnullable string

rooms*array of object

Response

200400401404500

successful

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"
    }
  ]
}