Integration Checklist

​

Before Starting Development

​

Access & Setup

• Sandbox API credentials received
• Production API access process understood
• Webhook endpoint planned
• Currency strategy finalized

​

Product Understanding

• Reviewed product / variant model
• Reviewed cancellation & reschedule flags
• Understood instantConfirmation behavior
• Noted sandbox auto-complete product IDs

​

During Development

​

Product & Inventory

• Fetch and cache active cities
• Fetch products using List Products V2
• Fetch product details by ID
• Treat each variant as a separate SKU
• Fetch inventory in real time
• Do not cache inventory responses

​

PaxTypes & Pricing

• Render paxTypes dynamically — see Pax Types
• Support paxType changes per slot
• Enforce MSP using headoutSellingPrice — see MSP Limitation Product List
• Use netPrice for booking creation
• Validate total price = pax × price

​

Guest Details

• Render input fields dynamically — see Input Fields
• Support all data types
• Respect PRIMARY vs ALL levels
• Create one guest object per pax
• Ensure exactly one primary guest

​

Booking Flow

• Create booking in UNCAPTURED (optional)
• Collect payment before moving to PENDING
• Treat PENDING as confirmed
• Handle price mismatch errors
• Allow all valid status transitions

​

Cancellation & Reschedule

• Read cancel / reschedule flags from product API
• Surface correct policy per variant
• Integrate cancel API
• Integrate reschedule API
• Handle not-allowed cases gracefully

​

Sandbox Testing

• Test full booking flow using sandbox products for multiple input fields and pax types
• Validate auto-complete behavior for listed product IDs — see Fulfilment on Sandbox
• Verify webhook delivery
• Verify voucher rendering
• Verify QR and PDF/HTML ticket handling
• Verify cancel and reschedule APIs

​

Production Testing (Pre Go-Live)

• Place limited live bookings
• Validate PENDING → COMPLETED flow
• Validate delayed ticket generation
• Test cancellation on allowed products
• Test reschedule on allowed products
• Verify webhook behavior in prod
• Verify voucher updates correctly

​

Go-Live Readiness & QA

• Communication opt-in / opt-out finalized
• Support escalation flow aligned
• If you are going live with a static product list, update it one last time