Feature Overview

If you are a Hotel or another eligible merchant type, it may be beneficial to provide specific lodging data in your Auth and Charge transaction requests to Braintree. This may help you achieve lower interchange fees levied by the card networks. We allow for the passing of this data, and the rest of this documentation article will discuss this feature.

Eligible MCC codes for passing Lodging Data:

• 7011

Merchants not under one of the above MCC codes would not be eligible to pass lodging data to Braintree.

Passing Lodging Data

You may pass lodging data in both the requestAuthorize and requestCharge mutations as well as a captureTransaction request. The example below will depict using a requestAuthorize mutation.

mutation RequestAuthorizeFromInStoreReader($input: RequestAuthorizeFromInStoreReaderInput!) {
              requestAuthorizeFromInStoreReader(input: $input) {
                  clientMutationId
                  inStoreContext {
                      id
                      status
                      transaction {
                          id
                          orderId
                          status
                          customer{
                              id
                          }
                          paymentMethodSnapshot{
                              __typename
                              ... on CreditCardDetails {
                                  brandCode
                                  bin
                                  last4
                                  cardholderName
                                  expirationMonth
                                  expirationYear     
                              }
                          }
                      }
                      reader {
                          id
                          name                
                          status
                          softwareVersion
                      }
                  }
              }
          }

Viewing Lodging Data in the control panel

The lodging data, once passed to Braintree, is sent onto the card networks so that the merchant benefits from lower interchange rates. It is also possible to view the lodging data that was passed by looking up your transaction in the Braintree control panel on the Transaction Details Page under the section "Industry Specific Data".

Important Tips for passing Lodging Data

• The passing of lodging data is NOT supported for offline transactions, and if these API fields are passed for an offline transaction, it will result in an API error.

• We support the passing of lodging data when using the Request Authorize or Request Charge API mutations; however, you may also pass this data when you send a separate capture request against an authorization.