Integration Process

Step-by-step overview of the integration process

To ensure a smooth and successful integration, we strongly recommend following the structured process outlined below. This ensures that both your development team and Prioticket’s integration specialists are fully aligned, allowing us to offer the best possible support tailored to your specific needs.

---

Step 1: Request API Access and Documentation

Before development begins, you’ll need valid credentials for our staging environment. These can be obtained by submitting a request through our Service Desk.

You Will Receive:

• API documentation

• Access credentials to the staging environment

• A certification script template

Processing Time:

• Documentation and credentials will be provided within 5 business days.

During this process, we’ll ask for details about your interested suppliers' product portfolio. This allows us to provide customized certification guidance tailored to your business needs.

Important Note:

The certification script outlines both mandatory and optional test cases.

• Mandatory cases may vary depending on the suppliers or clients you plan to work with.

---

Step 2: Scoping & Development Phase

Before diving into development, it's important to prepare your integration approach based on your specific business needs. Our API is designed to be flexible, allowing for partial implementations and minimal viable requests where needed.

Review the Documentation:

Familiarize yourself with our API documentation, including best practices and sample requests. Understanding how our platform works will help you design a cleaner, faster integration.

Define Your Integration Scope:

Our API offers an extensive set of capabilities & features, but not every feature needs to be implemented. By clearly defining your scope upfront based on the certification template provided to you, you can:

• Focus on the features that matter to your business

• Avoid unnecessary development effort

• Reduce time-to-market

Example: Minimal Order Request

To show how flexible our API can be, here’s an example of a fully valid order using just a handful of required fields — no unnecessary complexity:

"order": {
   "order_distributor_id": "{{order_distributor_id}}",
   "order_language": "{{order_language}}",
   "order_external_reference": "{{order_external_reference}}",
   "order_bookings": [
       {
           "booking_option_type": "DIRECT_BOOKING",
           "product_id": "{product_id}",
           "product_type_details": [
               {
                   "product_type_id": "{{product_type_id}}",
                   "product_type_count": "{{product_type_count}}"
               }
           ]
       }
   ],
   "order_contact": {
       "contact_email": "{{contact_email}}"
   }
}

Once you’ve defined your integration scope based on your business needs, you can begin building your integration using the selected API features.

Need Help?

If you have questions while preparing your scope, reviewing advanced functionalities, or during development, please raise a support ticket to our API Support Team.

• Response Time: Within 4 business days

---

Step 3: End-to-End Testing & Certification

Once development is complete, you’ll need to initiate the certification process by submitting an API Certification Request through our Service Desk.

This triggers our end-to-end verification process, during which Prioticket will evaluate your integration to ensure:

• Requests are correctly formed

• Data flows smoothly between systems

• Mandatory requirements are met

You Will Receive:

• A new set of certification credentials (distinct from development credentials but with access to the same products). These credentials can continue to be used for staging tests post-production.

• A customized certification script based on your interested suppliers' product portfolios. You must complete all mandatory test cases.

Recommendation: We encourage completing additional recommended & optional cases to broaden your supported feature set. This can help avoid the need for future re-certification when onboarding new suppliers or features.

Processing Time:

Certification script and credentials will be provided within 5 business days.

Certification Review Time:

Each round of certification review will be completed within 5 business days. If you fail any case, you must re-certify only the failed cases before moving forward.

Credential Management: Some suppliers may require you to utilise separate credentials tied to their admin environments (e.g. when using supplier-branded voucher templates).

You may need to manage multiple credential sets depending on the suppliers' product portfolios you plan to distribute.

---

Step 4: Post-Certification & Go Live

After successfully completing the certification process, you’ll be required to fill out a brief post-certification questionnaire. This helps us understand how you intend to use the API and ensures we configure your production environment appropriately.

If the questionnaire responses are valid and complete, we will issue your production credentials, which include your Distributor ID.

Distributor ID Usage:

• Share this ID with the suppliers you’ve entered into commercial agreements with.

• Suppliers will enable access to their products for your distributor account based on these agreements.

---

Step 5: Live Testing & Continuous Monitoring

Once you are in production, live testing will be carried out directly with the suppliers you have partnered with to verify end-to-end connectivity and real-time order handling.

• Post-Launch Monitoring: After your integration goes live, Prioticket will closely monitor the initial error rates and overall system behavior during your first weeks in production.

• Issue Escalation: If any issues are identified, Prioticket will contact the API support contact you provided in the post-certification questionnaire to ensure timely resolution.

---

Need Help?

Our API Support Team is always ready to support you. If you have questions at any stage, just submit a request through our Service Desk.

• Response Time: Within 4 business days