# Lodging data

Achieve several cost and efficiency benefits when supplying detailed lodging data. You can submit these additional details in either the authorization or settlement requests, or both.

Note
Any data you submit in the settlement overwrites data submitted in the authorization request.

details
summary
b
Benefits
| Benefit | Description |
|  --- | --- |
| **Reduced interchange fees** | If you are a lodging merchant you can qualify for lower interchange fees on transactions by providing lodging-specific data, such as check-in dates, length of stay, and guest information. Card networks often offer lower rates for transactions with enhanced data, reducing processing costs. |
| **Enhanced fraud detection** | Detailed transaction data allows card networks to better authenticate purchases, reducing fraud and chargeback rates. |
| **Improved dispute management** | With comprehensive transaction details, card networks can better handle and resolve disputes. This reduces the time and effort you spend managing chargebacks and can lead to faster resolutions. |
| **Increased customer trust and satisfaction** | Providing enhanced data improves transaction transparency, giving customers more confidence in their purchases. It also leads to more accurate transaction records on your customer's statements, minimizing confusion or disputes. |
| **Compliance with industry standards** | Card networks increasingly require detailed data in specific industries, like hotels, to maintain compliance with industry standards and processing requirements. |


## Parameters

```json
{
  "$ref": "#/components/schemas/industryData_lodging",
  "components": {
    "schemas": {
      "industryData_lodging": {
        "type": "object",
        "required": [
          "type",
          "folioNumber",
          "checkInDate",
          "checkOutDate",
          "numberOfNights",
          "roomRate"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "lodging"
            ]
          },
          "folioNumber": {
            "type": "string",
            "description": "Customer folio number, invoice number or billing ID number.",
            "minLength": 1,
            "maxLength": 25,
            "pattern": "^[A-Za-z0-9 @!£*#$()+=._,\\/;:'\"-]{1,25}$",
            "example": "INV-12345-A"
          },
          "checkInDate": {
            "type": "object",
            "description": "An object containing the check in date.",
            "properties": {
              "day": {
                "type": "integer"
              },
              "month": {
                "type": "integer"
              },
              "year": {
                "type": "integer"
              }
            },
            "required": [
              "day",
              "month",
              "year"
            ]
          },
          "checkOutDate": {
            "type": "object",
            "description": "An object containing the check out date.",
            "properties": {
              "day": {
                "type": "integer"
              },
              "month": {
                "type": "integer"
              },
              "year": {
                "type": "integer"
              }
            },
            "required": [
              "day",
              "month",
              "year"
            ]
          },
          "numberOfNights": {
            "type": "integer",
            "description": "Total number of nights the room is booked for.",
            "minimum": 0,
            "maximum": 99,
            "example": 3
          },
          "roomRate": {
            "type": "integer",
            "description": "The rate for the room in minor currency units (e.g., pence for GBP).",
            "minimum": 0,
            "example": 6000
          },
          "roomTax": {
            "type": "integer",
            "description": "Total room tax in minor currency units (e.g., pence for GBP).",
            "minimum": 0,
            "example": 900
          },
          "adultGuests": {
            "type": "integer",
            "description": "Total number of adult guests.",
            "minimum": 0,
            "maximum": 99,
            "example": 2
          },
          "programCode": {
            "type": "string",
            "description": "Charge type for the billing purpose.",
            "enum": [
              "lodging",
              "noShow",
              "advancedDeposit"
            ]
          },
          "customerServicePhone": {
            "type": "string",
            "description": "The toll-free phone number for the facility.",
            "minLength": 1,
            "maxLength": 17,
            "pattern": "^[0-9 ()+\\-\\/.x]{1,17}$",
            "example": "08001233644669"
          },
          "propertyLocalPhone": {
            "type": "string",
            "description": "The lodging property's phone number.",
            "minLength": 1,
            "maxLength": 17,
            "pattern": "^[0-9 ()+\\-\\/.x]{1,17}$",
            "example": "08001233644669"
          },
          "fireSafetyIndicator": {
            "type": "boolean",
            "description": "Identifies that the facility complies with the Hotel and Motel Fire Safety Act of 1990.",
            "example": true
          },
          "renterName": {
            "type": "string",
            "description": "Name of the person or business entity charged for the reservation.",
            "minLength": 1,
            "maxLength": 26,
            "pattern": "^[A-Za-z0-9 @!£*#$()+=._,\\/;:'\"-]{1,26}$",
            "example": "John Smith"
          },
          "additionalCharges": {
            "type": "array",
            "description": "Array for the additional charges associated with the booking.",
            "maxItems": 6,
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "Type of lodging charge",
                  "enum": [
                    "barberBeautySalon",
                    "businessCentre",
                    "cancellationAdjustment",
                    "chargesAfterCheckout",
                    "convenience",
                    "convention",
                    "discount",
                    "folioCashAdvances",
                    "foodBeverages",
                    "giftShop",
                    "goodsServices",
                    "healthClub",
                    "insurancePurchased",
                    "internetService",
                    "laundry",
                    "meetingConference",
                    "miniBar",
                    "movie",
                    "noShow",
                    "occupancyTax",
                    "other",
                    "parking",
                    "pet",
                    "prepaidExpenses",
                    "proShop",
                    "restaurant",
                    "rewardProgramTransaction",
                    "surcharge",
                    "telephone",
                    "tipGratuity",
                    "tours",
                    "valetParking"
                  ]
                },
                "amount": {
                  "type": "integer",
                  "description": "Amount for the charge type in minor currency units (e.g., pence for GBP).",
                  "minimum": 0,
                  "example": 4500
                }
              },
              "required": [
                "type",
                "amount"
              ]
            }
          }
        }
      }
    }
  }
}
```

## Request example

```json
{
    "industryData": {
        "type": "lodging",
        "folioNumber": "12345678901234567",
        "checkInDate": {
            "day": 14,
            "month": 3,
            "year": 2025
        },
        "checkOutDate": {
            "day": 17,
            "month": 3,
            "year": 2025
        },
        "numberOfNights": 3,
        "roomRate": 6000,
        "roomTax": 900,
        "adultGuests": 2,
        "customerServicePhone": "08001233644669",
        "propertyLocalPhone": "08001233644669",
        "fireSafetyIndicator": true,
        "programCode": "lodging",
        "renterName": "John Smith",
        "additionalCharges": [
            {
                "type": "miniBar",
                "amount": 4500
            },
            {
                "type": "laundry",
                "amount": 1500
            }
        ]
    }
}
```