🚧

This feature is in 'alpha' and not yet publicly available. The information below and in subpages is subject to change as specifications are finalized.

Introduction

Lodging Data is a category of L2/ L3 data provided by the card payment networks for certain transactions. It is available for transactions made in which:

• The card transacting is an eligible* commercial card, enrolled through applicable commercial card enrollment mechanisms as defined by Astrada
• The transaction is made with a merchant in a lodging or lodging-adjacent category and the merchant of record participates in L2/L3 data sharing and has appended this data

This page provides information on the structure and format of Lodging data and how you can access it.

*eligibility for Mastercard cards can be determined using our BIN Lookup functionality.

Lodging Data Resource

JSON

The below object is an example of how the lodging enrichment data for a hotel may look, however please note that data enrichment is in active development and as such, changes might occur before the final version is confirmed.

{
  "id": "d3221e18-dcab-4da9-90e4-762bdffd0cf6",
  "property": {
    "Name": "ASTRADA HOTEL",
    "Country": "GBR"
  },
  "checkInDate": "2023-10-06",
  "checkOutDate": "2023-08-08",
  "totalAmount": {
    "amount": 1095.13,
    "currency": "GBP"
  },
  "totalTax": {
    "amount": 95.28,
    "currency": "GBP"
  },
  "charges": [
    {
      "chargeType": "Room",
      "lodgingNights": 4,
      "perUnitAmount": {
        "amount": 689,
        "currency": "GBP"
      },
      "perUnitTax": {
        "amount": 23.82,
        "currency": "GBP"
      }
    },
    {
      "chargeType": "Other",
      "units": 1,
      "perUnitAmount": {
        "amount": 30,
        "currency": "GBP"
      },
      "perUnitTax": {
        "amount": 3,
        "currency": "GBP"
      }
    }
  ]
}

Webhook events

Applicable webhook events:

Learn more about Webhooks.

API

Astrada is planning to provide the following endpoints to retrieve Lodging Data:

GET /transaction-messages/{transactionMessageId}/lodgings
Returns a list of available lodgings data resources for a transaction message.

GET /transaction-messages/{transactionMessageId}/lodgings/{lodgingId}
Returns lodging data for a specific transaction message.