OVERVIEW
This post is here to clarify the process to follow for creating an interface between a Partner (wishing to send/retrieve data to hotels tools such as PMS) and Hotels.
STEP 1 : BEING REFERENCED AS A HOTEL INTERFACE PARTNER
If you wish to become a "Hotel Interface" Partner, you first need to be referenced in our system.
Your Accor point of contact will need to contact us by email : accor.openapi.support@accor.com.
STEP 2 : CONFIGURING A HOTEL INTERFACE
Once you are referenced as a "Hotel Interface" Partner, for each hotel you wish to send data, your Accor point of contact will need to create a ticket here.
Notes :
- During this step, all the Accor needed configurations will be handled automatically:
- Security firewall access
- Security DNS access
- Security server certificate
- The Accor point of contact and the local IT team would be notified whether some actions are needed while the ticket is being processed like :
- Generating a certificate
- Installing a certificate
- Once everything is done, the Accor point of contact will be notified directly within the SNOW ticket.
- Then you'll be able to follow the remaining steps described below in order to send your first API calls on TEST + PROD environments.
STEP 3 : CREATING AN API PORTAL ACCOUNT
As a Partner, you will have to create an account on the Portal by clicking here in order to access our APIs.
Note : This account must be created by the Partner and not the Accor point of contact.
STEP 4 : LOGIN TO THE API PORTAL
As a Partner, you will have to login to the Portal by clicking "Login for external users".
STEP 5 : ACCESSING AN API
Once connected, you can easily use any API in just a few steps.
Step 5.1 : Create Team App
- Create a Team App.
Step 5.2 : Tick the needed APIs in the list
Step 5.3 : Click the eye icon
Step 5.4 : Retrieve your "API Key" for test environment
Step 5.5 : Access the API documentation and use your API Key on test environment
https://developer.accor.com/api-portfolio/hotel-interface/100
STEP 6 : GOING LIVE
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 request a Test validation committee (see section below) to validate your development and define whether security tests need to 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.
Step 6.1 : Request a "Test Validation Committee"
You can use the contact form to send us the requested information listed below.
- Context of the APIs usage
- Needed APIs
- Sensitive data shared between Accor & Partner ? (list to be provided)
- Confirm if there is a contract signed between Accor & Partner ? (sensitive data, type, usage, ...)
- Estimation of volumes (API calls) (per hours, per day, per month)
- Date for the go live
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 validate developments made by the partner and define whether security tests needs to be performed.
Step 6.2 : Request a "Prod Validation Committee"
You can use the contact form to send us the requested information listed below.
- Context of the APIs usage
- Needed APIs
- Sensitive data shared between Accor & Partner ? (list to be provided)
- Confirm if there is a contract signed between Accor & Partner ? (sensitive data, type, usage, ...)
- Estimation of volumes (API calls) (per hours, per day, per month)
- IP addresses for whitelisting purpose
- Date for the go live
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.