Knowledge Base

Learn about top features of our solutions. Get help whenever you need.

English
How a channel can sell extra services via Exely Connect

How a channel can sell extra services via Exely Connect

Last update: Feb 20, 2025

1. Make adjustments on a test environment https://connect.test.hopenapi.com/docs/booking-process/.

2. Test the integration for all points on the checklist below. For points 1-8 of the checklist, take screenshots that clearly show that they are successfully implemented and functioning. No screenshots are needed for points 9-11.

3. Record a video showing the booking process with the extra services option. The booking should follow the diagram below:


4. Send the screenshots and a link to the project website, where booking is possible with the option to offer extra services, to email connectivity@exely.com.

5. We will carry out the certification within 5 working days. If at least one of the checklist points is not implemented or does not work, you will need to make adjustments.

6. After successful certification, within 2 working days, we will activate the functionality for you to work with services for extra cost in the production environment.

7. You will need to inform properties of the new functionality, allowing them to offer extra services at an additional cost.


Checklist for testing extra services sales on the OTA website

In the test environment, the property ID 500803 (Exely Connect for Certification) has different early extra services configured to set up and test the integration.

1. When searching for extra services within one property, full information must be displayed: the service name, price, available quantity and images (if any).

2. During the search, it must be ensured that there are no duplicate extra services. In the test environment of the test property, all service options are unique.

3. It is required to display information about services available for purchase for extra cost. This should be done according to the value of the calculationMethod parameter in the /v1/properties/{propertyId}/services API method response.

To check if the services are output correctly in the API, send a request with a search for services for two adults, one child of 5 years old and one child of 10 years old.

Request:


calculationMethod = PerPerson — a service is provided per guest at the same price for all guests.

API response

Possible display of API response in a channel


calculationMethod = PerPersonByAge — a service is provided per guest at different prices, depending on the age of the guests. For details, refer to the article: “How to set different prices for services for adults and children”.

API response

Possible display of API response in a channel

The service is available for adults and children at different prices:

The service is available for adults only:

The service is available only for children of from 0 to 6 years old:

The service is available for children only:


calculationMethod = PerUse — a service is provided on a per item or per use basis at the same price for all guests.

API response

Possible display of API response in a channel


calculationMethod = PerStay — a service is provided per room at the same price for all guests.

Response в API

Возможное отображение ответа API в канале


4. It should be possible to search for a limited number of services, not for all guests included in the booking. This applies to PerPerson, PerPersonByAge and PerUse services. In the service search request (/v1/properties/{propertyId}/services), you can change the number and age of guests (placements, guestCount) to adjust the number and price of services available for booking.

5. When booking services with PerUse charge type in a larger quantity than specified in the quantity parameter, it is required to specify the desired number of services in the verify method, but not exceeding maxQuantity. Next, you need to display the updated cost of accommodation and services for the guest before confirming the booking.

6. The /bookings/verify method must be called before the payment step. In response to this request, the checksum value will change because paid extra services are included in the booking. After the payment is made, the booking creation method must be called, where it is checked if the checksum is correct

7. Information on the updated booking price must be shown to the guest on the sales channel side before the payment step, if services for extra cost have been added to the booking.

8. It must be possible to cancel a booking. Cancellation activates the calculate-cancellation-penalty method, which correctly displays the cancellation conditions for the current date, including cost of the extra services included in the prepayment.

9. The order of photos of extra services must strictly follow the sequence specified in API. Content and images of these services are stored on the sales channel side.

10. Content API methods are not used during the price search and booking process, and images are not downloaded from Exely.

11. It is required to ensure that the data specified when forming a request to create a booking is correctly passed via API.


Need More Help? Contact Support

CONTACT SUPPORT