RegistrationInfo

Registration Orientation

The registration process consists of just a few steps:

Step 1: Sign-up for the ADO site

Step 2: Register with the airline API sponsor

Step 3: After registration is approved - access developer portal, read documentation and start developing.

The approval might take some time - when you will out the registration form - put the passwords somewhere where you can find them once the registration is approved.

Once you registered and need to request more point-of-sale accounts (we call them PCC or Office ID) - just login to the site, select the area you need the new PCC in and request it. More information about requesting new PCCs is provided further down on this page.

Most of the time you will start with one PCC in the Sandbox. When you have developed your application to use the APIs and are ready to go to production you will just need to request a new PCC in production. As you progress you might need multiple PCCs. The reasons could be different:

You need multiple points of sale in the same country
You need a new PCC in a new country

More information is provided in the welcome package that is sent after the new registration is approved.

Signing up

When you click on the "Sign up" button on the landing page you would need to fill out a simple form. Enter your company's name, category and postal address. Please also enter your contact and create your user password for the site. You eMail address will be your user name.

After you submit the form - an eMail will be sent to you in order to confirm that you have entered a valid eMail address. Please check your in-box. You also might want to check trash, junk or if you are using MS Outlook - "Clutter" folder. The link in the eMail will bring you back here where you can log in right away.

After you log in to the ADO (Api Developer Onboarding) - you can register with an Api Sponsor by going to the Sandbox page and clicking the "Register" button. This will bring you to the enrollment form.

Registering with a new API airline

Registration with a new airline is possible from the Sandbox page. Click on the "Register" button on the page and this will open the enrollment form.

The enrollment form addresses the following information:

Airline
Point-Of-Sale or the agency section
User credentials that you create to use in your API calls

You can select the airline on the top of the page. The API mode will be preselected most of the time. The requester eMail address will be prepopulated.

The agency section describes the travel agency details such as:

Agency name

The name of the travel agency you work with. Or if you are the agency developing your apps - your company's name.

Agency owner

Owner of the agency or representative.

Agency address

Main address of the agency/API developer.

Point of sale

This section is about setting up the PCC for fare and tax calculations and also reporting of tickets. Consists of 3 fields:

Closest city code: enter either 3-letter IATA city code or just write the name and select from suggested names
Currency code: select the currency in which fares and taxes will be calculated. This will be the default setting on the PCC.
IATA number: if you are an accredited agency with IATA or ARC - enter your 8-digit number. If you don't have it - you can still submit registration. If approved - a pseudo IATA number will be assigned.

Further in the registration form you will find a section where you will create your user credentials. You will use these credentials in your API calls - so write them down. The passwords will not be visible after you submit the form.

The system User identifies your application as a user of the API. The PCC API user will additionally identify your app as a user of the PCC that will be created upon airline's approval. System and PCC users are used in the TC (Transaction Control) header of the SOAP requests messages that you will be sending from your application to the API. More information about TC and XML messages can be found on the developer portal in the Sandbox section.

The PCC API user can also be used to access documentation on the developer portal. Simply combine your PCC and AgentID (with underscore) as the "Username". For example, if your Developer/SPRK credentials are:

PCC/OfficeID: ABC1
User/Agent ID: Agent1
Password: YourPassword42

Your login to the dev portal will be:

Username: ABC1_Agent1
Password: YourPassword42

Requesting additional PCC/OfficeID

Once you have registered - you can request additional PCCs with airlines as you need. The PCC is an account that essentially describes a point of sale. As you expand your API usage you might need more PCCs. In Sandbox you might want to test with different counties. In production you might need more PCCs that correspond to virtual or physical offices. Or you need a different point of sale in a new country.

In order to request a new PCC - login, navigate the environment page (Sandbox or Production) and click on the request PCC button next to the airline where you want to request a new PCC.

The workflow is similar to the registration process. As with initial registration, provisioning of new PCCs is subject to airline approval. The PCC request form is pretty much the same as the registration form. There are a few differences, however.

The "sponsoring airline" field is prepopulated.
There is no need for a new system user - when you request a new PCC you have already created one during your original registration.
If you are requesting a new PCC for production - anticipated API usage information is needed.

Average requests per day: This is your average API usage - all messages combined - that you anticipate on the new PCC.
Average booking per day: As the name suggests, this an average number of bookings that you anticipate to create in the new PCC per day.
Peak requests per minute: This is your anticipated peak usage of the API. All messages combined.