The Lodging data is supplied as an extension on existing transactions listed in this document and the schema documentation. Support for Lodging is provided by the LodgingDataType elements and its sub-elements.

The following are some typical use cases for Lodging:

Check In

Upon Check-In, the merchant may use a CreditAuth transaction to authorize the card and reserve the funds.  If all that is needed at check-in is to validate the card, a CreditAccountVerify can be used.  If the final amount of the stay is known, a CreditSale can be used.

Check Out

Upon Check-Out, the merchant closes out a CreditAuth by using the CreditAddToBatch transaction (if the Check-In used a CreditAuth that has not yet been added to a batch). Otherwise, a CreditSale can be run. or the original authorized amount can be reduced using a CreditTxnEdit transaction. The transaction request must include the GatewayTxnID from the Check-In authorization transaction, and optionally the amount of the transaction. 

 

Incremental Authorization for the Lodging Industry

Use the CreditIncrementalAuth transaction to increase the authorized amount on a credit card. Incremental authorization in the lodging industry is typically used for extended duration and extra charges added to a customer's stay. 

 

Single Stay

• To charge for a Single Stay use the CreditSale transaction. This will authorize the associated amount and add it to the current batch. If a batch does not exist, this transaction creates one.
  The duration for a Single Stay defaults to one day.

 

Advance Deposit

• To run an Advance Deposit, use the CreditSale transaction. The merchant must ensure that the transaction amount does not exceed the total price of the reserved services or activity. The cardholder must be informed of the total price of the services or activity, the advance deposit amount, the advance deposit confirmation code, and the cancellation terms. 

Additional Charge

• To include an additional charge prior to check-out, use the CreditTxnEdit transaction to alter the original transaction.
• For additional charges after check-out, see Delayed Charges.

No Show

• A merchant may charge for a No Show  if the cardholder does not stay and does not cancel by the agreed timeframe
• For all card brands, to charge penalties for a No Show, use a CreditSale transaction:
  • The Card Brands require the CardBrandTxnId from the original authorization response to be sent in the No Show request; this is achieved by sending the CardBrandTxnId in the CardOnFileData block in the No Show authorization request
  • Set the NoShow Indicator to True for all card brands
  The CardOnFile indicator is not required in this case unless a stored credential is being used. Refer to Credential/Card on File for further details.

Delayed Charges

• To charge for extra charges after check-out, use a CreditSale transaction.
  • The Card Brands require the CardBrandTxnId from the original authorization response to be sent in the Delayed Charges request. This is achieved by sending the CardBrandTxnId in the CardOnFileData block in the Delayed Charges authorization request.
    The CardOnFile indicator is not required in this case unless a stored credential is being used. Refer to Credential/Card on File for further details.

Extra Charges

Lodging merchants may specify which types of Extra Charges were incurred during a stay.  These charges must be sent in the appropriate fields for the authorization platform.

• For merchants processing on the GSAP-NA, GNAP-UK, and Exchange authorization platforms, Extra Charges are sent as Boolean (true/false) indicators
• For merchants processing on the GSAP-AP authorization platform, Extra Charges are sent as amounts

Amex Special Programs

The AdvancedDepositType data block is used for American Express cards only. 

• ASSURED_RESERVATION -  This is an American Express Special Program Code.  The merchant may do an Assured Reservation.  A room is guaranteed for the cardholder.  The cancellation policy must be shared with the cardholder.  If the cardholder does not stay or cancel by the agreed timeframe, the merchant may charge a NoShow fee, in accordance with the cancellation policy.  
• CARD_DEPOSIT-  This is an American Express Special Program Code. The merchant may do Card Deposit (Advanced Deposit) , usually for 1 night stay including the cost of the room, taxes and for incidentals.
• PURCHASE - This is an American Express Special Program Code.  For a regular check-in, use CreditSale with AdvancedDepositType set to PURCHASE.