Lodging data

The benefits of providing Lodging data are:

Lower interchange fees
Commercial customers can gain greater insight into their spending

Note: Lodging data is only available to customers using MCC 7011. For more information please contact your Relationship Manager.

Data requirements

The table below defines the Lodging data requirements which is supplied in <lodging> which is a child of <branchSpecificExtension>.

Element	Type	Size	Description
`<lodging>`
`<hotelFolioNumber>`	PCDATA	1-17	Your customer folio number.
`<checkInDate>`	`<date>`	dayOfMonth, month and year	The date the guest plans to check in to the facility.
`<checkOutDate>`	`<date>`	dayOfMonth, month and year	The date the guest plans to checkout of the facility.
`<duration>`	PCDATA	1-4	The number of nights the guest stays at the facility.
`<customerServicePhone>`	PCDATA	1-17	Toll free customer service phone number for the facility.
`<programCode>`	PCDATA	LODGING, NOSHOW or ADVANCEDDEPOSIT	Charge type.
`<roomRate>`	`<amount>`	value, exponent and currencyCode	Per day room rate excluding taxes and fees.
`<roomTax>`	`<amount>`	value, exponent and currencyCode	Per day room tax.
`<numAdults>`	PCDATA	1-2	Total number of adult guests staying at the facility.
`<propertyLocalPhone>`	PCDATA	1-17	Local phone number for the facility.
`<fireSafetyIndicator>`	PCDATA	true or false	Defines if the facility conforms to the Hotel and Motel Fire Safety Act of 1990 or similar legislation.
`<lodgingCharge>`	`<chargeType>`	RESTAURANT, GIFTSHOP, MINIBAR, TELEPHONE, LAUNDRY and OTHER	Note: Maximum of 6 charge types can be submitted

Sample API

Copied!

<branchSpecificExtension>
    <lodging>
        <hotelFolioNumber>43543535345435</hotelFolioNumber>
        <checkInDate>
            <date dayOfMonth="01" month="06" year="2019"/>
        </checkInDate>
        <checkOutDate >
            <date dayOfMonth="10" month="06" year="2019"/>
        </checkOutDate >
        <duration>9</duration> 
        <customerServicePhone>08001233644669</customerServicePhone>
        <programCode>LODGING</programCode>
        <roomRate>
            <amount value="200" currencyCode="USD" exponent="2"/>
        </roomRate>
        <roomTax>
            <amount value="200" currencyCode="USD" exponent="2"/>
        </roomTax>
        <numAdults>2</numAdults> 
        <propertyLocalPhone>08001233644669</propertyLocalPhone>
        <fireSafetyIndicator>true</fireSafetyIndicator>
        <lodgingCharge>
            <chargeType>RESTAURANT</chargeType>
        </lodgingCharge>
    </lodging>
</branchSpecificExtension>

<branchSpecificExtension> <lodging> <hotelFolioNumber>43543535345435</hotelFolioNumber> <checkInDate> <date dayOfMonth="01" month="06" year="2019"/> </checkInDate> <checkOutDate > <date dayOfMonth="10" month="06" year="2019"/> </checkOutDate > <duration>9</duration> <customerServicePhone>08001233644669</customerServicePhone> <programCode>LODGING</programCode> <roomRate> <amount value="200" currencyCode="USD" exponent="2"/> </roomRate> <roomTax> <amount value="200" currencyCode="USD" exponent="2"/> </roomTax> <numAdults>2</numAdults> <propertyLocalPhone>08001233644669</propertyLocalPhone> <fireSafetyIndicator>true</fireSafetyIndicator> <lodgingCharge> <chargeType>RESTAURANT</chargeType> </lodgingCharge> </lodging> </branchSpecificExtension>

Search our documentation, API references and articles.

Lodging data

Data requirements

Sample API

Within this page

​