Tickets

Ticket event payloads include shiftLocation, the station where the agent had an open shift when the action was performed. For the full object description (including timeZone, externalId, and other fields), see Shift location (shiftLocation) in the structure documentation.

Events

Action Event name
purchasing a ticket ticket.created
editing a ticket ticket.updated
cancelling a ticket ticket.updated
changing a ticket ticket.updated
moving a ticket ticket.moved
redeeming a ticket from scan ticket.scan.created
redeeming a ticket from backoffice ticket.redemptions.updated (differs in the redemptions array)
unredeeming a ticket from backoffice ticket.redemptions.updated (differs in the redemptions array)
ticket delivered via print, email, etc ticket.delivered
ticket invoice added tickets.invoice.updated

Payload example

{
  "id": "string",
  "attemptId": "string",
  "livemode": "boolean",
  "created": "int",
  "event": "string",
  "data": {
    "fareId": "string",
    "journeyFromId": "string",
    "productType": "string",
    "seat": "string",
    "couponCode": "string",
    "to": "string'",
    "departureTime": "string",
    "departureDatetime": {},
    "ssrs": [],
    "movements": "string",
    "productFamily": "string",
    "currentScansPerDay": {},
    "discounts": "int",
    "displayDiscounts": "int",
    "accountId": "string",
    "manifestDate": {},
    "from": "string",
    "taxes": [
      {
        "value": "int",
        "name": "string",
        "calculated": "int",
        "displayCalculated": "int"
      }
    ],
    "isExpirationDateCalculated": "boolean",
    "shiftNumber": "string",
    "language": "string",
    "email": "string",
    "row": "string",
    "agentId": "string",
    "eventName": "string",
    "firstName": "string",
    "synchEntry": "string",
    "productId": "string",
    "scheduleDisplayName": "string",
    "availableUses": "int",
    "fareClassName": "string",
    "refundId": "string",
    "arrivalDate": {},
    "fromId": "string",
    "journeyPriceVersionId": "string",
    "ticketTypeName": "string",
    "journeyOrder": "int",
    "comments": "string",
    "status": "string",
    "createdBy": "string",
    "updatedBy": "string",
    "extra": {},
    "bagsWeight": "int",
    "numOfBags": "int",
    "journeyTo": "Bend'",
    "toId": "string",
    "productLine": "",
    "customerNumber": "string",
    "fareClassId": "",
    "sectionName": "",
    "paxWeight": "int",
    "_id": "string",
    "rounding": {
      "policy": "string",
      "decimals": "string"
    },
    "expirationDate": {
      "value": "string",
      "offset": "int"
    },
    "userComments": "string",
    "journeyPriceId": "string",
    "transactionId": "string",
    "journeyToId": "string",
    "agentUserName": "string",
    "channel": "string",
    "agencyId": "string",
    "brandId": "string",
    "price": "int",
    "displayPrice": "int",
    "priceWithTaxes": "int",
    "displayPriceWithTaxes": "int",
    "taxablePrice": "int",
    "displayTaxablePrice": "int",
    "nonTaxablePrice": "int",
    "displayNonTaxablePrice": "int",
    "displayCurrency": {
      "buy": "float",
      "sell": "float",
      "isocode": "string",
      "symbol": "string"
    },
    "brandName": "string",
    "cancellable": "boolean",
    "fare": "string",
    "createdByUserEmail": "string",
    "redemptions": [],
    "gate": "string",
    "seatId": "string",
    "shiftLocation": {
      "stationId": "string",
      "name": "string",
      "country": "string",
      "province": "string",
      "shortcode": "string",
      "latitude": "string",
      "longitude": "string",
      "costCenter": "string",
      "operatingCompanyId": "string",
      "operatingCompanyName": "string",
      "locationPurchaseLimits": {},
      "primaryCurrencyCode": "string",
      "acceptedCurrencies": [],
      "externalId": "string",
      "timeZone": "string"
    },
    "expire": "int",
    "fees": [],
    "totalTaxes": "int",
    "displayTotalTaxes": "int",
    "ticketType": "string",
    "journeyId": "string",
    "trxId": "string",
    "fareClassTerms": "string",
    "ticketNumber": "string",
    "routeId": "string",
    "year": "int",
    "section": "string",
    "userId": "string",
    "month": "int",
    "tripIds": [],
    "lastName": "string",
    "journeyFrom": "string",
    "changeable": "boolean",
    "scans": [],
    "promo": {},
    "total": "int",
    "displayTotal": "int",
    "shiftId": "string",
    "agencyName": "string",
    "totalUses": "int",
    "refId": "string",
    "schedule": "string",
    "overridesChangeFees": [],
    "totalForTransaction": "int",
    "displayTotalForTransaction": "int",
    "deleted": "boolean",
    "createdAt": {
      "value": "string",
      "offset": "int"
    },
    "updatedAt": {
      "value": "string",
      "offset": "int"
    },
    "qrCodeString": "string"
  }
}

Payload example invoice added

