The following illustrates the use of extensions in GO to accommodate different business purposes

Please note that the usage of extension fields must be pre‑negotiated with the supplier to ensure it functions well.


KeyDescriptionExample
GUEST_NATIONALITYUsed by Distributor in Live Check and Reservations to get rate based on the code of guest nationality passed to the Supplier.

Follow the ISO 2 Code standard for the value format, as indicated in https://www.iban.com/country-codes.

{

    "header": {

        "supplierId": "ABC",

        "distributorId": "XYZ",

        "version": "v4.9.8",

        "token": "1778657584322"

    },

    "stayRange": {

        "checkin": "2026-06-19",

        "checkout": "2026-06-20"

    },

    "roomCriteria": {

        "roomCount": 1,

        "adultCount": 1,

        "childCount": 0,

        "childAges": []

    },

    "hotelId": "164-482208",

    "extensions": {

        "GUEST_NATIONALITY": "CN"

    }

}

loyaltyProgram
loyaltyAccountId
Used by Distributor to pass the guest's loyalty information with the Supplier via @extensions under @guests in Reservations.
  • loyaltyProgram: Communicates the name/code of the loyalty program.
  • loyaltyAccountld: Communicates the loyalty membership lD.

Note: Use @index if multiple loyalty accounts need to be passed.


{

  "guests": [

    {

      "firstName": "Thomas",

      "lastName": "Hintz",

      "email": "Thomas.Hintz@yahoo.com",

      "phone": "260-975-4091",

      "address": "3946 Freddy Locks",

      "age": 32,

      "gender": "Male",

      "birthday": "1994-01-01",

      "type": "Adult",

      "index": 1,

      "extensions": {

        "loyaltyProgram": "XX",

        "loyaltyAccountId": "123456789"

      }

    },

    {

      "firstName": "Lucy",

      "lastName": "Hintz",

      "email": "Lucy.Hintz@gmail.com",

      "phone": "543-563-4345",

      "address": "3946 Freddy Locks",

      "age": 36,

      "gender": "Female",

      "birthday": "1990-03-21",

      "type": "Adult",

      "index": 2,

      "extensions": {

        "loyaltyProgram": "XX",

        "loyaltyAccountId": "987654321"

      }

    }

  ]

}

ID_CARD
PASSPORT
MTP
TAIWAN_PASS
HONGKONG_MACAO_PASS
HOME_RETURN_CERTIFICAT

Used by Distributor to pass the guest's citizen ID information in the Reservations to the Supplier.

"guests": [

{

"firstName": "Thomas",

"lastName": "Hintz",

"extensions": {

"ID_CARD" : "ABCD1234"

  }

"email": "Thomas.Hintz@yahoo.com",

"phone": "260-975-4091",

"address": "3946 Freddy Locks",

"age": 32,

"gender": "Male",

"birthday": "1994-01-01",

"type": "Adult",

"index": 1

}