Skip to content

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.

Benefits
Benefit
Description
Reduced interchange feesIf 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 detectionDetailed transaction data allows card networks to better authenticate purchases, reducing fraud and chargeback rates.
Improved dispute managementWith 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 satisfactionProviding 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 standardsCard networks increasingly require detailed data in specific industries, like hotels, to maintain compliance with industry standards and processing requirements.

Parameters

typestringrequired
Value"lodging"
folioNumberstring[ 1 .. 25 ] characters^[A-Za-z0-9 @!£*#$()+=._,\/;:'"-]{1,25}$required

Customer folio number, invoice number or billing ID number.

Example: "INV-12345-A"
checkInDateobjectrequired

An object containing the check in date.

checkInDate.​dayintegerrequired
checkInDate.​monthintegerrequired
checkInDate.​yearintegerrequired
checkOutDateobjectrequired

An object containing the check out date.

checkOutDate.​dayintegerrequired
checkOutDate.​monthintegerrequired
checkOutDate.​yearintegerrequired
numberOfNightsinteger[ 0 .. 99 ]required

Total number of nights the room is booked for.

Example: 3
roomRateinteger>= 0required

The rate for the room in minor currency units (e.g., pence for GBP).

Example: 6000
roomTaxinteger>= 0

Total room tax in minor currency units (e.g., pence for GBP).

Example: 900
adultGuestsinteger[ 0 .. 99 ]

Total number of adult guests.

Example: 2
programCodestring

Charge type for the billing purpose.

Enum"lodging""noShow""advancedDeposit"
customerServicePhonestring[ 1 .. 17 ] characters^[0-9 ()+\-\/.x]{1,17}$

The toll-free phone number for the facility.

Example: "08001233644669"
propertyLocalPhonestring[ 1 .. 17 ] characters^[0-9 ()+\-\/.x]{1,17}$

The lodging property's phone number.

Example: "08001233644669"
fireSafetyIndicatorboolean

Identifies that the facility complies with the Hotel and Motel Fire Safety Act of 1990.

Example: true
renterNamestring[ 1 .. 26 ] characters^[A-Za-z0-9 @!£*#$()+=._,\/;:'"-]{1,26}$

Name of the person or business entity charged for the reservation.

Example: "John Smith"
additionalChargesArray of objects<= 6 items

Array for the additional charges associated with the booking.

Request example

{
    "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
            }
        ]
    }
}