Channex Shopping API

API Methods to get real time rates, availability and content from Channex.

These are API methods for META-like channel connections. If your application does not cache any information on your side about Properties, Availability and Restrictions, you can implement support for our Shopping API and use it to build your own Booking Engine or Meta Channel.

This API is for real time shopping of Channex API for all required details. Perfect for many applications as you don't need to cache anything on your side.

Coming Soon

Get available properties method

Provider API Key to protect channel

Experimental API These API methods are experimental and can be changed based at client feedback.

Properties List

Method to get a list of connected Properties.

GET https://staging.channex.io/api/v1/meta/{{CHANNEL_NAME}}/property_list
{
"data": [
{
"attributes": {
"address": "220125, RU, Moscow, Moscow, Zubovskaya 5",
"city": "Moscow",
"country": "RU",
"description": "Excellent Hotel and Old City Centre",
"id": "c1595b90-75f3-4b7e-b3c4-cf6a70f0d81d",
"lat": "11.001323",
"lng": "33.023321",
"photos": [],
"state": "Moscow",
"title": "Old City Centre",
"zip_code": "220125"
},
"id": "c1595b90-75f3-4b7e-b3c4-cf6a70f0d81d",
"type": "property"
},
{
"attributes": {
"address": "SW1W 0AD, GB, London, 10 Chester Square",
"city": "London",
"country": "GB",
"description": "Quiet hotel at heart of British capital",
"id": "37d1c98a-bb20-4ca4-a8ce-bc1ee78d9455",
"lat": "51.4966440",
"lng": "-0.1476140",
"photos": [
{
"url": "https://img.channex.io/ec4f261a-1e21-4070-922b-86e0c46abd26/",
"description": null,
"author": null
}
],
"state": null,
"title": "Royal Hotel tbf",
"zip_code": "SW1W 0AD"
},
"id": "37d1c98a-bb20-4ca4-a8ce-bc1ee78d9455",
"type": "property"
}
],
"meta": {}
}

This endpoint supports filters by city, lat, lng and country. To apply filter pass it as query argument: /property_list?filter[city]=Moscow

You can use our Photo Transformations to get photos fit to your design.

Get Property Info

Method to get Property Info by ID

GET https://staging.channex.io/api/v1/meta/{{CHANNEL_NAME}}/{{PROPERTY_ID}}/property_info
{
"data": {
"attributes": {
"address": "SW1W 0AD, GB, London, 10 Chester Square",
"city": "London",
"country": "GB",
"description": "Quiet hotel at heart of British capital",
"id": "37d1c98a-bb20-4ca4-a8ce-bc1ee78d9455",
"location": {
"lat": "51.4966440",
"lng": "-0.1476140",
},
"facilities": [
"Swimming Pool", "GYM"
],
"photos": [
{
"url": "https://img.channex.io/ec4f261a-1e21-4070-922b-86e0c46abd26/",
"description": null,
"author": null
}
],
"state": null,
"title": "Royal Hotel tbf",
"zip_code": "SW1W 0AD"
},
"id": "37d1c98a-bb20-4ca4-a8ce-bc1ee78d9455",
"type": "property_info"
}
}

Get Closed Dates

Method to get unavailable dates, dates closed to arrival and departure.

GET https://staging.channex.io/api/v1/meta/{{CHANNEL_NAME}}/{{PROPERTY_ID}}/closed_dates
{
"data": {
"attributes": {
"closed": [
"2020-09-17"
],
"closed_to_arrival": [
"2020-09-19"
],
"closed_to_departure": [
"2020-09-15"
]
},
"type": "closed_dates_list"
}
}

Get Rooms List

Method to get Rooms and Rates list

