Link reference

The link

The link has a single query parameter, t. Its value is your JSON note encoded in Base64url, and everything travels in it, including your referral ID.

https://app.voyani.com/ota/open?t={BASE64_PAYLOAD}

How you build t

t is Base64url-encoded JSON. You produce its value in three steps.

1. Write the booking note. For each booking, build the JSON on this page: the schema version, your referral ID, the booking reference and type, the time of the tap, and the booking itself.
2. Base64url-encode it. Encode the note's UTF-8 bytes as Base64, then make it URL-safe: + becomes -, / becomes _, and trailing = signs are dropped. Standard Base64 with = padding is accepted too.
3. Pass the result as t. Put the encoded value in the link as the single query parameter t. The button and the email both use that one value.

Worked example

The minimum hotel payload, from note to link.

{"v":1,"partnerReferralId":"OTA-7K3QZ9M2XA","bookingReference":"HX88213","bookingType":"hotel","referredAt":"2026-11-06T09:00:00Z","destination":{"city":"Lisbon","countryCode":"PT"},"hotel":{"name":"Example Lisbon Hotel","checkInLocal":"2026-12-11T15:00:00","checkOutLocal":"2026-12-17T11:00:00"}}

eyJ2IjoxLCJwYXJ0bmVyUmVmZXJyYWxJZCI6Ik9UQS03SzNRWjlNMlhBIiwiYm9va2luZ1JlZmVyZW5jZSI6IkhYODgyMTMiLCJib29raW5nVHlwZSI6ImhvdGVsIiwicmVmZXJyZWRBdCI6IjIwMjYtMTEtMDZUMDk6MDA6MDBaIiwiZGVzdGluYXRpb24iOnsiY2l0eSI6Ikxpc2JvbiIsImNvdW50cnlDb2RlIjoiUFQifSwiaG90ZWwiOnsibmFtZSI6IkV4YW1wbGUgTGlzYm9uIEhvdGVsIiwiY2hlY2tJbkxvY2FsIjoiMjAyNi0xMi0xMVQxNTowMDowMCIsImNoZWNrT3V0TG9jYWwiOiIyMDI2LTEyLTE3VDExOjAwOjAwIn19

https://app.voyani.com/ota/open?t=eyJ2IjoxLCJwYXJ0bmVyUmVmZXJyYWxJZCI6Ik9UQS03SzNRWjlNMlhBIiwiYm9va2luZ1JlZmVyZW5jZSI6IkhYODgyMTMiLCJib29raW5nVHlwZSI6ImhvdGVsIiwicmVmZXJyZWRBdCI6IjIwMjYtMTEtMDZUMDk6MDA6MDBaIiwiZGVzdGluYXRpb24iOnsiY2l0eSI6Ikxpc2JvbiIsImNvdW50cnlDb2RlIjoiUFQifSwiaG90ZWwiOnsibmFtZSI6IkV4YW1wbGUgTGlzYm9uIEhvdGVsIiwiY2hlY2tJbkxvY2FsIjoiMjAyNi0xMi0xMVQxNTowMDowMCIsImNoZWNrT3V0TG9jYWwiOiIyMDI2LTEyLTE3VDExOjAwOjAwIn19

Booking types

bookingType tells Voyani what you booked: flight with flightSegments, or hotel with hotel. One link carries one booking, and both types share the same required fields and rules.

• FlightDraft specOne flight booking and its segments, with bookingType set to flight.
• HotelDraft specOne hotel stay, with bookingType set to hotel.

{
  "v": 1,
  "partnerReferralId": "OTA-7K3QZ9M2XA",
  "bookingReference": "AB12CD",
  "bookingType": "flight",
  "referredAt": "2026-10-24T14:22:10Z",
  "destination": {
    "city": "Lisbon",
    "countryCode": "PT",
    "airportCode": "LIS"
  },
  "flightSegments": [
    {
      "carrier": "TP",
      "flightNumber": "204",
      "originIata": "JFK",
      "destinationIata": "LIS",
      "departsAtLocal": "2026-12-10T19:05:00",
      "arrivesAtLocal": "2026-12-11T07:00:00",
      "isReturn": false
    },
    {
      "carrier": "TP",
      "flightNumber": "209",
      "originIata": "LIS",
      "destinationIata": "JFK",
      "departsAtLocal": "2026-12-17T11:30:00",
      "arrivesAtLocal": "2026-12-17T14:45:00",
      "isReturn": true
    }
  ]
}

{
  "v": 1,
  "partnerReferralId": "OTA-7K3QZ9M2XA",
  "bookingReference": "HX88213",
  "bookingType": "hotel",
  "referredAt": "2026-11-06T09:00:00Z",
  "destination": {
    "city": "Lisbon",
    "countryCode": "PT"
  },
  "hotel": {
    "name": "Example Lisbon Hotel",
    "checkInLocal": "2026-12-11T15:00:00",
    "checkOutLocal": "2026-12-17T11:00:00"
  }
}

{
  "v": 1,
  "partnerReferralId": "OTA-7K3QZ9M2XA",
  "bookingReference": "HX88213",
  "bookingType": "hotel",
  "referredAt": "2026-11-06T09:00:00Z",
  "destination": {
    "city": "Lisbon",
    "countryCode": "PT"
  },
  "hotel": {
    "name": "Example Lisbon Hotel",
    "checkInLocal": "2026-12-11T15:00:00",
    "checkOutLocal": "2026-12-17T11:00:00",
    "address": "10 Example Street, Lisbon",
    "roomDescription": "Double room, city view"
  },
  "totalAmount": 1240.5,
  "currency": "EUR",
  "traveler": {
    "firstName": "Ana",
    "lastName": "Silva",
    "email": "ana.silva@example.com",
    "phone": "+351910000000"
  },
  "support": {
    "displayName": "Example Travel support",
    "phone": "+18005550100",
    "email": "help@example-travel.com",
    "url": "https://example-travel.com/help"
  }
}

Not in the link

The payload has no field for these. Don't add them.

How Voyani handles the link

• Known fields only. Fields outside this specification are ignored.
• One booking per reference. partnerReferralId plus bookingReference is the dedupe key. Reopening the link, or opening it on another device, never creates a second account, trip or booking.
• Missing or malformed data. Without one of the five required fields the link is refused. Anything else missing still creates the records it can, shown as incomplete. Voyani never invents a value.
• Before login. The traveler sees the destination city only. Booking details appear after they sign in and the booking is bound to their account.
• Binding. The first verified account binds the booking. A different account cannot claim it afterward.

Before you go live

• HTTPS only. It is a universal link, so the app, mobile web and desktop all keep your referral.
• Keep t at 1,500 characters or fewer. Longer values are refused.
• The link stays valid until 10 days after the trip ends, meaning the last flight arrival or the hotel check-out, unless Voyani revokes it.
• Build t as the Base64url-encoded JSON note, one booking per link.