Integration Guide

How It Works

BoardingPass Connect reads the barcode on airline boarding passes and automatically creates a customer profile in your Sales Intellect POS. The cashier then selects that customer when processing the sale, linking the purchase to the traveller's flight details.

Setup (5 minutes)

Step 1: Get your Sales Intellect API Token

1. Log in to Sales Intellect Back Office
2. Go to Integrations → Access Token
3. Generate a new access token
4. Go to the Webhooks & Settings page in BoardingPass Connect and paste your token
5. Copy the token

Step 2: Configure Webhook (Optional — for automatic sync)

To automatically receive sales data back into BoardingPass Connect:

1. In Sales Intellect Back Office, go to Integrations → Webhooks
2. Add a new webhook with the URL:
   https://boardingpass.careiq.com.au/webhook/salesintellect
3. Enable events: receipts.create, receipts.update, customers.create, customers.update
4. Save

Step 3: Done!

Start scanning boarding passes from the Scan page.

Daily Usage

Option A: Scan in BoardingPass Connect (Recommended)

1. Open boardingpass.careiq.com.au/scan on your phone or tablet
2. Upload a photo of the boarding pass, or use a hardware barcode scanner
3. The customer is automatically created in Sales Intellect with their name and flight details
4. In Sales Intellect POS, search for the customer by name when processing the sale

Option B: Hardware Barcode Scanner at POS

1. Connect a USB/Bluetooth barcode scanner to the device running BoardingPass Connect
2. Open the Scan page
3. Scan the boarding pass barcode — it auto-detects and submits
4. Customer is created in Sales Intellect instantly

Option C: Scan in Sales Intellect (Limited)

If you scan the boarding pass barcode as the customer code in Sales Intellect, the data will sync via webhook. Note: Sales Intellect truncates the barcode to 32 characters, so some flight details may be lost.

Data Captured from Boarding Pass

Field	Example	Sent to SI
Passenger Name	JOHN DOE	✅ As customer name
Booking Reference (PNR)	ABC123	✅ As customer code
Route	London → New York	✅ In description
Flight Number	BA 173	✅ In description
Travel Date	15 Apr 2026	✅ In description
Seat / Class	21D / Economy	✅ In description
Airline	British Airways	✅ In description

Analytics & Reports

Once boarding passes are linked to sales, the Dashboard and Reports pages show:

• Revenue by route — which flight routes drive the most spending
• Revenue by airline — which airlines' passengers spend the most
• Revenue by cabin class — Economy vs Business vs First class spending
• Daily trends — sales patterns over time
• Passenger search — look up any passenger by name, PNR, or receipt number

API Access (for Developers)

BoardingPass Connect also provides a REST API for custom integrations:

Parse a barcode (no save)

POST /api/parse
Content-Type: application/json

{"barcode": "M1DOE/JOHN              EABC123 LHRJFKBA 0173 106Y022A0001 100"}

List boarding passes

GET /api/boarding-passes?origin=FRA&airline=SN&page=1&per_page=50

Supported Barcode Formats

• PDF417 — printed boarding passes (wide rectangular barcode)
• QR Code — mobile/digital boarding passes
• Aztec — mobile boarding passes (bullseye pattern)

All formats follow the IATA Resolution 792 (BCBP) standard used by all airlines worldwide.

Requirements

• Sales Intellect POS account with API access
• A device with a web browser (phone, tablet, or computer)
• For best results: a USB barcode scanner that supports PDF417
• Internet connection