Website integration

integrating your website with ticketmatic is one of the major attention points when implementing ticketmatic general steps to configure step 1 add sales links to your site option 1 manually copy/paste links from ticketmatic to your cms this option is only feasible when integrating a website with a limited number of events per year in the sales flow links section of an event in ticketmatic you can copy the links option 2 retrieve sales links via the api ticketmatic provides you with a sales flow base url e g https\ //apps ticketmatic com/widgets/myaccount/flow/web?event= then you use the api to lookup the events and its associated eventcode the eventcode is passed as a parameter to the sales flow base url api call to retrieve all events and eventcodes https //ticketmatic com/docs/api/events/getlist/ https //ticketmatic com/docs/api/events/getlist/ option 3 retrieve links via a get request to retrieve a json object with basic event information for the chosen flow ticketmatic provides you with a protected json list url https\ //apps ticketmatic com/widgets/myaccount/ticketsalessetup/b8e40ad4 7321 4c1c 8bec 61b40f2e2536/flows/web/events?json=true a json object is returned in the structure as shown below \\{ "account" "myaccount", "ticketsalessetup" "b8e40ad4 7321 4c1c 8bec 61b40f2e2536", "flow" "web", "currenttime" "2020 07 29t14 06 48+02 00", "events" \\\[ \\{ "id" 13354, "code" "175379651962", "startts" "2021 11 26 19 00 00", "endts" "2021 11 26 23 00 00", "name" "the virus is back", "subtitle" "the covid tour", "locationname" "corona club", "webremark" null, "waitinglisttype" 29001, "createdts" "2020 02 26 16 53 50 254943", "lastupdatets" "2020 02 26 16 58 14 932963", "url" "https\ //apps ticketmatic com/widgets/myaccount/flow/web?event=175379651962", "languagespecificurls" \\{ "en" "https\ //apps ticketmatic com/widgets/myaccount/flow/web?event=175379651962\\\&l=en" } } ] } step 2 display availabilities (last tickets/waiting list/soldout/cancelled) option 1 manually modify buttons in your cms option 2 retrieve availabilities via the api you use the api to retrieve the contingent availabilities / waiting list status api call to retrieve all events https //apps ticketmatic com/docs/api/events/getlist/ https //apps ticketmatic com/docs/api/events/getlist/ with this call you retrieve per contingent the availabilities beware that an event can have more than one contingent e g a seated event with three seat ranks will have three contingents for each rank! total total number of tickets for the contingent free number of tickets that is available for sale for the contingent reserved number of tickets in unconfirmed orders for the contingent locked hard number of ‘hard’ locked tickets for the contingent locked soft number of ‘soft’ locked tickets for the contingent sold paid number of sold tickets in confirmed orders that are completely paid for the contingent sold unpaid number of sold tickets in confirmed orders that are not completely paid for the contingent complimentary number of complimentary tickets in confirmed orders for the contingent soldout and cancelled or postponed are event statuses for which it is adviced to manually update the display in the cms optionally custom fields can be added for those statuses in the event configuration, so the status can be maintained in ticketmatic an event is on the waiting list when the waiting list type is either 29002 or 29003 an event is not on the waiting list when the waiting list type is 29001 important waitinglisttype is a global event property and does not reflect the waiting list status per sales channel when a waiting list is activated only for specific sales channels (e g the box office), the event will still get waitinglisttype = 29002 or 29003 this means that checking waitinglisttype alone is not sufficient to determine whether the waiting list applies to your online sales channel to correctly determine the waiting list status for a specific sales channel, use the saleschannels array returned by the get a single event https //apps ticketmatic com/docs/api/events/get endpoint each entry contains a haswaitinglist boolean per sales channel "saleschannels" \[ { "saleschannelid" 2, "haswaitinglist" false, "isactive" true } ] filter on your own saleschannelid and check haswaitinglist only show the waiting list status on your website if haswaitinglist is true for your online sales channel — regardless of the value of waitinglisttype on the event itself step 3 integrate a shopping cart icon on your website more information on how to implement a shopping cart icon can be found here shopping cart icon docid\ huyaksokbbkokaiucsdh9 integrate customer accounts option 1 web sales flow without accounts and logins this option is the most commonly used setup customers do not need to create an account and can quickly order tickets by using their email address first order they make in the system they need to provide their details such as address, phone number and optins for mailings option 2 web sales flow with tm accounts and using tm login when this option is chosen, all sales links need to be setup using a flow that has the withauthentication parameter set to yes when a buyer clicks on such a link and they are not logged in yet, they will be prompted to log in or sign up main advantage of using this approach is that you can flag certain contacts with a relation type in the ticketmatic backoffice and based on this relation type these customers can be given special prices e g gold member, option 3 web sales with own accounts and using own login when this option the website is managing its own logins and creates/retrieves ticketmatic contacts in the backend you can either store the ticketmatic contactid in your own application or store your id as a foreign key in the ticketmatic contact records using a ticketmatic custom field when storing ticketmatic contactids in your own application, the ticketmatic contact deduplication feature should not be used, as you may loose the correct link between your and our database therefore we recommend storing your id in ticketmatic as a foreign key with this option the ticket sales have to be setup using widgets you need to pass a valid ticketmatic contactid to each widget the ticket sales flows cannot be used in this case further information widgets docid\ kffn3s3r0fwccixrah9tn this option has multiple benefits you can maintain a 'my account' section on the website a non exhaustive list of features you could develop allow contacts to update their contact details provide links to download tickets display a calendar with the events of the contact maintain extra info for the contact (images, ) targeted marketing contact support\@ticketmatic com mailto\ support\@ticketmatic com if you need extra information or assistance