Travel Partner Integration Guide

How it works

Getting started

Before you start

Log into your DutyBoost Travel Partner dashboard and navigate to Settings → API Integration. Copy your API key. This key identifies your Travel Partner account and attributes commissions correctly.

# Replace with your DutyBoost API key from your Travel Partner dashboard
curl -X POST https://api.dutyboost.com/v1/generate-duty-credit \
  -H "Content-Type: application/json" \
  -H "X-DutyBoost-Key: YOUR_API_KEY" \
  -d '{
    "booking_id": "TEST-001",
    "total_ticket_price": 500,
    "number_of_travelers": 1,
    "travel_type": "Short-haul",
    "departure_airport": "AMS",
    "travel_date": "2025-12-01",
    "traveler_email": "test@youragency.com",
    "traveler_name": "Test Traveler",
    "agency_email": "you@youragency.com"
  }'

After every confirmed flight booking, your system must make a single POST request to the DutyBoost API. The ideal trigger point is your booking confirmation webhook, post-payment callback, or the "booking completed" event in your booking engine.

Code examples:

API Response

The API returns a JSON object. On success, use the fields below:

{
  "success": true,
  "voucher_code": "DB-X7K2M4NP",
  "discount_percentage": 16,
  "expiration_date": "2025-12-01",
  "duty_credit_url": "https://dutyboost.com/voucher?code=DB-X7K2M4NP",
  "qr_image_url": "https://api.qrserver.com/v1/create-qr-code/?size=300x300&data=DB-X7K2M4NP",
  "html_snippet": "<div style='...'>...</div>",
  "message": "DutyCredit generated and emailed to traveler"
}

The API response includes a ready-to-use html_snippet — a self-contained HTML block compatible with all major email clients (Gmail, Outlook, Apple Mail). Inject it into your booking confirmation email template, right below the booking summary.

// After calling the DutyBoost API, inject html_snippet into your email:
const duty = await issueDutyCredit(booking);

const confirmationEmailHtml = `
  <h2>Your booking is confirmed! ✈️</h2>

  <p>Booking reference: ${booking.id}</p>
  <p>Departure: ${booking.departureAirport} on ${booking.departureDate}</p>

  <!-- ↓↓↓ Paste DutyBoost block here ↓↓↓ -->
  ${duty.html_snippet}
  <!-- ↑↑↑ End DutyBoost block ↑↑↑ -->

  <p>Have a great trip!</p>
`;

How discounts are calculated

DutyBoost calculates discounts based on basket spend — simple and transparent. Discounts are capped at €60 on €300+ spend.

The more the traveler spends, the higher the discount — up to a maximum of €60 on €300+ spend.
Example: A traveler spends €300 at a retailer and receives a €60 discount. The net sales value (€240) is the basis for commission distribution.

When a traveler redeems their DutyCredit at an airport store, DutyBoost can notify your system via a webhook. This is useful for CRM updates, commission tracking, or notifying account managers.

Configure your webhook URL in your Travel Partner dashboard under Settings → Webhooks.

// DutyBoost will POST to your webhook URL when a voucher is redeemed
// Configure your webhook URL in your Travel Partner dashboard settings

app.post('/webhooks/dutyboost', (req, res) => {
  const { event, voucher_code, store_name, discount_amount, redeemed_at } = req.body;

  if (event === 'voucher.redeemed') {
    // Log commission earned, update CRM, notify account manager, etc.
    console.log(`Voucher ${voucher_code} redeemed at ${store_name}`);
    console.log(`You earned commission on ${discount_amount} EUR discount applied`);
  }

  res.status(200).send('OK');
});

Commission & revenue share

DutyBoost operates on a performance-based revenue model. You earn commission on every redeemed DutyCredit based on the net sales value at the retailer.

What the traveler experiences