Despegar.com - Hotels, flights, packages, cars, and more!

## Booking Handling (Push) Examples

These examples cannot be tested in the sandbox environment, but show the different
message types that your endpoint may receive.

### New Prepaid Reservation

##### Request

```xml
<OTA_HotelResNotifRQ xmlns="http://www.despegar.com/hotels/ota/v1/" Version="v1" CorrelationID="123">
  <HotelReservations>
    <HotelReservation ResStatus="Book" CreateDateTime="2015-10-13T20:45:32.000-03:00" LastModifyDateTime="2015-10-13T21:45:32.000-03:00">
      <POS>
        <Source ISOCountry="BR">
          <BookingChannel Type="2">
            <CompanyName Code="DESPEGAR" />
          </BookingChannel>
        </Source>
      </POS>
      <ResGlobalInfo>
        <HotelReservationIDs>
          <HotelReservationID ResID_Type="14" ResID_Value="2" />
        </HotelReservationIDs>
        <DepositPayments>
          <GuaranteePayment GuaranteeType="PrePay">
            <AcceptedPayments>
              <AcceptedPayment GuaranteeTypeCode="5">
                <PaymentCard ExpireDate="1230">
                  <CardType>VI</CardType>
                  <CardHolderName>María Eugenia Perez Lopez</CardHolderName>
                  <CardNumber>
                    <PlainText>4242424242424242</PlainText>
                  </CardNumber>
                  <SeriesCode>
                    <PlainText>123</PlainText>
                  </SeriesCode>
                </PaymentCard>
              </AcceptedPayment>
            </AcceptedPayments>
          </GuaranteePayment>
        </DepositPayments>
        <CancelPenalties>
          <CancelPenalty PolicyCode="early-cancellation">
            <AmountPercent NmbrOfNights="1" />
            <Deadline OffsetDropTime="BeforeArrival" OffsetTimeUnit="Hour" OffsetUnitMultiplier="48" />
          </CancelPenalty>
          <CancelPenalty PolicyCode="no-show">
            <AmountPercent NmbrOfNights="1" />
          </CancelPenalty>
          <CancelPenalty PolicyCode="early-checkout">
            <AmountPercent NmbrOfNights="1" />
          </CancelPenalty>
        </CancelPenalties>
        <Total AmountAfterTax="1099.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true">
          <Taxes Amount="331.5955" CurrencyCode="USD">
            <Tax Percent="43.21" CurrencyCode="USD" EffectiveDate="2015-11-02" ExpireDate="2015-11-09">
              <TaxDescription>
                <Text>VBE</Text>
              </TaxDescription>
            </Tax>
          </Taxes>
        </Total>
      </ResGlobalInfo>
      <ResGuests>
        <ResGuest ResGuestRPH="187749">
          <Profiles>
            <ProfileInfo>
              <UniqueID Type="24" ID="187749" />
              <Profile ProfileType="1">
                <Customer>
                  <PersonName>
                    <GivenName>Héloïse Łukasz</GivenName>
                    <Surname>Łódź</Surname>
                  </PersonName>
                </Customer>
              </Profile>
            </ProfileInfo>
          </Profiles>
        </ResGuest>
      </ResGuests>
      <RoomStays>
        <RoomStay>
          <RoomRates>
            <RoomRate RoomTypeCode="187749" RatePlanCode="17" NumberOfUnits="1">
              <Rates>
                <Rate EffectiveDate="2015-11-02" ExpireDate="2015-11-03">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-03" ExpireDate="2015-11-04">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-04" ExpireDate="2015-11-05">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-05" ExpireDate="2015-11-06">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-06" ExpireDate="2015-11-07">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-07" ExpireDate="2015-11-08">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-08" ExpireDate="2015-11-09">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
              </Rates>
            </RoomRate>
          </RoomRates>
          <TimeSpan Start="2015-11-02" End="2015-11-09" />
          <GuestCounts>
            <GuestCount AgeQualifyingCode="10" Count="2" />
          </GuestCounts>
          <BasicPropertyInfo HotelCode="282445" />
          <ResGuestRPHs>
            <ResGuestRPH RPH="187749" />
          </ResGuestRPHs>
          <Total AmountAfterTax="1099.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
        </RoomStay>
      </RoomStays>
    </HotelReservation>
  </HotelReservations>
</OTA_HotelResNotifRQ>
```

