FAQ

General Configuration

How do I have access to production environment?

Users with Operator level of access need to request the user creation to Cangooroo support team and then the Operator need to enable the user.

What is the correct URL for the API?

You need to use the URL https://ws-[operatorid].cangooroo.net. Please make sure that you have the correct ws- URL.

Date fields

How to handle date fields in the API?

Whenever you find a date field in the API (no matter if REST or SOAP) send it as string in the following format: "YYYY-MM-DD".

Booking status

What are the possible status of a booking?

Cangooroo has some status that is returned when attempting to do a booking, here they are:

  • Confirmed: booking confirmed by the supplier. No further action is necessary;

  • Rejected: booking not confirmed by the supplier. No further action is necessary;

  • Cancelled: booking cancelled. No further action is necessary;

The following status can be changed manually in the Cangooroo by its license owner:

  • OnRequest: booking is on request, the status of this booking can change to Confirmed or Rejected/Cancelled;

  • AwatingPayment: booking is not confirmed and is waiting for payment;

The following status needs to be handled manually in the Cangooroo by its license owner (eg: tour operator):

  • TechnicalProblem: means that we have an unrecoverable problem (a TechnicalProblem) and therefore the booking need to be handled manually;

  • InProgress: when the response has this status is necessary to use booking detail method to recover the actual booking status;

  • PendingCancellation: a failure on try to cancel a booking;

For more information: https://kb.cangooroo.net/display/KBC/Cangooroo+reservations+status.

For how long can I use the token?

Our token duration is 30 minutes and you can do only one booking process per token.

Cangooroo response time?

You need to check the time out configuration, if your response time is the same of the configuration or below we consider that nothing is wrong.

Does the API supports pagination?

We don't support pagination on our API at this time. If we do you will find it on each service documentation.

How many calls can be done to the API?

Please contact the owner of the Cangooroo licence in order to have this information.

Problems to retrieve the booking conditions (or the obsolete API: cancellation policies)?

When you request the operation "getCancellationPolicies"/"getBookingConditions" with more than one room with the same configuration, for example 3 rooms with 1 adult, you must inform the same roomId in getCancellationPolicies quantity times, for example:

<RoomsIds>

<string>ABCD123</string>

<string>ABCD123</string>

<string>ABCD123</string>

</RoomsIds>

obs: For the same room configuration you can't book differents rooms!


Possible errors when trying to book a room

  1. You must certify that the rooms that you're trying to book were in the last request of GetBookingConditions that you made.

  2. The time between search and book must be less than 30 minutes.

  3. You must request the GetBookingConditions method before DoBooking method.


When can I assume that a reservation has been confirmed?

Whenever you receive a correct response from our API with a Confirmed status (please see the section Booking Status above).

If you receive any errors, especially ones like HTTP 5xx or HTTP 4xx (usually HTTP 429), you should keep your booking with a pending status and use our ClientBackoffice endpoint to check the booking with your reference code. We suggest a specific flow here.