New easy booking (v2)

Contains minimal data to book a stay on Poplidays web site.

Field Type Required Description
arrival String Yes Stay arrival (format: "YYYYMMDD")
departure String Yes Stay departure (format: "YYYYMMDD")
lodgingId long No Lodging database unique identifier (used as REST identifier). Although the parameter is not required either lodgingId or referenceId must be presented
referenceId String No Lodging string identifier (internal index). Although the parameter is not required either lodgingId or referenceId must be presented
comment String No Customer comment
occupantCount int Yes Number of occupants (children included)
occupantCountChildren int Yes Number of childrens
occupantFlexible boolean No If "true", it will generate a quote even if the number of person is higher than that allowed for the property(creates the quote, with max authorized occupant)
promoCode String No Coupon code used for a financial discount
requestType String Yes Request type:
  • EVALUATION : will be evaluated best deal possibility
  • REFERENCE_ONLY : a booking will be created in order to obtain a reference. Booking is not effective and the stay is still available for other customers.
  • QUOTATION : a booking will be created, with a quote status.
  • OPTION_2_HOURS : customer will receive a mail with payment link. Booking is effective and the stay is no more available for other customers within two hours.
  • PAYMENT_REQUEST: customer will receive a mail with payment link. Booking is not effective and the stay is still available for other customers
  • PAYMENT_LINK : customer will receive a mail with payment link. Booking is not effective and the stay is still available for other customers. return payment link.
  • PAYMENT_OPTION : customer will receive a mail with payment link. Booking is effective and the stay is no more available for other customers. return payment link.
  • BOOKED : a booking will be created and booked.
  • PAYMENT_OPTION_WITH_VALIDATION : todo Hispanoa/Iberimo specific behavior.
customer Customer Yes Customer data
extras String list No Extra list selected by customer. You must send extra's code if type is CHECK or one parameter if type is LIST. Sample extras example are provided in extras. In this case, if customer selects "POP'Assur" and checks " Ménage fin de séjour " you have to send : "[END_OF_STAY_CLEANING, POPASSUR]"
price double Yes Should be equal or higher than our possible price
urlSuccess String No Url success payment
urlFailure String No Url urlFailure payment
referenceReseller String No Reference reseller
salesFollowup String No Sales follow-up

Extras specific management

Extras mandatory are provided dynamicaly by Poplidays, because are not fixed. You can find explciation in doc In api doc, explication of object extra, on field mandatory see if require.