Menu

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>.


ElementTypeSizeDescription
<lodging>
<hotelFolioNumber>PCDATA1-17Your customer folio number.
<checkInDate><date>dayOfMonth, month and yearThe date the guest plans to check in to the facility.
<checkOutDate><date>dayOfMonth, month and yearThe date the guest plans to checkout of the facility.
<duration>PCDATA1-4The number of nights the guest stays at the facility.
<customerServicePhone>PCDATA1-17Toll free customer service phone number for the facility.
<programCode>PCDATALODGING, NOSHOW or ADVANCEDDEPOSITCharge type.
<roomRate><amount>value, exponent and currencyCodePer day room rate excluding taxes and fees.
<roomTax><amount>value, exponent and currencyCodePer day room tax.
<numAdults>PCDATA1-2Total number of adult guests staying at the facility.
<propertyLocalPhone>PCDATA1-17Local phone number for the facility.
<fireSafetyIndicator>PCDATAtrue or falseDefines 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>