Booking Submit
post a booking request
Header
Content-Type: application/x-www-form-urlencodedPOST
/booking_submit
Request
{
"checkin_date":"2018-11-01",
"checkout_date":"2018-11-02",
"hotel_id":"899",
"reference_id":"12345678",
"partner_data":{
"hotelID":"899",
"roomType":"3022",
"ratetype":"1822",
"rateDetail":"6093",
"price":"183",
"discount":"4812",
"discount2":"0"
},
"payment":{
"parameters":{
"card_type":"MasterCard",
"card_number":"54307xxxxxxxx9993",
"cardholder_name":"Stelios Kalogeropoulos",
"expiration_month":"09",
"expiration_year":"2025",
"cvv":"507"
},
"billing_address":{
"address1":"124 Alimou",
"city":"Athens",
"state":"Attiki",
"postal_code":"18345",
"country":"GR"
}
},
"customer":{
"first_name":"stelios",
"last_name":"kalogeropoulos",
"phone_number":"6947275998",
"email":"[email protected]",
"country":"GR"
},
"rooms":[
{
"party":{
"adults":2,
"children":[
4
]
},
"traveler_first_name":"stelios",
"traveler_last_name":"kalogeropoulos"
}
],
"final_price_at_booking":{
"amount":183,
"currency":"EUR"
}
}Parameter
| Field | Type | Description | Mandatory |
|---|---|---|---|
| checkin_date | string | The user's check-in date in YYYY-MM-DD | true |
| checkout_date | String | The user's check-out date in YYYY-MM-DD | true |
| hotel_id | string | the hotel_id | true |
| reference_id | String | partner identifier for the booking | true |
| customer | Customer | The user booking the reservation | true |
| rooms | RoomStay array | An array of rooms to be booked.. | true |
| payment | Payment object | Defines the payment method of the user | true |
| final_price_at_booking | Price | Contains the full price to be paid at time of booking, including taxes and fees. | true |
| partner_data | object | Echoed partner_data from the booking availability request | true |
Customer
| Field | Type | Description | Mandatory |
|---|---|---|---|
| party | Party | Contains the number of adults and children staying in this room | true |
| traveler_first_name | String | First name of the primary user staying in this room. | true |
| traveler_last_name | string | Last name of the primary user staying in this room | true |
RoomStay
| Field | Type | Description | Mandatory |
|---|---|---|---|
| first_name | string | First name of the user submitting the booking | true |
| last_name | String | Last name of the user submitting the booking. | true |
| phone_number | string | Phone number of the user submitting the booking | true |
| String | E-mail address of the user submitting the booking | true | |
| country | Customer | ISO 3166 country code of the user submitting the booking | true |
Payment
You can send "-" for all Fields if cc details are not available Fields are still mandatory part of the request
| Field | Type | Description | Mandatory |
|---|---|---|---|
| card_type | string | Diners Club MasterCard Discover AURA ELO American Express VISA JBC | true |
| card_number | String | Credit card number used for the booking. | true |
| cardholder_name | string | Name on the credit card holder. | true |
| expiration_month | String | Expiration month as a two-digit string (e.g. 01, 02, .. 12) | true |
| expiration_year | string | Expiration year as four digit string. | true |
| cvv | string | The cvv number of the credit card used for the booking. | true |
Response
{
"reference_id": "12345678",
"status": "success",
"reservation": {
"reservation_id": "RES1221151018R899",
"hotel_id": "899",
"status": "Booked",
"confirmation_url": "https://demov3.book-onlinenow.net/index.aspx?Page=18&member=res899h511&pass=812486",
"checkin_date": "2018-11-01",
"checkout_date": "2018-11-02",
"customer": {
"first_name": "stelios",
"last_name": "kalogeropoulos",
"phone_number": "3-(292)055-6386",
"email": "[email protected]",
"country": "GR"
},
"rooms": [
{
"party": {
"adults": 2,
"children": [
4
]
},
"traveler_first_name": "stelios",
"traveler_last_name": "kalogeropoulos"
}
],
"receipt": {
"line_items": [
{
"price": {
"amount": 166,
"currency": "EUR"
},
"type": "net_rate",
"paid_at_checkout": false,
"description": "Total amount at check-in"
},
{
"price": {
"amount": 16.6,
"currency": "EUR"
},
"type": "vat",
"paid_at_checkout": false,
"description": "Total tax at check-in"
}
],
"final_price_at_booking": {
"amount": 182.6,
"currency": "EUR"
},
}
}
}Parameters
| Field | Type | Description | Mandatory |
|---|---|---|---|
| problems | Problem array | An array containing issues that occurred | true, only if 'status' is "Failure" |
| reference_id | String | Echo the reference_id | true |
| status | string | Success Failure | true |
| reservation | Reservation | Contains details associated with the reservation ( e.g. receipt, date of stay, guests, etc.). | true, only if 'status' is "Success" |
Problem
| Field | Type | Description | Mandatory |
|---|---|---|---|
| problem | string | supported problem type | true |
| explanation | String | details of the problem that could be displayed to an end user | true |
| detail | string | techical details of the problem | true |
Receipt
| Field | Type | Description | Mandatory |
|---|---|---|---|
| line_items | LineItem array | An array of LineItem objects containing a separate LineItem for each of rate, tax, and fee types. | true |
| final_price_at_booking | Price | Object containing the entire price to be paid at time of booking, including taxes and fees. This will be used to validate the line items. | true |
Reservation
| Field | Type | Description | Mandatory |
|---|---|---|---|
| reservation_id | string | unique id for this reservation | true |
| status | string | Booked Cancelled | true |
| status | string | Booked Cancelled | true |
| confirmation_url | string | Deep link to the reservation confirmation page. | true |
| checkin_date | string | The check-in date of the user in YYYY-MM-DD. | true |
| checkout_date | string | The check-out date of the user in YYYY-MM-DD. | true |
| Hotel_id | string | Unique identifier for this hotel | true |
| customer | Customer | Contains the customer booking the reservation | true |
| rooms | RoomStay array | An array of RoomStay objects. | true |
| receipt | Receipt | Information about the pricing on the reservation. | true |