09. Creating a Client

Once your customer has selected a ticket group from an event landing page it is time for the checkout process. 

New Customers

If this is a new customer, you must first create a Client before an Order can be created. Clients can, and in many cases must, also have related properties including, Company, Email Address(es), Phone Number(s), Address(es) and Credit Card(s). You can choose to create these related items, except for Credit Cards, at the same time you create the client or you can create each item individually using the specific endpoints. 

Returning Customers

Although Ticket Evolution does not provide you with the mechanism in which you can verify and authenticate returning customers, we do provide you with the ability to re-use existing Clients and their properties. Doing so will allow you to make subsequent purchases easier and faster as well as access your Client’s purchase history.

Once you have verified and authenticated a returning Client you can utilize the existing client_id for new orders as well as to present existing Email Addresses, Phone Numbers, Addresses and Credit Cards to make the check out process quick. If necessary, you can create additional of each of these items and even update existing ones as necessary.

Creating a Client with Related Properties with a Single Request

In the examples below we will create a Client named Ned Flanders who works for a Company named “The Leftorium” and has home and work Email Addresses and Addresses as well as home, work and cellular Phone Numbers in one single API request.

Creating a Client with Related Properties with Multiple Requests

In the examples below we will create the same Client and properties as above using separate requests to each endpoint.

Create the company

Create the Client using company_id 11228 which was in the response of the Companies / Create POST.

Create the Email Addresses using client_id 168188 which was in the response of the Clients / Create POST.

Create the Addresses using client_id 168188 which was in the response of the Clients / Create POST.

Create the Phone Numbers using client_id 168188 which was in the response of the Clients / Create POST.

Managing Client Properties

If you are going to offer a way for your Clients to have an account you should be sure to offer the ability for that Client to manage all of their related properties and add/delete/update items like Phone Numbers, Addresses, and Email Addresses. The Ticket Evolution API offers all of the endpoints necessary to offer this type of management. You can find the technical details under the documentation for each endpoint.  

A good example of how such properties can be managed at checkout—and also within a client profile section—is Amazon.com as shown below.