Skip to main content

Overview

In the previous sections of the documentation you created a shop. As you have seen already, the ​OpenTicket provides an interface at https://shop.openticket.tech through which customers can buy tickets. However, you are also able to create such a shop yourself through the ​OpenTicket API. This is done by creating orders. At a high level, this process has the following steps:

  1. The customer reserves a ticket (this reservation is dropped after 8 minutes).
  2. The customer completes their order, that is:
    • The customer supplies the required information.
    • The customer completed the payment for the tickets.
  3. The order is created, and the customer receives their ticket.

In this part of the documentation, you will be guided through this process.

Resources​

Order
Order
Ticket
Ticket
part of
part of
Shop
Shop
refers to
refers to

The Entity Relation (ER) diagram shown above omits some of the associations shown in the previous sections. This is done to keep a clear overview of the resources used in this part of the documentation. The remainder of the section explains the new order resource. You can find the explanation of the ticket and shop resources in a previous section of the documentation.

Order​

Orders are nothing more than the purchase of one or more tickets and have to be stored in the ​OpenTicket system. An order resource is relatively easy to create, but contains a lot of information. It also contains information regarding its associations with ticket and shop resources.

First and foremost, an order should contain the tickets that have been bought. Therefore, it is associated with at least one, but possibly many ticket resources. On the other hand, a ticket can be ordered by many people. Therefore, a ticket can also be associated with none or many order resources. Furthermore, an order always contains the shop through which it was created. This allows you to keep an overview of what tickets have been bought through which shops. You can create an order through exactly one shop, but there are many order resources that can be created by different customers through a single shop.

Notes​

As you will see in the following sections, creating an order is a relatively simple process. However, it is important to keep in mind that most of what is happening is not visible to the customer. During, but also after the creation of an order, you should keep the customer up-to-date with about what is happening with their order. This, for example, can be done by providing the customer with a clear overview of their order after it has been completed.

Furthermore, there are multiple ways to provide a customer with their tickets after their order has been completed. The simplest way is sending the download link to the customer by mail, and this is also how the ​OpenTicket system does this by default. However, you can slightly alter this process if desired.