Build the best API Hotel with Traveloka Atlas API

Our documented answers
to most frequently asked questions

Frequently Asked Question

Error Code

General API Usage

How do I authenticate with Traveloka's Atlas API?

Use Basic Authentication method by using token_type = Basic and encoded_string = combination of external_client_id:secret_key encoded in base64

For example:
-> external_client_id: partnerA
-> secret_key: ABCXYZ
So, encoded string: cGFydG5lckE6QUJDWFla

For security reasons, all requests have to be encrypted by SSL
For reference: https://datatracker.ietf.org/doc/html/rfc7617

What is the timeout for each flow?

Here's timeout for each flow at Traveloka side

Hotel List = 1.6 sec
Room List (Room List I) = 2 sec
Prebook (Room List II) = 6.5 sec
Book = 180 sec
Issue Check = 60 sec
Issue = 120 sec
Booking Summary = 60 sec
Cancel Booking = 60 sec

Please ensure the timeout is set to the specified value or lower.

What error code should I be aware of?

Please ensure to include below error for Issuance API:

3017: BOOKING_ALREADY_ISSUED
3018: BOOKING_CANCELED
3006: BOOKING_EXPIRED
3016: FAILED_TO_CONFIRM_BOOKING
3003: INCORRECT_BOOKING_ID
3001: INCORRECT_BOOKING_INFORMATION
3020: PENDING_BOOKING
3000: UNEXPECTED_ERROR

Is there a way to verify Traveloka Atlas API development via a management console in the staging environment?

Currently we don't have management console in staging environment yet

How to differentiate rate channel to Traveloka?

Please create different credential for each rate channel

What locale is being supported by Traveloka?

Here's current list of locale supported by Traveloka:

en_ID
id_ID
en_SG
en_PH
en_MY
ms_MY
en_TH
th_TH
en_VN
vi_VN
en_AU
en_EN
en_JP
en_KR
en_HK
en_TW
ko_KR
ja_JP
zh_EN
zh_MY
zh_HK
zh_TW

Content API

What coordinate system Traveloka use for latitude and longitude?

Please use google maps coordinate system

What is the maximum character for room Id?

Maximum character for roomId is 100
Also please ensure that the roomId is physical room Id

What if I don’t have hotel and room photos? Can I still list my inventory on Traveloka?

Photos are required, especially for unique inventories on Traveloka. Without them, your listings may face limitations in visibility and sales.

What if I don't have full hotel contact details?

At least one contact method (phone or email) is required to ensure smooth operations. Please reach out to us to discuss further.

What if we cannot provide some mandatory parameters that have been stated on your API doc? Will that be a problem?

We suggest to fulfill the mandatory parameters as this will impact in content scoring and likeability for hotel to be sold.

How often will you update the static content after going live?

By default Traveloka will update static content on biweekly basis

Search API

What is the maximum number of hotel per request from Traveloka?

Traveloka supports up to 25 hotels per request
If your system allows fewer, please let us know.

What is the maximum number of guests per request from Traveloka?

Traveloka supports up to 32 guests per request
If your system allows fewer, please let us know.

What is the maximum number of room per request from Traveloka?

Traveloka supports up to 8 rooms per request
If your system allows fewer, please let us know.

What is the maximum search date per request from Traveloka?

Traveloka supports up to 1 year from search date
If your system allows fewer, please let us know.

What is the maximum number of nights per request from Traveloka?

Traveloka supports up to 30 nights per request
If your system allows fewer, please let us know.

In the documentation, is mentioned that we need to return providerRecommendedSellingRate and providerOriginalRate. If my business model is mark-up. What should I send?

Please return the same rate for both providerRecommendedSellingRate and providerOriginalRate.

CommissionRate is mandatory in Room List API, while my business model is mark-up. What should I send?

Please send zero value as follows:

"commissionRate": 0

Booking API

How to avoid multiple booking?

Please make sure to implement issue check API

We will only proceed issuance if we get INVALID_UNIQUE_ID as response from Issue Check which means unique Id is not yet exist in issuance process.

Roughly here's normal flow that we expect:

Issue Check (INVALID_UNIQUE_ID) ->
Issue (OK) ->
Booking Summary

What does 'multiroom' meaning?

Multi room means multiple quantitites of room.

Do you support multiple type of rooms booking?

No.

How many times will the issue check and issue request interfaces retry, and how often will they retry?

We will retry 15 times with buffer time 60 sec per issuance attempt.

Post Booking API

Do you support cancellation before booking has been confirmed?

No.

Jump to TopicGeneral API UsageContent APISearch APIBooking APIPost Booking API