# Submit lodging data

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.

---

## Prerequisites

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.

---

## Send enhanced lodging data

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.

### Request example

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

```json
{
  "amount": 40000,
  "currency": "USD",
  "processing": {
    "tax_amount": 4000,
    "accommodation_data": {
      "booking_reference": "RES12345",
      "check_in_date": "260216",
      "check_out_date": "260218",
      "number_of_nights_at_room_rate": 2,
      "room": {
        "rate": 18000
      },
      "property_phone": {
        "country_code": "1",
        "number": "5551234567"
      },
      "customer_service_phone": {
        "country_code": "1",
        "number": "8005554567"
      }
    }
  }
}
```

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

All monetary amounts must be in [minor currency units](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md). For example, USD 400.00 is `40000`.