GET https://staging.channex.io/api/v1/meta/{{CHANNEL_NAME}}/{{PROPERTY_ID}}/rooms?checkin_date=YYYY-MM-DD&checkout_date=YYYY-MM-DD
{
"data": [
{
"type": "room_with_rates",
"id": "ROOM_ID",
"attributes": {
"id": "ROOM_ID",
"title": "Room Title",
"description": "Description",
"bed_options": [
{
"title": "Olympic Queen",
"count": 2,
"size": "90x200 CM"
}
],
"facilities": ["facility 1", "facility 2"],
"photos": [
{
"url": "PHOTO_URL",
"title": "title",
"author": "author"
}
],
"rate_plans": [
{
"id": "RATE_PLAN_ID",
"title": "Title",
"occupancy": {
"adults": 1,
"children": 0,
"infants": 0
},
"cancellation_policy": "Cancellation policy",
"meal_plan": "Bed & Breakfast",
"price": "100.00",
"taxes": [
{
"title": "Tax Title",
"amount": "10.00",
"inclusive": false,
"rate": "10.00",
"mode": "percent"
}
]
}
]
}
}
]
}

This method will return list of Rooms and Rate Plans. This method supports filter arguments:

  • checkin_date (Date at ISO format YYYY-MM-DD)

  • checkout_date (Date at ISO format YYYY-MM-DD)

  • length_of_stay (Integer)

Checkout_date is optional if you use length_of_stay and vice versa.

If the method is called without dates, it will return Rooms list without Rate Plans.

Push Booking

Method to create Bookings

POST https://secure-staging.channex.io/api/v1/meta/{{CHANNEL_CODE}}/{{PROPERTY_ID}}/push_booking
{
"booking": {
"status": "new",
"reservation_id": "{{UNIQUE_ID_FROM_OTA}}",
"arrival_date": "2019-05-09",
"departure_date": "2019-05-10",
"arrival_hour": "10:00",
"currency": "GBP",
"payment_collect": "property",
"payment_type": "credit_card",
"customer": {
"name": "User",
"surname": "Channex",
"country": "EN",
"city": "London",
"address": "101 Finsbury Pavement",
"zip": "ec2a 1rs",
"mail": "support@channex.io",
"phone": "+44 444 4444 44 44",
"language": "EB",
"company": {
"title": "Channex.io",
"number": "TAX NUMBER",
"number_type": "VAT"
},
"meta": {}
},
"guarantee": {
"expiration_date": "10/2020",
"cvv": "123",
"cardholder_name": "Channex User",
"card_type": "visa",
"card_number": "4111111111111111",
"meta": {
"virtual_card_currency_code": "GBP",
"virtual_card_current_balance": 10000,
"virtual_card_decimal_places": 2,
"virtual_card_effective_date": "2020-02-02",
"virtual_card_expiration_date": "2021-02-02"
}
},
"rooms": [
{
"index": 0,
"room_type_code": "{{ROOM_TYPE_ID}}",
"occupancy": {
"adults": 1,
"children": 0,
"infants": 0
},
"days": [
{
"date": "2019-05-09",
"price": "100.00",
"rate_plan_code": "{{RATE_PLAN_ID}}"
}
]
}
],
"services": [
{
"type": "Fee",
"total_price": "100.00",
"price_per_unit": "100.00",
"price_mode": "Per stay",
"persons": 0,
"nights": 0,
"name": "Cancellation Fee",
"room_index": null
}
]
}
}

Please, keep in mind, if you pass Credit Card Information, you MUST use the secure endpoint: secure-staging.channex.io

Field description

status [required] String. Status of Booking, can be one of three values: new, modified, cancelled.

reservation_id [optional] String. Booking unique ID. For messages with status new can be empty, in that case Channex will generate unique UUID for booking.

arrival_date [required] String. Arrival Date represented as string with date in ISO 8601 format by mask YYYY-MM-DD.

departure_date [required] String. Departure Date represented as string with date in ISO 8601 format by mask YYYY-MM-DD.

arrival_hour [optional] String. Arrival Time represented as string with time in HH:MM format at 24h.

currency [required] String. Booking currency code. 3 symbols long string with Currency Alphabetic code based at ISO 4217.

payment_collect [optional] String. Information about payment collect point. If payment collected via OTA, it should be ota, in other case it should be property. Default value is property.