{
  "attemptId": "2c73f050-e59f-4810-99ce-7b2d948f7933",
  "created": 1771531653,
  "data": {
    "productExpirationDate": {
      "offset": 0,
      "value": "2026-02-20T00:00:01.000Z"
    },
    "pricesIncludeTaxes": true,
    "seatCol": 1,
    "fareClassName": "Standard",
    "accountId": "6601f1d64f95b505b8bb42e2",
    "journeyTo": "ACAPULCO COSTERA",
    "eventName": "One way",
    "travelDate": {
      "offset": 0,
      "value": "2026-02-19T19:45:00.000Z"
    },
    "comments": "",
    "id": "e64c0ce3-3171-4219-8c85-2c1bab1cc48c",
    "invoiceData": {
      "amount": 68,
      "currency": "USD",
      "invoiceId": "000001020"
    },
    "originalTicketNumber": "GHRBDF",
    "displayTotal": 80000000,
    "dynamicFormId": null,
    "journeyToId": "661017a80294430529380813",
    "associatedSoldItemIds": [],
    "subDomain": "",
    "travellerCardId": "",
    "departureDatetime": {
      "offset": 0,
      "value": "2026-02-19T19:45:00.000Z"
    },
    "journeyFromId": "661026d0029443052938083e",
    "checkInInfo": {
      "passengerInfoId": "",
      "status": ""
    },
    "createdBy": "68277de6b1cf7e05336f0045",
    "revenueOperatingCompany": {
      "id": "661595e438a6280519caf7b9",
      "name": "Estrella de Oro SA de CV"
    },
    "changedFromTicketId": null,
    "status": "paid",
    "deleted": false,
    "taxExceptionReason": null,
    "redemptionValue": 80000000,
    "couponCode": "",
    "fees": [],
    "isExpirationDateCalculated": false,
    "overridesChangeFees": [],
    "nonTaxablePrice": 0,
    "commission": 0,
    "channel": "callcenter",
    "departureTime": "19:45",
    "expirationDate": {
      "offset": 0,
      "value": "2026-02-19T00:00:00.000Z"
    },
    "departureTimestamp": "2026-02-20T01:45:00.000Z",
    "scheduleDisplayName": "MEX-ACA EJE",
    "accountCountry": "MX",
    "displayTotalForTransaction": 68966000,
    "routeId": "6620a13f6c706e052091619d",
    "ratios": [
      {
        "acceptedCurrency": {
          "buy": 1,
          "channels": [
            "backoffice",
            "agency-backoffice",
            "websales",
            "agency-websales"
          ],
          "isocode": "MXN",
          "sell": 1,
          "symbol": "$"
        },
        "currencyCode": "MXN",
        "displayTotal": 80000000,
        "extraInfo": null,
        "total": 80000000,
        "type": "pay_on_account2"
      }
    ],
    "totalUses": 1,
    "travellerCardNumber": "",
    "toId": "661017a80294430529380813",
    "discounts": 0,
    "journeyPriceId": "6834b05bd79d8d051bfc485d",
    "messages": [],
    "displayPriceWithTaxes": 80000000,
    "ticketNumber": "GHRBDF",
    "sectionName": "Main",
    "redeemableItem": null,
    "peopleLookupId": null,
    "loyaltyPointsToAccumulate": 0,
    "createdByUserEmail": "sandembus@betterez.com",
    "ticketTypeName": "One way",
    "movedByIROP": false,
    "_id": "69976b9c6d8436075927eebc",
    "schedule": "b324527e-ca7d-4f2a-ba8f-2e76cb57ee37",
    "agencyId": "",
    "displayTotalTaxes": 11034000,
    "to": "ACAPULCO COSTERA",
    "loyaltyPointsForRedemption": 0,
    "redemptions": [],
    "notifications": {
      "sms": {
        "trip": false
      }
    },
    "seatClassName": null,
    "paymentRates": [
      {
        "displayTotal": 80000000,
        "itemDisplayId": "GHRBDF",
        "itemId": "69976b9c6d8436075927eebc",
        "rates": [
          {
            "acceptedCurrencyCode": "MXN",
            "ratio": "100.00",
            "type": "pay_on_account2"
          }
        ],
        "total": 80000000
      }
    ],
    "extraInput": "",
    "operatingCompanyInfoOnPrintedTicket": "Camionera del Golfo SA de CV",
    "crossBorderTaxation": false,
    "language": "en-us",
    "userComments": [],
    "operatingCompanyId": "66209ddc975b3e04fc3ed9d6",
    "redeemableItemId": null,
    "fareClassTerms": "Standard terms and conditions",
    "fare": "ADULT",
    "travelDistance": null,
    "crossBorderTaxationBasic": false,
    "totalTaxes": 11034000,
    "seat": "1",
    "documentNumber": null,
    "taxableDiscounts": 0,
    "seatId": "section-661dbc18f7bf0f0515eb2ac6-row-2-seat-1",
    "loyaltyPointsToPay": null,
    "travellerCardName": "",
    "updatedAt": {
      "offset": 0,
      "value": "2026-02-19T20:06:53.575Z"
    },
    "totalForTransaction": 68966000,
    "refundHistory": [],
    "operatingCompanyName": "Camionera del Golfo SA de CV",
    "rounding": {
      "policy": ""
    },
    "manifestDate": {
      "offset": 0,
      "value": "2026-02-19T00:00:00.000Z"
    },
    "seatRow": "2",
    "fareClassId": "6615ab2a7d3295051fdc1f23",
    "availableUses": 1,
    "updatedBy": "68277de6b1cf7e05336f0045",
    "loyaltyPointsForRefund": 0,
    "phone": "",
    "lastName": "Dosa",
    "firstName": "Cld",
    "userId": "68277de6b1cf7e05336f0045",
    "row": "1",
    "createdOnBehalfOfUser": {},
    "trxId": "69976b9c6d8436075927eebb",
    "priceWithTaxes": 80000000,
    "originShortCode": "M5DM",
    "journeyFrom": "MEXICO TAXQUENA",
    "price": 68966000,
    "from": "MEXICO TAXQUENA",
    "refundId": "",
    "agentId": "",
    "shiftId": "68e7ccfbe0f97e065ce0cc59",
    "customerNumber": "501-932-014",
    "createdAt": {
      "offset": 0,
      "value": "2026-02-19T19:59:24.840Z"
    },
    "extra": {
      "folios": [],
      "gender": "female",
      "phone": "12345678"
    },
    "journeyPriceVersionId": "697b9f9a643d3405c9ac3df0",
    "journeyId": "afcbf7ee-438d-4156-81be-73a8f9c6e7de",
    "paxWeight": 0,
    "changeable": true,
    "brandName": "Pluss",
    "fareId": "66159dac38a6280519caf7be",
    "synchEntry": "",
    "loyaltyAmountToPay": null,
    "journeyOrder": 0,
    "arrivalDate": {
      "offset": 0,
      "value": "2026-02-20T00:56:00.000Z"
    },
    "agentUserName": "",
    "createdFromFlexpassId": null,
    "invoiced": true,
    "numOfBags": 0,
    "total": 80000000,
    "amenityGroupId": "661db7a3f7bf0f0515eb2ac4",
    "productFamily": "reservation",
    "redeemedOnBrand": "",
    "documentTypeId": null,
    "section": "661dbc18f7bf0f0515eb2ac6",
    "displayDiscounts": 0,
    "gate": "",
    "applyCrossBorderTaxesInAllCountries": false,
    "productType": "reservation",
    "shiftLocation": {
      "acceptedCurrencies": [
        "MXN"
      ],
      "costCenter": "2100153",
      "country": "MX",
      "externalId": "",
      "latitude": "16.8636752",
      "locationPurchaseLimits": {},
      "longitude": "-99.8878212",
      "name": "ACAPULCO COSTERA",
      "operatingCompanyId": "",
      "operatingCompanyName": "",
      "primaryCurrencyCode": "MXN",
      "province": "Guerrero",
      "shortcode": "ACGM",
      "stationId": "661017a80294430529380813"
    },
    "seatClassId": null,
    "email": "sandembus@betterez.com",
    "agencyName": "",
    "shiftNumber": "S-T3U99PX",
    "notCancellableBecause": [
      "PAYMENT_METHOD_NOT_CANCELLABLE"
    ],
    "associatedRoundtripTicket": {},
    "transactionId": "TS752HDK",
    "expire": 0,
    "taxes": [
      {
        "calculated": 11034000,
        "displayCalculated": 11034000,
        "isBorder": false,
        "name": "IVA",
        "province": "all",
        "value": 16000
      }
    ],
    "movedByIROPTicketIds": [],
    "destinationShortCode": "ACGM",
    "displayPrice": 68966000,
    "promo": {},
    "displayNonTaxablePrice": 0,
    "regularPrice": 80000000,
    "taxExempted": false,
    "cancellable": false,
    "taxablePrice": 68966000,
    "refId": "",
    "productId": "6601f1d64f95b505b8eb42e7",
    "expireUnit": "days",
    "generatedFromIROPTicketId": "",
    "ssrs": [],
    "taxablePercentage": 100000,
    "seatMapId": "662098f35c0d9504fd259abc",
    "defaultCountry": null,
    "displayCurrency": {
      "buy": 1,
      "isocode": "MXN",
      "sell": 1,
      "symbol": "$"
    },
    "brandId": "661595307d3295051fdc1f1b",
    "arrivalTimestamp": "2026-02-20T06:56:00.000Z",
    "openReturn": false,
    "nationality": "",
    "fromId": "661026d0029443052938083e",
    "isMinor": false,
    "syncEntryId": null,
    "promos": [],
    "productLine": "",
    "standing": false,
    "cutOffDateTime": {
      "offset": 0,
      "value": "2026-02-20T02:13:00.000Z"
    },
    "dob": null,
    "displayTaxablePrice": 68966000,
    "ticketType": "oneway",
    "movements": "",
    "travellerCardExpirationDate": "",
    "displayCommission": 0
  },
  "event": "tickets.invoice.updated",
  "id": "192aec0a-ccd3-4a86-b8fd-c558fd355d53",
  "livemode": false
}