Skip to main content

Go into production!

Now that you know everything about our Partner API, it is time for you to validate your integration to receive your production token.

Step 1: Check if your staging token is valid​

Before doing anything, it is important to check that your staging token is valid or not.

To check your token validity, you should do the following:

curl -X POST "https://staging-partner.api.hikoala.co/quotes" -H "Content-Type: application/JSON" -H "accept: application/JSON" -H "Authorization: Bearer <token>"
note

If you receive an API answer other than 401, you are good to go to Step 2 👍


Step 2: Send us test Quotes​

To check that you have implemented the right logic to obtain prices from us, you should post at least 5 valid Quotes.

Inside your payload, you should use the test data of your choice, provided that it respects the data format.

Caution: Please only use dates in the future for your tests, otherwise the API will return you an error message.

If you have questions or doubt about this step, please refer to our Quotes page.

note

Once you have 5 successful quotes, you can go to step 3 👌


Step 3: Send us test Subscriptions​

Now that you have obtained successful Quotes, you should turn those Quotes into Subscriptions.

Just as for the Quotes, you should use the test data of your choice inside the payload.

If you have questions or doubt about this step, please refer to our Subscriptions page.

note

Once you have 5 successful subscriptions, you can move on to step 4 🤩


Step 4: Send us test Updates​

Once you have created contracts, you should test the implementation of the Update.

If you need help to validate this step, please refer to our Update page.

note

Once you have 5 successful updates, you can move on to Step 5 👀


Step 5: Tracking the conversion rate​

To allow us to track our conversion rate, you should do the mission described on this page.

note

Once you have successfully deleted 5 quotes, you can move on to additional steps 💪

Additional step 1: Send us test claims (only if you sell our Koala Flex)​

Now that you have contracts on your environment, you should simulate a booking cancellation made by the traveler.

Inside your payload, we advise that you use:

  • Fake data for the beneficiaryName
  • An IBAN generated by Random IBAN
  • The following BIC: BNPAFRPP

If you have questions or doubts about this step, please refer to our Contracts page.

note

You should do at least 5 successful claims to validate this step ✅


Additional step 2: Report flight cancellations (only if you sell flights)​

When you are selling flights, you should add the feature to report flight cancellations.

To do so, please refer to our Report Flight Cancellation page.

note

You should do at least 3 successful flight cancellation reports to validate this step 👌


Additional step 3: Send us webhook URL and secret (only if you want to activate the webhook)​

The URL and the secret you want to use for the webhook should be sent at leo@hikoala.co

note

Once the webhook is configured internally, we will ping you by email to validate this step 👍


Step 6: Change the environment to prod environment​

Once you have completed all the tasks, please ping us so that we can take a look together.


If everything is functioning correctly, we will send you your prod token and you will be good to go live! 🚀

Before going live, please change your server URL from https://staging-partner.api.hikoala.co into: https://partner.api.hikoala.co/.