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