Form of Payments
4.1 Introduction
Any new lodging reservation requires a form of payment to be specified. The availability of a particular form of payment for a used source (GDS, Aggregator) is returned in the Hotel Price Check API's response (hotel pricing is out of scope of this document). If a form of payment is added that is not accepted by the supplier, the lodging product returns an error. Refer to the Error Messages section for more information.
Below is a list of payment forms supported by the lodging functionality:
Form Of Payment | OTA Code | Guarantee | Deposit |
---|---|---|---|
Credit card | 5 | Y | Y |
Agency Address | 18 | Y | Y |
IATA Number | 19 | Y | N |
Company | 29 | Y | N |
Corporate ID | 30 | Y | Y |
Virtual Form Of Payment | 43 | Y | Y |
To add lodging products, add the proper form of payment associated with the segment in the same request using the FormOfPaymentReference newRef
attribute:
FormOfPaymentReference newRef=" 1 ".
The newRef
attribute refers to a particular form Of payment id
added in the same request:
<OpenReservationElement id="1" type="FP">
<or:FormOfPayment>
Depending on the form of payment, certain elements within the request can shift from mandatory to optional. Examples for each type are described later in this guide. Required elements for each case are marked with mandatory.
If no Guarantee
or Deposit
is populated, an error message displays:
Code 3009, Message MISSING PAYMENT INFORMATION TYPE. PAYMENT INFORMATION REQUIRED
Below is an example of UpdateReservationRQ with newRef
elements:
<ReturnOptions RetrievePNR="true" IncludeUpdateDetails="true"/>
<ReservationUpdateList>
<ReservationUpdateItem UpdateId="ID_3">
<ProductUpdate op="C">
<Product>
<or:ProductDetails xmlns:or="http://services.sabre.com/res/or/v1_14">
<or:ProductName type="HHL">Lodging</or:ProductName>
<or:Lodging>
<or:ResGlobalInfo>
<or:BookingInfo Email="Orville.Wrigth@sabre.com" RequestorID="SG000000">
<or:BookingKey>63dbc07c-9a3e-489b-bdb8-b84efbfff4e9</or:BookingKey>
</or:BookingInfo>
</or:ResGlobalInfo>
<or:Rooms>
<or:Room RoomIndex="1">
<or:Guests>
<or:Guest Email="Orville.Wrigth@sabre.com" FirstName="Orville" Index="1" LastName="Wrigth" LeadGuest="true" Type="10">
<or:Contact Phone="817-555-1212"/>
</or:Guest>
</or:Guests>
</or:Room>
</or:Rooms>
<or:PaymentInformation Type="GUARANTEE">
<or:FormOfPaymentReference newRef="13"/>
</or:PaymentInformation>
<or:POS>
<or:Source AgencyName="SABRE" ISOCountryCode="US" PseudoCityCode="TM61">
<or:RequestorID Id="99999" IdContext="IATA" Type="5"/>
<or:AgencyAddress>
<or:AddressLine1>3150 SABRE DRIVE</or:AddressLine1>
<or:CityName/>
<or:CountryName Code="US"/>
</or:AgencyAddress>
</or:Source>
</or:POS>
</or:Lodging>
</or:ProductDetails>
</Product>
</ProductUpdate>
</ReservationUpdateItem>
<ReservationUpdateItem>
<OpenReservationElementUpdate id="13" op="C">
<OpenReservationElement id="13" type="FP">
<or:FormOfPayment xmlns:or="http://services.sabre.com/res/or/v1_14">
<or:Agency>
<or:IATANumber>99988877</or:IATANumber>
</or:Agency>
</or:FormOfPayment>
</OpenReservationElement>
</OpenReservationElementUpdate>
</ReservationUpdateItem>
</ReservationUpdateList>
</UpdateReservationRQ>
The form of payment used as the lodging form of payment is not added as a form of payment to the PNR.