---
title: "Lodging data"
description: "Send lodging data for US domestic transactions."
url: "https://docs.adyen.com/payment-methods/cards/enhanced-scheme-data/lodging"
source_url: "https://docs.adyen.com/payment-methods/cards/enhanced-scheme-data/lodging.md"
canonical: "https://docs.adyen.com/payment-methods/cards/enhanced-scheme-data/lodging"
last_modified: "2023-03-09T17:10:00+01:00"
language: "en"
---

# Lodging data

Send lodging data for US domestic transactions.

[View source](/payment-methods/cards/enhanced-scheme-data/lodging.md)

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

You get benefits for transactions, depending on the scheme:

* Visa: prevent downgrades to higher commercial standard rates.
* Mastercard: ensure that your transactions qualify for the interchange rates specific to your industry.

## Requirements

In addition to the [requirements that apply to sending ESD](/payment-methods/cards/enhanced-scheme-data#requirements), take into account the following additional limitations for sending lodging data.

| Requirement     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| --------------- |   |
| **Limitations** | * Your business must operate under an [eligible MCC](#lodging-data-mcc).

* You can only send lodging data for commercial and consumer cards.

* The [Checkout API](https://docs.adyen.com/api-explorer/Checkout/latest/overview) does not support sending lodging data in capture requests. You can send ESD while capturing the payment if you have an existing [Classic API](https://docs.adyen.com/api-explorer/Payment/latest/overview) integration.

* You can send the following car rental data fields only in the payment request:

  * [`travelEntertainmentAuthData.market`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-travelEntertainmentAuthData-market)
  * [`travelEntertainmentAuthData.duration`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-travelEntertainmentAuthData-duration) |

### Eligible MCCs for lodging data

You can send lodging ESD if you have one of the following MCCs:

| MCC       | Description                          | Scheme           |
| --------- | ------------------------------------ | ---------------- |
| 3501-3999 | Hotels/motels                        | Mastercard, Visa |
| 7011      | Lodging - hotels, motels and resorts | Mastercard, Visa |

## How it works

In your payment or capture requests, include the car rental specific data fields. The recommended request depends on your [capture setting](/online-payments/capture#types-of-capture).

* **Automatic capture** and **Delayed automatic capture**: in the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) request, include lodging data in the [additionalData.lodging](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-customerServiceTollFreeNumber) object.
* **Manual capture** (**Single partial capture** and **Multiple partial capture**): in the [/capture](https://docs.adyen.com/api-explorer/Payment/latest/post/capture) request, include lodging data in the [additionalData.enhancedSchemeData.lodging](https://docs.adyen.com/api-explorer/Payment/latest/post/capture#request-additionalData-AdditionalDataLodging) object.

## Send lodging data

Include airline data in the payment or capture request.

* For the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) request: use the [additionalData.lodging](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-checkInDate) object.
* For the [/capture](https://docs.adyen.com/api-explorer/Payment/latest/post/capture) request: use the [additionalData.enhancedSchemeData.lodging](https://docs.adyen.com/api-explorer/Payment/latest/post/capture#request-additionalData-AdditionalDataLodging) object.

| Field                                                                                                                                                                                           | Required                                                                                    |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| [`lodging.checkInDate`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-checkInDate)                                     | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| [`lodging.checkOutDate`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-checkOutDate)                                   | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| [`lodging.folioNumber`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-folioNumber)                                     | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| [`lodging.room[itemNr].rate`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-room1-rate)                                | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| [`lodging.room[itemNr].numberOfNights`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-room1-numberOfNights)            | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| [`lodging.customerServiceTollFreeNumber`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-customerServiceTollFreeNumber) | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| [`lodging.propertyPhoneNumber`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-propertyPhoneNumber)                     | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| [`lodging.totalRoomTax`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-totalRoomTax)                                   |                                                                                             |
| [`lodging.totalTax`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-totalTax)                                           |                                                                                             |
| `lodging.specialProgramCode`                                                                                                                                                                    |                                                                                             |
| [`lodging.fireSafetyActIndicator`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-fireSafetyActIndicator)               |                                                                                             |
| [`lodging.folioCashAdvances`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-folioCashAdvances)                         |                                                                                             |
| [`lodging.foodBeverageCharges`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-foodBeverageCharges)                     |                                                                                             |
| [`lodging.noShowIndicator`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-noShowIndicator)                             |                                                                                             |
| [`lodging.prepaidExpenses`](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataLodging-lodging-prepaidExpenses)                             |                                                                                             |

### Tab: `/payments` endpoint

**Example payment request with lodging data**

```bash
curl https://checkout-test.adyen.com/v72/payments \
-H 'x-API-key: ADYEN_API_KEY' \
-H 'idempotency-key: YOUR_IDEMPOTENCY_KEY' \
-H 'content-type: application/json' \
-X POST
-d '{
  "amount": {
    "currency": "USD",
    "value": 20000
  },
  "reference": "YOUR_ORDER_NUMBER",
  "paymentMethod":{
    "type":"scheme",
    "cvc": "737",
    "expiryMonth": "03",
    "expiryYear": "2030",
    "holderName": "John Smith",
    "number": "4444333322221111"
  },
  "returnUrl": "https://your-company.example.com/...",
  "merchantAccount": "ADYEN_MERCHANT_ACCOUNT",
  "additionalData": {
     "travelEntertainmentAuthData.market":"A",
     "travelEntertainmentAuthData.duration":"1",
     "lodging.customerServiceTollFreeNumber":"8001122334",
     "lodging.checkInDate":"20230312",
     "lodging.checkOutDate":"20230314",
     "lodging.folioNumber":"AB12345",
     "lodging.propertyPhoneNumber":"8001122334",
     "lodging.room1.rate":"50",
     "lodging.room1.tax":"200",
     "lodging.room1.numberOfNights":"2",
     "lodging.totalRoomTax": "400",
     "lodging.fireSafetyActIndicator":"Y",
     "lodging.folioCashAdvances":"100",
     "lodging.foodBeverageCharges":"1000",
     "lodging.noShowIndicator":"Y",
     "lodging.prepaidExpenses":"500"
  }
}'
```

### Tab: `/captures` endpoint

**Example capture request with lodging data**

```bash
curl https://pal-test.adyen.com/pal/servlet/Payment/v72/capture \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'content-type: application/json' \
-X POST
-d '{
   "merchantAccount":"ADYEN_MERCHANT_ACCOUNT",
   "modificationAmount":{
      "currency":"USD",
      "value":20000
   },
   "originalReference":"NC6HT9CRT65ZGN82",
   "additionalData":{
      "lodging.customerServiceTollFreeNumber":"8001122334",
      "lodging.checkInDate":"20230312",
      "lodging.checkOutDate":"20230314",
      "lodging.folioNumber":"AB12345",
      "lodging.propertyPhoneNumber":"8001122334",
      "lodging.room1.rate":"50",
      "lodging.room1.tax":"200",
      "lodging.room1.numberOfNights":"2",
      "lodging.totalRoomTax": "400",
      "lodging.fireSafetyActIndicator":"Y",
      "lodging.folioCashAdvances":"100",
      "lodging.foodBeverageCharges":"1000",
      "lodging.noShowIndicator":"Y",
      "lodging.prepaidExpenses":"500"
   }
}'
```

## Test sending lodging data

Use the following test card to test payments with lodging data:

| Card Number         | Card Type  | Expiry Date | CVV |
| ------------------- | ---------- | ----------- | --- |
| 5555 5555 5555 4444 | Mastercard | 03/2030     | 737 |
| 4444 3333 2222 1111 | Visa       | 03/2030     | 737 |

## See also

* [Cards](/payment-methods/cards)
* [Enhanced scheme data](/payment-methods/cards/enhanced-scheme-data)
* [Webhooks](/development-resources/webhooks)
