Buy Cinema Experience Tickets

Please, bear in mind that the normal 'Buy Experience' endpoint and this 'Buy Cinema Experience' endpoints are very similar. The only difference is that for Cinema, you have to pass the 'attendance_date' (the date the customer is to come watch the movie at the cinema) and the 'time_id' (id of the time - 6:40PM - 8:50PM).

Buy Cinema Experience Tickets

post

This endpoint allows users to purchase cinema experience tickets by referencing IDs retrieved from separate ticket and experience endpoints. This is similar to the normal experience purchase endpoint, with the exception of the attendance_date and time_id attributes.

Body

application/json

experience_idstringRequired

Unique identifier of the experience.

Example: 32d4f98c-7f49-40ec-9782-2cbfe83005f4

attendance_datestringRequired

The date the user plans to watch the movie at the cinema. The user should select a date from those returned by a separate endpoint.

Example: 23-09-2024

time_idintegerRequired

The ID of the time period that the user will be watching the movie. The cinema business sets the time during the day that the movie shows. Example: 11:30AM - 2:30PM, 6:05 PM - 8:45 PM. Each of these time ranges has an ID.

Example: 3

Responses

201

Ticket purchased successfully

application/json

successbooleanOptional

statusintegerOptional

messagestringOptional

400

Bad request due to invalid input

application/json

500

Internal server error

application/json

post

/api/v1/merpi/experience/buy/tickets

HTTPcURLJavaScriptPython

POST /api/v1/merpi/experience/buy/tickets HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 308

{
  "tickets": [
    {
      "id": "51cbea98-85df-4ac8-8fa8-a9e669a16f0f",
      "count": 1
    }
  ],
  "experience_id": "32d4f98c-7f49-40ec-9782-2cbfe83005f4",
  "attendance_date": "23-09-2024",
  "time_id": 3,
  "customer_info": {
    "name": "Victor Ebuka",
    "email": "[e-mail]",
    "phone_number": "08085825362",
    "dob": "2000-12-01",
    "username": "victor_ebuka"
  }
}

{
  "success": true,
  "status": 201,
  "message": "Ticket Purchased Successfully",
  "data": {
    "reference": "EX117562335",
    "invoice_id": 32747015,
    "name": "Victor Ebuka",
    "email": "[e-mail]",
    "phone_number": "08085825362",
    "tickets": [
      {
        "id": "51cbea98-85df-4ac8-8fa8-a9e669a16f0f",
        "title": "Regular",
        "price": 100
      }
    ]
  }
}