Preconfirm and Reconfirm Request

If an intermediate step to proceed with a payment process is needed, then you have the choice of performing a two-step confirmation. 

The pre-confirm api call will deliver a booking reference and the same information as the “confirm” api call  or the “detail” api call but the contents factsheet. 

The Reconfirm api call returns all the information too including the contents factsheet not returned in the Preconfirm call. 

The following is a preconfirm request example:

{
  "clientReference": "Exp 132223/2016",
  "holder": {
    "surname": "Smith",
    "name": "John",
    "title": "Mr",
    "email": "j.smith@hotelbeds.com",
    "address": "Cami Son Fangos 100",
    "zipCode": "07007",
    "telephones": ["555123123", "555456456", "555789789"],
    "mailing": false,
    "country": "ES"
  },
  "language": "en",
  "activities": [{
    "rateKey": "3ajeb1pcqslb8r850t2atsqk4d",
    "from": "2016-03-29",
    "to": "2016-03-29"
  }]

And the following is a fragment of a preconfirm response where the generated booking number can be seen:
{
  "operationId": "ACTRTR-BOOKINGPreconfirm-74hn4h1n7ptjpafl3ap16dasge",
  "auditData": {},
  "booking": {
    "creationDate": "2016-03-22T17:06:32.000Z",
    "paymentData": {... },
    "reference": "102-6112608",
    "status": "PRECONFIRMED"
      ...
  }

As it can be seen, a booking in “PRECONFIRMED” status has been generated and a booking reference too. 

A call to reconfirm with the returned booking number will generate the valid booking. The following is an example request to reconfirm the previous booking:

{   "language": "en",   "reference": "102-6112608"

And the, the booking is marked as confirmed. See the following reconfirmation fragment for the example above:

{
  "operationId": "ACTRTR-BOOKINGReconfirm-rair2pu6d8ehli9q73s29aq847",
  "auditData": {},
  "booking": {
    "creationDate": "2016-03-22T17:07:19.776",
    "paymentData": {... },
    "reference": "102-6112608",
    "status": "CONFIRMED"
      ...
  }
Preconfirm request

Specifications

Live URL: https://api.hotelbeds.com/activity-api/3.0/bookings/preconfirm

Test URL: https://api.test.hotelbeds.com/activity-api/3.0/bookings/preconfirm

Method: PUT 

The preconfirm request is the same as the confirm api call request. See here for details. 

Reconfirm request

Specifications

Live URL: https://api.hotelbeds.com/activity-api/3.0/bookings/reconfirm

Test URL: https://api.test.hotelbeds.com/activity-api/3.0/bookings/reconfirm

Method: PUT 

Reconfirm request contains a booking number and a language in which the booking details are returned. The following is the operation spec: 

NAME

Type

DESCRIPTION

language

String

Language code to be used in the response.

reference

String

Booking reference generated in the preconfirm api call.

Docs Navigation