OVERVIEW
This post is here to support you through Accor API's implementation journey.
If you need any additionnal information, please use the "Contact Us" form to reach our API implementation experts.
CREATING AN ACCOUNT
As a Partner, you will need to create an account on the Portal by clicking here in order to access to our API catalog.
As an Accor employee, you don't need to create an account.
LOGIN TO THE PORTAL
As a Partner, you will have to login to the Portal by clicking "Login for external users".
As an Accor employee, you will have to login to the Portal by clicking "Login with IDP".
CREATE A TEAM
You will need to create a team in order to create an app.
Step 1 : Click on the Teams section
Step 2 : Click on Add team
Please choose a name that describes your team : ie : [Brand name] / [Company name] / [Agency name] / etc...
Step 3 : Add your team members
Once the team is created, select Members and Invite members
Please add the members of your team here. It is recommended to have more than one member in the Team in order to Go Live.
CREATE AN APP (Team App) to retrieve an APIKEY
You will need to create an app in order to retrieve an apikey.
Good to know : it is possible to create multiple Apps within a same team.
Step 1 : Click on the Teams section
Step 2 : Select your Team and click on Team Apps
Step 3 : Select + Add Sandbox app
For the Sandbox App name : please choose a name following the recommendation :
"CompanyName_NameOfTheProduct".
Please do not use words referring to the environment such as "test"/"UAT"/... as the app name will remain the same when going Live.
Step 4 : Tick the needed APIs in the list
Good to know : this list can be edited after the creation of the app.
Step 5 : Select your app
Step 6 : Retrieve your "API Key" for test environment
Step 7 : Access the API by using your API Key on test environment
MODIFY AN APP (Team App) to add/retrieve API products
It is possible to modify an App if you need to add more APIs to your app.
Step 1 : Click on the Teams section
Step 2 : Select your Team and click on Team Apps
Step 3 : Select your Sandbox app and click on Edit
Step 4 : Tick the needed APIs in the list
Good to know : the apikey remains unchanged when the app has been edited.
GOING LIVE
Only partners with a valid contract with Accor will be able to Go Live in production. If not, please refer to the "Contact" form and select the subject : "I'd like to discuss a potential integration with Accor APIs".
All the APIs provided on this API Portal are within the Accor Test environment.
It means that once you'll have finalized your development on Test environment, you'll need to validate your development with Accor team and define whether security tests must be performed on your platform. (security tests coud take up to 60 days to be performed)
Then, if everything is validated on Test environment, you'll need to request a Prod validation committee (see section below) to use Accor APIs in production.
- The Prod validation committee will occur in the next 7 days following your request.
- The Go live (production credentials,..) will occur 7 days after the Prod validation committee.
Request a "Prod Validation Committee"
You can use the "Go Live" button, attached to your Sandbox App, to submit your request.
Then, we'll review your request and schedule a short committee review with you to go over the shared elements above.
Reminder : This committee is here to make sure that all Partners going live meet the Accor Requirements & Rules.