--- title: "Create an order" method: POST path: "/orders/create" tags: ["Orders"] --- # Create an order `POST /orders/create` Use this endpoint to confirm the booking and proceed the payment. ## Headers - `X-Affiliate-Id` integer, required ## Request body - object - `accommodation` object — Additional information related to the accommodation order. - `label` string — A label for this order. This can be read back later while fetching this order details. - `products` object[] - `id` string, required — ID for this product. `Please note that this MUST match the product IDs used for related /orders/preview request.` - `bed_configuration` string — Bed configuration ID to select for this product. `Please note that it can not be guaranteed that the selected bed_configuration will be available.` - `guests` object[] — The guest details for this product. - `email` string, required — The email address of the guest. - `name` string, required — The name of the guest. - `remarks` object — Optional remarks from the guest. - `estimated_arrival_time` object — Estimated arrival time of the guests. - `hour` integer, required — Approximate hour of arrival to the hotel. Allowed values are from 0 to 23. This time should be within the hotel reception hours, or will be ignored otherwise with a warning will be appended to special_requests. - `next_day` boolean — Set this to true, if the hour selected is for the day after checkin. - `special_requests` string — Optional comments or requests from the guest. Special requests cannot be guaranteed – but the property will do its best to meet your needs. - `booker` object, required — The booker's information. - `address` object, required — The booker's address to be used for creating this order. All fields of this object are required if the /accommodations/details endpoint indicates that the booker's address is necessary by returning booker_address_required=true. - `address_line` string — The details of this address. - `city` string — The city for this address. - `country` string, required — The country for this address. - `post_code` string — Post code for this address. - `company` string — The booker's company name. - `email` string, required — The booker's email address. - `language` string — A [IETF language tag code](https://en.wikipedia.org/wiki/IETF_language_tag) that uniquely identifies a supported human language or dialect. **Note:** Demand API only accepts lowercase for the language codes. Examples: "nl" for Dutch/Nederlands or "en-us" for English (US). To retrieve the full list of supported languages, call the `/common/languages` endpoint in the same Demand API version you are using. - `name` object, required — The name of the booker. - `first_name` string, required - `last_name` string, required - `telephone` string, required — The booker's telephone number. - `order_token` string, required — A token containing the necessary data to be used for creating this order. - `payment` object, required — Payment related information for the order. - `airplus` object — All information related to airplus payment. `This is required if airplus is selected as payment method.` - `dbi` object — Descriptive billing information(dbi) details to pass to AirPlus. - `accounting_code` string — Accounting code to pass in descriptive billing information. - `accounting_unit` string — Accounting unit to pass in descriptive billing information. - `cost_centre` string — Cost centre to pass in descriptive billing information. - `department_code` string — Department code to pass in descriptive billing information. - `employee_number` string — Employee number to pass in descriptive billing information. - `internal_account` string — Internal account to pass in descriptive billing information. - `order_number` string — Order number to pass in descriptive billing information. - `project_number` string — Project number to pass in descriptive billing information. - `number` string, required — 12 digit Airplus Number. - `business_information` object — All business related information for billing and authorisation form. This must be included for the payments that require authorisation form. - `authorisation_form` object — Information that is relevant for generating an authorisation form. - `chargeable_items` string[] — Items which can be charged using a provided virtual credit card. - `billing` object — All information to be used in the invoice. - `address` object — The address to bill this reservation - `address_line` string — The details of this address. - `city` string — The city for this address. - `country` string — The country for this address. - `post_code` string — Post code for this address. - `email` string, required — Email to send the invoice to. - `vat` string, required — VAT number to be used in the invoice. - `company` string, required — Company that will issue an authorisation form for the virtual credit card and used in the invoice. - `card` object — Card information for executing the payment. - `authentication` object — Card authentication information for executing the payment. - `riskified` object — Riskified information for external fraud verification. - `ip_address` string, ipv4, required — The booker's IP address. - `session_id` string, required — Riskified provided session_id for external fraud verification. - `sca_exemption` 'moto' | 'virtual' — The type of SCA exemption to be applied to the payment. - `3d_secure` object — 3-factor authentication information for the card. - `authentication_value` string, required — Cardholder Authentication Verification Value. - `cavv` string — Deprecated. Do not use - `eci` string, required — The electronic commerce indicator. - `transaction` string, required — The unique ID assigned by the DS to identify a single transaction. - `cardholder` string, required — Name of the cardholder. - `cvc` string, required — 3 or 4 digits card validation code (CVC) of this card. - `expiry_date` string, required — Expiry date of the card. Format: YYYY-MM - `number` string, required — Number of the card. - `include_receipt` boolean — This is used to determine whether to include payment `receipt_url` in the response or not. - `method` 'airplus' | 'card' | 'wallet' — The payment method to be used for this order. - `timing` 'pay_at_the_property' | 'pay_online_later' | 'pay_online_now', required — Information about when to execute the payment. ## Response `200` Successful response. - object - `request_id` string — Uniquely identifies the request. Please provide this identifier when contacting support. - `data` object - `accommodation` object — All accommodation related information for this order. - `order` string — ID for this accommodation order. - `pincode` string — Pincode for this accommodation order. - `reservation` integer — Reservation ID for this accommodation order. - `third_party_inventory` object - `checkin_number` string — The number required at the time of check-in. It allows guests to confirm their order at the accommodation. - `confirmation_number` string — The confirmation number, when used in conjunction with the pincode, helps verify the customer's order and facilitates efficient support during inquiries or troubleshooting. - `payment` object — All payment related information for this order. - `authorisation_form_url` string, uri — Link to a virtual credit card''s authorisation form, valid for 7 minutes from issue. `This will only the added if the request has authorisation_form.` - `receipt_url` string, uri — Link to the payment receipt of the order. `This will only be added if include_receipt is true.` --- [API](https://skmtc.net/booking/apis/booking-com-demand-api.md) · [All operations](https://skmtc.net/booking/apis/booking-com-demand-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/booking-com-demand-api/revisions/e5f3dccae7ca/schema)