### New Cash Reservation

##### Request

```xml
<OTA_HotelResNotifRQ xmlns="http://www.despegar.com/hotels/ota/v1/" Version="v1" CorrelationID="123">
  <HotelReservations>
    <HotelReservation ResStatus="Book" CreateDateTime="2015-10-13T20:45:32.000-03:00" LastModifyDateTime="2015-10-13T21:45:32.000-03:00">
      <POS>
        <Source ISOCountry="BR">
          <BookingChannel Type="2">
            <CompanyName Code="DESPEGAR" />
          </BookingChannel>
        </Source>
      </POS>
      <ResGlobalInfo>
        <HotelReservationIDs>
          <HotelReservationID ResID_Type="14" ResID_Value="1" />
        </HotelReservationIDs>
        <CancelPenalties>
          <CancelPenalty PolicyCode="early-cancellation">
            <AmountPercent NmbrOfNights="1" />
            <Deadline OffsetDropTime="BeforeArrival" OffsetTimeUnit="Hour" OffsetUnitMultiplier="48" />
          </CancelPenalty>
          <CancelPenalty PolicyCode="no-show">
            <AmountPercent NmbrOfNights="1" />
          </CancelPenalty>
          <CancelPenalty PolicyCode="early-checkout">
            <AmountPercent NmbrOfNights="1" />
          </CancelPenalty>
        </CancelPenalties>
        <Total AmountAfterTax="1099.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true">
          <Taxes Amount="331.5955" CurrencyCode="USD">
            <Tax Percent="43.21" CurrencyCode="USD" EffectiveDate="2015-11-02" ExpireDate="2015-11-09">
              <TaxDescription>
                <Text>VBE</Text>
              </TaxDescription>
            </Tax>
          </Taxes>
        </Total>
      </ResGlobalInfo>
      <ResGuests>
        <ResGuest ResGuestRPH="187749">
          <Profiles>
            <ProfileInfo>
              <UniqueID Type="24" ID="187749" />
              <Profile ProfileType="1">
                <Customer>
                  <PersonName>
                    <GivenName>Iñaki</GivenName>
                    <Surname>Güemez Núñez</Surname>
                  </PersonName>
                </Customer>
              </Profile>
            </ProfileInfo>
          </Profiles>
        </ResGuest>
      </ResGuests>
      <RoomStays>
        <RoomStay>
          <RoomRates>
            <RoomRate RoomTypeCode="187749" RatePlanCode="17" NumberOfUnits="1">
              <Rates>
                <Rate EffectiveDate="2015-11-02" ExpireDate="2015-11-03">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-03" ExpireDate="2015-11-04">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-04" ExpireDate="2015-11-05">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-05" ExpireDate="2015-11-06">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-06" ExpireDate="2015-11-07">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-07" ExpireDate="2015-11-08">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2015-11-08" ExpireDate="2015-11-09">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
              </Rates>
            </RoomRate>
          </RoomRates>
          <TimeSpan Start="2015-11-02" End="2015-11-09" />
          <GuestCounts>
            <GuestCount AgeQualifyingCode="10" Count="2" />
            <GuestCount AgeQualifyingCode="7" Count="1" />
          </GuestCounts>
          <BasicPropertyInfo HotelCode="638049" />
          <ResGuestRPHs>
            <ResGuestRPH RPH="187749" />
          </ResGuestRPHs>
          <Total AmountAfterTax="1099.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
        </RoomStay>
      </RoomStays>
    </HotelReservation>
  </HotelReservations>
</OTA_HotelResNotifRQ>
```

### Modified Reservation with Guest Credit Card

##### Request

