Reservations End-to-End examples

  • The BatchAvailabilityLookup request is used to check the availability of multiple time slots, returning whether each requested slot is available.

  • The CreateBooking request is used to create a new booking for a specific slot, requiring user and payment information.

  • The UpdateBooking request is used to modify an existing booking, such as changing the slot time.

BatchAvailabilityLookup (page load)

Request

{
   "merchant_id" : "1234",
   "slot_time" : [
      {
         "duration_sec" : "1800",
         "resource_ids" : {
            "party_size" : 2
         },
         "service_id" : "5678",
         "start_sec" : "1606467600"
      },
      {
         "duration_sec" : "1800",
         "resource_ids" : {
            "party_size" : 2
         },
         "service_id" : "5678",
         "start_sec" : "1606469400"
      },
      {
         "duration_sec" : "1800",
         "resource_ids" : {
            "party_size" : 2
         },
         "service_id" : "5678",
         "start_sec" : "1606471200"
      }
   ]
}

Response

{
   "slot_time_availability" : [
      {
         "available" : true,
         "slot_time" : {
            "duration_sec" : "1800",
            "resource_ids" : {
               "party_size" : 2
            },
            "service_id" : "5678",
            "start_sec" : "1606467600"
         }
      },
      {
         "available" : true,
         "slot_time" : {
            "duration_sec" : "1800",
            "resource_ids" : {
               "party_size" : 2
            },
            "service_id" : "5678",
            "start_sec" : "1606469400"
         }
      },
      {
         "available" : true,
         "slot_time" : {
            "duration_sec" : "1800",
            "resource_ids" : {
               "party_size" : 2
            },
            "service_id" : "5678",
            "start_sec" : "1606471200"
         }
      }
   ]
}

BatchAvailabilityLookup (slot click)

Request

{
   "merchant_id" : "1234",
   "slot_time" : [
      {
         "duration_sec" : "1800",
         "resource_ids" : {
            "party_size" : 2
         },
         "service_id" : "5678",
         "start_sec" : "1606467600"
      }
   ]
}

Response

{
   "slot_time_availability" : [
      {
         "available" : true,
         "slot_time" : {
            "duration_sec" : "1800",
            "resource_ids" : {
               "party_size" : 2
            },
            "service_id" : "5678",
            "start_sec" : "1606467600"
         }
      }
   ]
}

CreateBooking

Request

{
   "idempotency_token" : "18307119013960637991",
   "payment_information" : {
      "prepayment_status" : "PREPAYMENT_NOT_PROVIDED"
   },
   "slot" : {
      "confirmation_mode" : "CONFIRMATION_MODE_SYNCHRONOUS",
      "duration_sec" : "1800",
      "merchant_id" : "1234",
      "resources" : {
         "party_size" : 2
      },
      "service_id" : "5678",
      "start_sec" : "1606467600"
   },
   "user_information" : {
      "email" : "john.smith@gmail.com",
      "family_name" : "Smith",
      "given_name" : "John",
      "telephone" : "+12091111111",
      "user_id" : "1111111111111111111"
   }
}

Response

{
   "booking" : {
      "booking_id" : "890",
      "payment_information" : {
         "prepayment_status" : "PREPAYMENT_NOT_PROVIDED"
      },
      "slot" : {
         "confirmation_mode" : "CONFIRMATION_MODE_SYNCHRONOUS",
         "duration_sec" : "1800",
         "merchant_id" : "1234",
         "resources" : {
            "party_size" : 2
         },
         "service_id" : "5678",
         "start_sec" : "1606467600"
      },
      "status" : "CONFIRMED",
      "user_information" : {
         "email" : "john.smith@gmail.com",
         "family_name" : "Smith",
         "given_name" : "John",
         "telephone" : "+12091111111",
         "user_id" : "1111111111111111111"
      }
   }
}

UpdateBooking

Request

{
   "booking" : {
      "booking_id" : "890",
      "slot" : {
         "duration_sec" : "1800",
         "start_sec" : "1606473000"
      }
   }
}

Response

{
   "booking" : {
      "booking_id" : "890",
      "payment_information" : {
         "prepayment_status" : "PREPAYMENT_NOT_PROVIDED"
      },
      "slot" : {
         "duration_sec" : 1800,
         "merchant_id" : "1234",
         "resources" : {
            "party_size" : 2
         },
         "service_id" : "5678",
         "start_sec" : 1606473000
      },
      "status" : "CONFIRMED",
      "user_information" : {
         "email" : "john.smith@gmail.com",
         "family_name" : "Smith",
         "given_name" : "John",
         "telephone" : "+12091111111",
         "user_id" : "1111111111111111111"
      }
   }
}