Submit lodging data

Last updated: April 15, 2026

Send lodging data for United States domestic transactions with commercial or consumer cards to optimize your interchange rates.

If your business operates under travel-related Merchant Category Codes (MCCs), you can provide enhanced scheme data to qualify for preferential interchange rates. Lodging data consists of industry-specific details such as check-in dates and booking references.

Checkout.com supports sending lodging data for MCC 7011 (Lodging – hotels, motels, and resorts) for both Mastercard and Visa.

Lodging data is supported for:

Online travel agencies and travel aggregators registered under MCC 7011.
Transactions using commercial and consumer cards.

You must provide the lodging-specific data in your authorization or initial payment request. Capture the payment within 2 days of the initial authorization to ensure the enhanced data is processed correctly by the schemes.

Note

Lodging data is not supported in capture requests. You must provide all lodging-specific fields in the initial payment or authorization request.

Provide the required lodging data in the processing.accommodation_data object and the processing.tax_amount field:


1{
2  "amount": 40000,
3  "currency": "USD",
4  "processing": {
5    "tax_amount": 4000,
6    "accommodation_data": {
7      "booking_reference": "RES12345",
8      "check_in_date": "260216",
9      "check_out_date": "260218",
10      "number_of_nights_at_room_rate": 2,
11      "room": {
12        "rate": 18000
13      },
14      "property_phone": {
15        "country_code": "1",
16        "number": "5551234567"
17      },
18      "customer_service_phone": {
19        "country_code": "1",
20        "number": "8005554567"
21      }
22    }
23  }
24}

Field name Description

Field name	Description
`processing.accommodation_data.booking_reference` string	The property's folio or invoice number. Required Maximum – 10 characters.
`processing.accommodation_data.check_in_date` string	The guest's check-in date. Required Standard – ISO 8601 code Format – `YYYYMMDD`
`processing.accommodation_data.check_out_date` string	The guest's check-out date. Required Standard – ISO 8601 code Format – `YYYYMMDD`
`processing.accommodation_data.customer_service_phone.number` string	The toll-free customer service phone number. Required Numbers only. Maximum – 10 digits.
`processing.accommodation_data.number_of_nights_at_room_rate` string	The number of nights at the specified room rate. Required Numbers only. Maximum – 2 digits
`processing.accommodation_data.property_phone.number` string	The local phone number of the property. Required Numbers only. Maximum – 10 digits.
`processing.accommodation_data.room.rate` string	The daily charge excluding taxes and fees. Required Ensure this amount is in the same currency as the transaction amount. Numbers only. Maximum – 12 digits
`processing.tax_amount` number	The total tax amount for the stay. Required Ensure this amount is in the same currency as the transaction amount. Maximum – 12 digits

processing.accommodation_data.booking_reference

string

The property's folio or invoice number.
Required

Maximum – 10 characters.

processing.accommodation_data.check_in_date

string

The guest's check-in date.
Required

Standard – ISO 8601 code
Format – YYYYMMDD

processing.accommodation_data.check_out_date

string

The guest's check-out date.
Required

Standard – ISO 8601 code
Format – YYYYMMDD

processing.accommodation_data.customer_service_phone.number

string

The toll-free customer service phone number.
Required

Numbers only.
Maximum – 10 digits.

processing.accommodation_data.number_of_nights_at_room_rate

string

The number of nights at the specified room rate.
Required

Numbers only.
Maximum – 2 digits

processing.accommodation_data.property_phone.number

string

The local phone number of the property.
Required

Numbers only.
Maximum – 10 digits.

processing.accommodation_data.room.rate

string

The daily charge excluding taxes and fees.
Required

Ensure this amount is in the same currency as the transaction amount.

Numbers only.
Maximum – 12 digits

processing.tax_amount

number

The total tax amount for the stay.
Required

Ensure this amount is in the same currency as the transaction amount.

Maximum – 12 digits

All monetary amounts must be in minor currency units. For example, USD 400.00 is 40000.

Submit lodging data

Prerequisites

Send enhanced lodging data

Note

Request example