{"title":"Lodging data","category":"default","creationDate":1664364660,"content":"<p>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.<\/p>\n<p>You get benefits for transactions, depending on the scheme:<\/p>\n<ul>\n<li>Visa: prevent downgrades to higher commercial standard rates.<\/li>\n<li>Mastercard: ensure that your transactions qualify for the interchange rates specific to your industry.<\/li>\n<\/ul>\n<h2>Requirements<\/h2>\n<p>In addition to the <a href=\"\/pt\/payment-methods\/cards\/enhanced-scheme-data#requirements\">requirements that apply to sending ESD<\/a>, take into account the following additional limitations for sending lodging data.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\"><ul><li>Your business must operate under an <a href=\"#lodging-data-mcc\">eligible MCC<\/a>.<\/li><li> You can only send lodging data for commercial and consumer cards. <\/li><li> The  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/overview\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Checkout API<\/a> does not support sending lodging data in capture requests. You can send ESD while capturing the payment if you have an existing  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Payment\/latest\/overview\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Classic API<\/a> integration.  <\/li><li> You can send the following car rental data fields only in the payment request: <ul><li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-travelEntertainmentAuthData-market\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>travelEntertainmentAuthData.market<\/code>\n<\/a> <\/li><li> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-travelEntertainmentAuthData-duration\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>travelEntertainmentAuthData.duration<\/code>\n<\/a> <\/li><\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"lodging-data-mcc\">Eligible MCCs for lodging data<\/h3>\n<p>You can send lodging ESD if you have one of the following MCCs:<\/p>\n<table>\n<thead>\n<tr>\n<th>MCC<\/th>\n<th>Description<\/th>\n<th>Scheme<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>3501-3999<\/td>\n<td>Hotels\/motels<\/td>\n<td>Mastercard, Visa<\/td>\n<\/tr>\n<tr>\n<td>7011<\/td>\n<td>Lodging - hotels, motels and resorts<\/td>\n<td>Mastercard, Visa<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>How it works<\/h2>\n<p>In your payment or capture requests, include the car rental specific data fields. The recommended request depends on your <a href=\"\/pt\/online-payments\/capture#types-of-capture\">capture setting<\/a>.<\/p>\n<ul>\n<li><strong>Automatic capture<\/strong> and <strong>Delayed automatic capture<\/strong>: in the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> request, include lodging data in the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-customerServiceTollFreeNumber\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">additionalData.lodging<\/a> object.<\/li>\n<li><strong>Manual capture<\/strong> (<strong>Single partial capture<\/strong> and <strong>Multiple partial capture<\/strong>): in the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Payment\/latest\/post\/capture\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/capture<\/a> request, include lodging data in the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Payment\/latest\/post\/capture#request-additionalData-AdditionalDataLodging\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">additionalData.enhancedSchemeData.lodging<\/a> object.<\/li>\n<\/ul>\n<h2>Send lodging data<\/h2>\n<p>Include airline data in the payment or capture request.<\/p>\n<ul>\n<li>For the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> request: use the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-checkInDate\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">additionalData.lodging<\/a> object.<\/li>\n<li>For the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Payment\/latest\/post\/capture\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/capture<\/a> request: use the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Payment\/latest\/post\/capture#request-additionalData-AdditionalDataLodging\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">additionalData.enhancedSchemeData.lodging<\/a> object.<\/li>\n<\/ul>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Required<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-checkInDate\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.checkInDate<\/code>\n<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-checkOutDate\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.checkOutDate<\/code>\n<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-folioNumber\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.folioNumber<\/code>\n<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-room1-rate\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.room[itemNr].rate<\/code>\n<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-room1-numberOfNights\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.room[itemNr].numberOfNights<\/code>\n<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-customerServiceTollFreeNumber\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.customerServiceTollFreeNumber<\/code>\n<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-propertyPhoneNumber\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.propertyPhoneNumber<\/code>\n<\/a><\/td>\n<td><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-totalRoomTax\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.totalRoomTax<\/code>\n<\/a><\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-totalTax\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.totalTax<\/code>\n<\/a><\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td><code>lodging.specialProgramCode<\/code><\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-fireSafetyActIndicator\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.fireSafetyActIndicator<\/code>\n<\/a><\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-folioCashAdvances\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.folioCashAdvances<\/code>\n<\/a><\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-foodBeverageCharges\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.foodBeverageCharges<\/code>\n<\/a><\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-noShowIndicator\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.noShowIndicator<\/code>\n<\/a><\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-additionalData-AdditionalDataLodging-lodging-prepaidExpenses\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\n  <code>lodging.prepaidExpenses<\/code>\n<\/a><\/td>\n<td><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<div id=\"tab6oixY\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;&lt;code&gt;\\\/payments&lt;\\\/code&gt; endpoint&quot;,&quot;content&quot;:&quot;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Example payment request with lodging data&#039;\\&quot; :id=\\&quot;&#039;payment-request-lodging&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/checkout-test.adyen.com\\\\\\\/v72\\\\\\\/payments \\\\\\\\\\\\n-H &#039;x-API-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-H &#039;idempotency-key: YOUR_IDEMPOTENCY_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X POST\\\\n-d &#039;{\\\\n  \\\\&amp;quot;amount\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;currency\\\\&amp;quot;: \\\\&amp;quot;USD\\\\&amp;quot;,\\\\n    \\\\&amp;quot;value\\\\&amp;quot;: 20000\\\\n  },\\\\n  \\\\&amp;quot;reference\\\\&amp;quot;: \\\\&amp;quot;YOUR_ORDER_NUMBER\\\\&amp;quot;,\\\\n  \\\\&amp;quot;paymentMethod\\\\&amp;quot;:{\\\\n    \\\\&amp;quot;type\\\\&amp;quot;:\\\\&amp;quot;scheme\\\\&amp;quot;,\\\\n    \\\\&amp;quot;cvc\\\\&amp;quot;: \\\\&amp;quot;737\\\\&amp;quot;,\\\\n    \\\\&amp;quot;expiryMonth\\\\&amp;quot;: \\\\&amp;quot;03\\\\&amp;quot;,\\\\n    \\\\&amp;quot;expiryYear\\\\&amp;quot;: \\\\&amp;quot;2030\\\\&amp;quot;,\\\\n    \\\\&amp;quot;holderName\\\\&amp;quot;: \\\\&amp;quot;John Smith\\\\&amp;quot;,\\\\n    \\\\&amp;quot;number\\\\&amp;quot;: \\\\&amp;quot;4444333322221111\\\\&amp;quot;\\\\n  },\\\\n  \\\\&amp;quot;returnUrl\\\\&amp;quot;: \\\\&amp;quot;https:\\\\\\\/\\\\\\\/your-company.example.com\\\\\\\/...\\\\&amp;quot;,\\\\n  \\\\&amp;quot;merchantAccount\\\\&amp;quot;: \\\\&amp;quot;ADYEN_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n  \\\\&amp;quot;additionalData\\\\&amp;quot;: {\\\\n     \\\\&amp;quot;travelEntertainmentAuthData.market\\\\&amp;quot;:\\\\&amp;quot;A\\\\&amp;quot;,\\\\n     \\\\&amp;quot;travelEntertainmentAuthData.duration\\\\&amp;quot;:\\\\&amp;quot;1\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.customerServiceTollFreeNumber\\\\&amp;quot;:\\\\&amp;quot;8001122334\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.checkInDate\\\\&amp;quot;:\\\\&amp;quot;20230312\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.checkOutDate\\\\&amp;quot;:\\\\&amp;quot;20230314\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.folioNumber\\\\&amp;quot;:\\\\&amp;quot;AB12345\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.propertyPhoneNumber\\\\&amp;quot;:\\\\&amp;quot;8001122334\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.room1.rate\\\\&amp;quot;:\\\\&amp;quot;50\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.room1.tax\\\\&amp;quot;:\\\\&amp;quot;200\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.room1.numberOfNights\\\\&amp;quot;:\\\\&amp;quot;2\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.totalRoomTax\\\\&amp;quot;: \\\\&amp;quot;400\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.fireSafetyActIndicator\\\\&amp;quot;:\\\\&amp;quot;Y\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.folioCashAdvances\\\\&amp;quot;:\\\\&amp;quot;100\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.foodBeverageCharges\\\\&amp;quot;:\\\\&amp;quot;1000\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.noShowIndicator\\\\&amp;quot;:\\\\&amp;quot;Y\\\\&amp;quot;,\\\\n     \\\\&amp;quot;lodging.prepaidExpenses\\\\&amp;quot;:\\\\&amp;quot;500\\\\&amp;quot;\\\\n  }\\\\n}&#039;&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;payments_endpoint_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;&lt;code&gt;\\\/captures&lt;\\\/code&gt; endpoint&quot;,&quot;content&quot;:&quot;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Example capture request with lodging data&#039;\\&quot; :id=\\&quot;&#039;capture-request-lodging&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/pal-test.adyen.com\\\\\\\/pal\\\\\\\/servlet\\\\\\\/Payment\\\\\\\/v68\\\\\\\/capture \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X POST\\\\n-d &#039;{\\\\n   \\\\&amp;quot;merchantAccount\\\\&amp;quot;:\\\\&amp;quot;ADYEN_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n   \\\\&amp;quot;modificationAmount\\\\&amp;quot;:{\\\\n      \\\\&amp;quot;currency\\\\&amp;quot;:\\\\&amp;quot;USD\\\\&amp;quot;,\\\\n      \\\\&amp;quot;value\\\\&amp;quot;:20000\\\\n   },\\\\n   \\\\&amp;quot;originalReference\\\\&amp;quot;:\\\\&amp;quot;NC6HT9CRT65ZGN82\\\\&amp;quot;,\\\\n   \\\\&amp;quot;additionalData\\\\&amp;quot;:{\\\\n      \\\\&amp;quot;lodging.customerServiceTollFreeNumber\\\\&amp;quot;:\\\\&amp;quot;8001122334\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.checkInDate\\\\&amp;quot;:\\\\&amp;quot;20230312\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.checkOutDate\\\\&amp;quot;:\\\\&amp;quot;20230314\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.folioNumber\\\\&amp;quot;:\\\\&amp;quot;AB12345\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.propertyPhoneNumber\\\\&amp;quot;:\\\\&amp;quot;8001122334\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.room1.rate\\\\&amp;quot;:\\\\&amp;quot;50\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.room1.tax\\\\&amp;quot;:\\\\&amp;quot;200\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.room1.numberOfNights\\\\&amp;quot;:\\\\&amp;quot;2\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.totalRoomTax\\\\&amp;quot;: \\\\&amp;quot;400\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.fireSafetyActIndicator\\\\&amp;quot;:\\\\&amp;quot;Y\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.folioCashAdvances\\\\&amp;quot;:\\\\&amp;quot;100\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.foodBeverageCharges\\\\&amp;quot;:\\\\&amp;quot;1000\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.noShowIndicator\\\\&amp;quot;:\\\\&amp;quot;Y\\\\&amp;quot;,\\\\n      \\\\&amp;quot;lodging.prepaidExpenses\\\\&amp;quot;:\\\\&amp;quot;500\\\\&amp;quot;\\\\n   }\\\\n}&#039;&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;captures_endpoint_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2>Test sending lodging data<\/h2>\n<p>Use the following test card to test payments with lodging data:<\/p>\n<table>\n<thead>\n<tr>\n<th>Card Number<\/th>\n<th style=\"text-align: left;\">Card Type<\/th>\n<th>Expiry Date<\/th>\n<th>CVV<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>5555 5555 5555 4444<\/td>\n<td style=\"text-align: left;\">Mastercard<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<tr>\n<td>4444 3333 2222 1111<\/td>\n<td style=\"text-align: left;\">Visa<\/td>\n<td>03\/2030<\/td>\n<td>737<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>See also<\/h2>\n<ul>\n<li><a href=\"\/pt\/payment-methods\/cards\">Cards<\/a><\/li>\n<li><a href=\"\/pt\/payment-methods\/cards\/enhanced-scheme-data\">Enhanced scheme data<\/a><\/li>\n<li><a href=\"\/pt\/development-resources\/webhooks\">Webhooks<\/a><\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/cards\/enhanced-scheme-data\/lodging","articleFields":{"description":"Send lodging data for US domestic transactions.","feedback_component":true,"last_edit_on":"09-03-2023 17:10","page_id":"09a5d9e0-df4a-41fb-ba27-eb8cde6feee2","filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/cards\/enhanced-scheme-data\/lodging","title":"Lodging data","content":"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.\nYou get benefits for transactions, depending on the scheme:\n\nVisa: prevent downgrades to higher commercial standard rates.\nMastercard: ensure that your transactions qualify for the interchange rates specific to your industry.\n\nRequirements\nIn addition to the requirements that apply to sending ESD, take into account the following additional limitations for sending lodging data.\n\n\n\nRequirement\nDescription\n\n\n\n\nLimitations\nYour business must operate under an eligible MCC. You can only send lodging data for commercial and consumer cards.  The  Checkout API does not support sending lodging data in capture requests. You can send ESD while capturing the payment if you have an existing  Classic API integration.   You can send the following car rental data fields only in the payment request:  \n  travelEntertainmentAuthData.market\n  \n  travelEntertainmentAuthData.duration\n \n\n\n\nEligible MCCs for lodging data\nYou can send lodging ESD if you have one of the following MCCs:\n\n\n\nMCC\nDescription\nScheme\n\n\n\n\n3501-3999\nHotels\/motels\nMastercard, Visa\n\n\n7011\nLodging - hotels, motels and resorts\nMastercard, Visa\n\n\n\nHow it works\nIn your payment or capture requests, include the car rental specific data fields. The recommended request depends on your capture setting.\n\nAutomatic capture and Delayed automatic capture: in the  \/payments request, include lodging data in the  additionalData.lodging object.\nManual capture (Single partial capture and Multiple partial capture): in the  \/capture request, include lodging data in the  additionalData.enhancedSchemeData.lodging object.\n\nSend lodging data\nInclude airline data in the payment or capture request.\n\nFor the  \/payments request: use the  additionalData.lodging object.\nFor the  \/capture request: use the  additionalData.enhancedSchemeData.lodging object.\n\n\n\n\nField\nRequired\n\n\n\n\n\n  lodging.checkInDate\n\n\n\n\n\n  lodging.checkOutDate\n\n\n\n\n\n  lodging.folioNumber\n\n\n\n\n\n  lodging.room[itemNr].rate\n\n\n\n\n\n  lodging.room[itemNr].numberOfNights\n\n\n\n\n\n  lodging.customerServiceTollFreeNumber\n\n\n\n\n\n  lodging.propertyPhoneNumber\n\n\n\n\n\n  lodging.totalRoomTax\n\n\n\n\n\n  lodging.totalTax\n\n\n\n\nlodging.specialProgramCode\n\n\n\n\n  lodging.fireSafetyActIndicator\n\n\n\n\n\n  lodging.folioCashAdvances\n\n\n\n\n\n  lodging.foodBeverageCharges\n\n\n\n\n\n  lodging.noShowIndicator\n\n\n\n\n\n  lodging.prepaidExpenses\n\n\n\n\n\n\n\n    \n        \n        \n    \n\n\nTest sending lodging data\nUse the following test card to test payments with lodging data:\n\n\n\nCard Number\nCard Type\nExpiry Date\nCVV\n\n\n\n\n5555 5555 5555 4444\nMastercard\n03\/2030\n737\n\n\n4444 3333 2222 1111\nVisa\n03\/2030\n737\n\n\n\nSee also\n\nCards\nEnhanced scheme data\nWebhooks\n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"Cards","lvl3":"Enhanced scheme data","lvl4":"Lodging data"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/pt\/payment-methods\/cards","lvl3":"https:\/\/docs.adyen.com\/pt\/payment-methods\/cards\/enhanced-scheme-data","lvl4":"\/pt\/payment-methods\/cards\/enhanced-scheme-data\/lodging"},"levels":5,"category":"Payment method","category_color":"green","tags":["Lodging"]}}