New 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 Yes Lodging database unique identifier (used as REST identifier)
comment String No Customer comment
occupantCount int Yes Number of occupants
promoCode String No Coupon code used for a financial discount
paymentType String Yes Payment type:
  • 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
  • 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
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]"
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.