Booking - examples

Here are some examples that can come handy when sending payment information with the bookings.

Bookings with VCC

VCCs are temporary, digital Mastercards that Booking.com or Expedia uses to pay you for bookings that your guests pay for on Booking.com or Expedia.com. They function just like regular credit cards. Here’s how the booking with VCC looks like:

{
   "creditCard":{
      "cardNumber":"111111XTWANH1111",
      "cardHolder":"Bookingcom Agent",
      "expiryMonth":"09",
      "expiryYear":"2023",
      "cardType":"MC",
      "isVirtual":true,
      "activationTime":"2022-09-02T06:00:00Z"
   },
   "booker":{
      "firstName":"Yoda",
      "lastName":"Jinn",
      "email":"guest@guest.booking.com",
      "phone":"+49 111 1111111",
      "address":{
         "addressLine1":"Severinusstr. 11111",
         "postalCode":"",
         "city":"Lippstadt",
         "countryCode":"DE"
      }
   },
   "bookerComment":"Booker has a genius status",
   "channelCode":"BOOKINGCOM",
   "reservations":[
      {
         "arrival":"2022-09-06",
         "departure":"2022-09-09",
         "adults":2,
         "guestComment":"smoking preference: Non-Smoking",
         "externalId":"11111111|900",
         "travelPurpose":"Leisure",
         "pricingType":"BeforeTaxesWithVat",
         "timeSlices":[
            {
               "ratePlanId":"MUC-NONREF-FAMILY",
               "totalAmount":{
                  "amount":219.0,
                  "currency":"EUR"
               }
            },
            {
               "ratePlanId":"MUC-NONREF-FAMILY",
               "totalAmount":{
                  "amount":219.0,
                  "currency":"EUR"
               }
            },
            {
               "ratePlanId":"MUC-NONREF-FAMILY",
               "totalAmount":{
                  "amount":219.0,
                  "currency":"EUR"
               }
            }
         ],
            "commission":{
            "commissionAmount":{
               "amount":78.84,
               "currency":"EUR"
            }
         }
      }
   ]
}

You need to send booking for generic credit cards in the similar way. Please note that the credit card has to be tokenized first.

Bookings with prepayments

For Prepayment, you would need to authorize the prepayment amount and forward the reference to the transaction to apaleo together with the payment account. With this option, reservations with the guarantee type Prepayment are charged once the reservation has been created.

{
   "paymentAccount":{
      "accountNumber":"1111",
      "accountHolder":"Yoda Jinn",
      "expiryMonth":"7",
      "expiryYear":"2025",
      "paymentMethod":"visa",
      "payerEmail":"guest@guest.de",
      "payerReference":"PS-11111-1111",
      "isVirtual":false
   },
   "booker":{
      "title":"Mr",
      "firstName":"Yoda",
      "lastName":"Jinn",
      "email":"guest@guest.de",
      "phone":"0111111111",
      "nationalityCountryCode":"DE",
      "preferredLanguage":"DE",
      "address":{
         "addressLine1":"Silberstr. 11111",
         "postalCode":"111111",
         "city":"Hannover",
         "countryCode":"DE"
      },
      "company":{
         "name":"Yoda GmbH",
         "taxId":""
      }
   },
   "comment":"Booking number: PS-11111-1111 ",
   "channelCode":"ChannelManager",
   "source":"Google Hotel Finder",
   "reservations":[
      {
         "propertyId":"MUC",
         "arrival":"2022-08-30",
         "departure":"2022-09-02",
         "adults":1,
         "externalId":"PS-01CB02-1705",
         "primaryGuest":{
            "title":"Mr",
            "firstName":"Yoda",
            "lastName":"Jinn",
            "email":"guest@guest.de",
            "phone":"0111111111",
            "address":{
               "addressLine1":"Silberstr. 11111",
               "postalCode":"111111",
               "city":"Hannover",
               "countryCode":"DE"
            }
         },
         "timeSlices":[
            {
               "ratePlanId":"MUC-NONREF-FAMILY",
               "totalAmount":{
                  "amount":180.72,
                  "currency":"EUR"
               }
            },
            {
               "ratePlanId":"MUC-NONREF-FAMILY",
               "totalAmount":{
                  "amount":188.63,
                  "currency":"EUR"
               }
            },
            {
               "ratePlanId":"MUC-NONREF-FAMILY",
               "totalAmount":{
                  "amount":199.94,
                  "currency":"EUR"
               }
            }
         ],
         "pricingType":"AfterTaxes",
         "guaranteeType":"Prepayment",
         "prePaymentAmount":{
            "amount":569.29,
            "currency":"EUR"
         }
      }
   ],
   "transactionReference":"JF92DC2PP1111111"
}