```xml
<OTA_HotelResModifyNotifRQ xmlns="http://www.despegar.com/hotels/ota/v1/" Version="v1" CorrelationID="123">
  <HotelResModifies>
    <HotelResModify ResStatus="Book" CreateDateTime="2015-10-13T20:45:32.000-03:00" LastModifyDateTime="2015-10-13T21:45:32.000-03:00">
      <ResGlobalInfo>
        <HotelReservationIDs>
          <HotelReservationID ResID_Type="14" ResID_Value="78910" />
        </HotelReservationIDs>
        <Guarantee>
          <GuaranteesAccepted>
            <PaymentCard ExpireDate="1230">
              <CardType>VI</CardType>
              <CardHolderName>María Eugenia Perez Lopez</CardHolderName>
              <CardNumber>
                <PlainText>4242424242424242</PlainText>
              </CardNumber>
              <SeriesCode>
                <PlainText>123</PlainText>
              </SeriesCode>
            </PaymentCard>
          </GuaranteesAccepted>
        </Guarantee>
        <CancelPenalties>
          <CancelPenalty PolicyCode="early-cancellation">
            <AmountPercent NmbrOfNights="1" />
            <Deadline OffsetDropTime="BeforeArrival" OffsetTimeUnit="Hour" OffsetUnitMultiplier="48" />
          </CancelPenalty>
          <CancelPenalty PolicyCode="no-show">
            <AmountPercent NmbrOfNights="1" />
          </CancelPenalty>
          <CancelPenalty PolicyCode="early-checkout">
            <AmountPercent NmbrOfNights="1" />
          </CancelPenalty>
        </CancelPenalties>
        <Total AmountAfterTax="1099.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true">
          <Taxes Amount="331.5955" CurrencyCode="USD">
            <Tax Percent="43.21" CurrencyCode="USD" EffectiveDate="2016-11-02" ExpireDate="2016-11-09">
              <TaxDescription>
                <Text>VBE</Text>
              </TaxDescription>
            </Tax>
          </Taxes>
        </Total>
      </ResGlobalInfo>
      <ResGuests>
        <ResGuest ResGuestRPH="187749">
          <Profiles>
            <ProfileInfo>
              <UniqueID Type="24" ID="187749" />
              <Profile ProfileType="1">
                <Customer>
                  <PersonName>
                    <GivenName>Iñaki</GivenName>
                    <Surname>Güemez Núñez</Surname>
                  </PersonName>
                </Customer>
              </Profile>
            </ProfileInfo>
          </Profiles>
        </ResGuest>
      </ResGuests>
      <RoomStays>
        <RoomStay>
          <RoomRates>
            <RoomRate RoomTypeCode="187749" RatePlanCode="17" NumberOfUnits="1">
              <Rates>
                <Rate EffectiveDate="2016-11-02" ExpireDate="2016-11-03">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2016-11-03" ExpireDate="2016-11-04">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2016-11-04" ExpireDate="2016-11-05">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2016-11-05" ExpireDate="2016-11-06">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2016-11-06" ExpireDate="2016-11-07">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2016-11-07" ExpireDate="2016-11-08">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
                <Rate EffectiveDate="2016-11-08" ExpireDate="2016-11-09">
                  <Total AmountAfterTax="157.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
                </Rate>
              </Rates>
            </RoomRate>
          </RoomRates>
          <TimeSpan Start="2016-11-02" End="2016-11-09" />
          <GuestCounts>
            <GuestCount AgeQualifyingCode="10" Count="2" />
            <GuestCount AgeQualifyingCode="7" Count="1" />
          </GuestCounts>
          <BasicPropertyInfo HotelCode="638049" />
          <ResGuestRPHs>
            <ResGuestRPH RPH="187749" />
          </ResGuestRPHs>
          <Total AmountAfterTax="1099.0000" CurrencyCode="USD" AmountIncludingMarkup="false" AdditionalFeesExcludedIndicator="true" />
        </RoomStay>
      </RoomStays>
    </HotelResModify>
  </HotelResModifies>
</OTA_HotelResModifyNotifRQ>
```

### Canceled Reservation

##### Request

```xml
<OTA_CancelRQ xmlns="http://www.despegar.com/hotels/ota/v1/" Version="v1" CorrelationID="123">
  <UniqueID Type="14" ID="2" />
  <UniqueID Type="10" ID="282445" />
</OTA_CancelRQ>
```