payment_type [optional] String. Information about how payment should be collected. Support bank_transfer or credit_card. Can be null if not specified. bank_transfer value suitable for OTA collect case.

Customer Fields

Information about the Customer (Who made the booking)

name [optional] String with maximum length of 255 symbols. Name of Customer.

surname [required] String with maximum length of 255 symbols. Surname of Customer.

country [optional] String. 2 symbols long string with Country Alpha-2 code based at ISO-3166-1.

city [optional] String with maximum length of 255 symbols. Customer City name.

address [optional] String with maximum length of 255 symbols. Customer Address.

zip [optional] String with maximum length of 32 symbols. Customer ZIP Code.

mail [optional] String with a valid email address. Customer Email address.

phone [optional] String with maximum length of 32 symbols. Can contain digits, spaces, brackets and special characters. Customer Phone number.

Please if possible pass in friendly format with country code like this example: +447749617211

This can be simple for the property to contact the guest.

language [optional] String. 2 symbols long string with language locale code.

company [optional] Object with information about Customer Company (if customer is Business). Can contain next fields:

  • title [optional] String with maximum length of 255 symbols.

  • number [optional] String with maximum length of 255 symbols. Tax Number.

  • number_type [optional] String with maximum length of 255 symbols. Tax Name (eg: VAT)

meta [optional] Object without any specific structure where you can pass any additional information about Customer.

Guarantee Fields

Information about the Credit Card.

If you'd like to pass information about the credit card you must use secure-staging.channex.io or secure.channex.io (for production environment) endpoints. Otherwise the credit card will be masked without ability to restore the original card.

expiration_date [required] String with Card Expiration date in MM/YYYY format.

cvv [required] String with 3 or 4 numbers. Service code for payment systems.

cardholder_name [required] String. Cardholder name from Card front.

card_type [required] String. Card type name.

card_number [required] String. Card number.

meta [optional] Object. Can contain any additional information for booking recipient. Also, if you work with Virtual Credit Cards, you can use next fields:

  • virtual_card_currency_code Currency of virtual card

  • virtual_card_current_balance Current balance of virtual card as Integer value

  • virtual_card_decimal_places Info about decimal places at provided current_balance field

  • virtual_card_effective_date Date when card will be available to charge

  • virtual_card_expiration_date Date when card is expired

Booking Rooms

Booking rooms should be passed as Array of Objects. Each room object should contain information about room_type_code, occupancy, and days breakdown.

index [optional] Integer. Room Index to associate Services at Room level. Incremented value, start from 0.

room_type_code [required] String. Code of Room Type received at Get Rooms List operation.

occupancy [required] Object with information about occupancy. Should contain next fields:

  • adults [required] Integer. Count of adults (persons older then 16 years old)

  • children [required] Integer. Count of children (persons between 2 and 16 years old)

  • infants [required] Integer. Count of infants (persons younger then 2 years old)

days [required] Array with objects. Information about daily prices and rate plans. Keep in mind, our Shopping API support Mixed Rate Plans. Each object should contain next fields:

  • date [required] Date represented as string with date in ISO 8601 format by mask YYYY-MM-DD.

  • price [required] String or Integer. Price of room at specific date.

  • rate_plan_code [required] String. Rate Plan Code received at Get Rooms List operation.

Booking Services (Extras)

Services is Array of Objects to represent additional service or fees sold with bookings. Also, this field can contain Cancellation Fee when booking is cancelled with payment. Each object should contain next fields:

type [required] String. Type of Service. One of possible values: Meal, Fee, Extra

total_price [required] String. Total Service price.

price_per_unit [required] String. Price per one unit of Service.

price_mode [required] String. Service calculation price logic. One of possible values: Per stay, Per night, Per person, Per person per night

persons [required] Integer. Count of persons associated with Service.

nights [required] Integer. Count of nights associated with Service.

name [required] String. Name of service.

room_index [optional] Integer. Index of room which is associated with Service. Keep in mind, Room should have index.