Introduction
What is Spektrix
Spektrix is an integrated ticketing, marketing and fundraising solution for arts, cultural and entertainment organisations, built around cloud-based, Software as a service (SaaS) technology. We enable our users to sell tickets, memberships and merchandise, accept donations, and build long-term relationships with their audiences and donors. We do this with an all-in-one approach combining software, insights and business services, a powerful network of partners offering consultancy, web services and software solutions, and a vibrant user community.
Terminology you will encounter in this documentation:
- Client refers to an organisation which uses Spektrix (e.g. a theatre / production company / venue). Each Client has its own Spektrix system, identified by a unique client name.
- User refers to a member of staff in a client organisation, such as a Sales Manager or Marketing Manager.
- Customer refers to the clients’ end users (e.g. ticket buyers).
- You / Web partner / Tech partner / Ticket Agent refers to the organisation or individual that is responsible for building the integration.
Resources
- Refer to our glossary for Spektrix specific terminology for the building blocks of the system
- Add your profile to the Spektrix Partner Directory to connect with Spektrix clients and prospects
- Understand how we work with partners, and what to expect from us as you build an integration
Configurable, never customisable
Spektrix is designed to be a single product that is highly configurable by clients. Though the system can be powerful to clients straight out of the box, no two clients’ businesses are the same and different solutions are required for each.
What this means for you, is that identifying a client’s business priorities will be key to creating a successful integration with Spektrix. These business priorities – specifically pain points and desired outcomes – will depend on the client’s unique needs and determine the best way of configuring their system. These needs may be based on:
- The size of the organisation
- The type, number and frequency of events they put on
- The type and number of customers they welcome
- And many more factors that comprise the client’s business model. This is a non-exhaustive list.
This documentation covers:
- Technical how-to for web partners, tech partners and sector partners such as ticket agents building website integrations and partner products that integrate with Spektrix, using any of the integration tools.
- Best practice and use cases which can inform clients and partners on how to make the most out of Spektrix in order to fulfil business needs/priorities.
For web partners working on a client website
Spektrix hosts all the data that powers our clients’ ticketing, marketing and fundraising operation. We don’t host clients’ websites. Instead, we provide functionality which allows you to integrate Spektrix with the client’s website, which then allows customers to, among other things, access their online accounts, book tickets, make donations, purchase subscriptions (and more) without leaving the client’s website. Spektrix does all the heavy lifting to implement the complex logic of purchases.
In order to achieve the best possible integration between Spektrix and the client’s website, we offer open access to our integration tools to all clients and their partners.
Integration tools
Spektrix provides 3 tools that can be used to build the integrations for the two sections of the booking journey:
- A set of unstyled embeddable iframes
- A RESTful, JSON-based API
- A set of web components
Web integrations do not require a binary decision on which tool to use. No one tool is better than the other – rather, they are each capable of different results and are designed to work in tandem with each other. By mixing and matching our integration tools, you can configure the online customer journey based upon the client’s priorities and business needs. Our tools offer solutions to our clients varying on their needs based on the:
- Resources of the organisation
- Web partners’ expertise
- Specific user journey requirements dependent on business priorities
Every step of the booking journey should be an opportunity for the client to evaluate priorities and decide where to invest their resources if they need customisation to fulfil their needs.
Booking journey
The booking journey can be split in two sections:
- Displaying information independent of current transaction or logged in customer, such as displaying the catalogue of Spektrix items the client is selling (events, donations, merchandise, memberships, ticket information)
- Displaying and writing back to the database information that dynamically changes depending on the current session and logged in customer, such as contents of basket and logged in customer details, purchase details.
How to use the Spektrix Integration tools and possible combinations
1. To display information independent of current transaction or logged in customer:
Iframes
- The content of our iframes is standardised, but there are options to add some custom messaging.
- The sequence of iframes is standardised, with specific options on entering and leaving the iframe journey.
- We provide iframes with no styling, so that you can add CSS and style them according to the look and feel of the rest of the website for a seamless online experience.
- Most clients are likely to have an iframe for the seat selection, as this part of the booking journey is complicated to rebuild.
- Select to use iframes for parts of the customer journey where an investment to a custom approach is not proportionate to the client’s needs.
API server side
- This approach offers more flexibility in design and more flexibility in user journeys.
- It can be used to provide expanded functionality beyond the standard Iframes, should a custom approach be required.
- You can use the API to retrieve information on Events, Instances, Pricelists, Funds and then use that to power customised pages you’ve designed, such as event calendars or special landing pages.
- The API is available for website integrations in two modes:
- Web mode exposes public information, reflecting the information available via the iframes. Most website integrations only use Web mode.
- System Owner mode requires authentication and enables full access to the entire system, including objects not available via the Iframes. Most website integrations do not require authenticated calls.
- Only GET calls should be made in server side API integrations.
- The API can also be used to integrate with the CMS of your choice. This allows the client to keep Spektrix as the source of truth and reduce double entry of data in both Spektrix and CMS.
- A server side session can't be shared with an iframe.
- New integrations should use the current version of our API v3. API v1 and API v2 are our legacy APIs and we no longer support this version for new integrations.
Web components (donations, memberships, merchandise, gift vouchers)
- Custom components built off the Spektrix API v3 that can provide an enhanced customer experience for purchasing these four Spektrix items: merchandise, gift vouchers, memberships and making donations.
- The component itself contains the functionality to display and add to basket these four items. You unlock that functionality by placing your own markup within it. We are providing the components to allow you to ship units of business logic to the client’s pages without having to write any Javascript (if you don't want to).
- Efficient to deploy, offering flexibility in design.
- Not available for all Spektrix items, notably not available to buy tickets.
2. To display and write back to the database information that dynamically changes depending on the current session and logged in customer. Booking journeys built with a combination of the integration tools pass on session information via a Session ID.
Iframes
- The content of iframes is standardised, but there are options to add some custom messaging.
- The sequence of iframes is standardised, with specific options on entering and leaving the iframe journey.
- We provide iframes with no styling, so that you can add CSS and style them according to the look and feel of the rest of the website for a seamless online experience.
- Most clients are likely to use iframes for Checkout, as payment processing is not currently available via any of the other Spektrix integration tools.
- Select to use iframes for parts of the customer journey where an investment to a custom approach is not proportionate to the client’s needs.
API client side
- This approach offers more flexibility in design and more flexibility in user journeys.
- It can be used to provide expanded functionality beyond the standard Iframes, should a custom approach be required.
- Client side calls support GET, POST, PATCH, PUT and DELETE methods.
- This section of the booking path uses Web mode, reflecting the information available via the iframes.
- You can use the API to retrieve information on Basket, Customer and then use that to power customised pages you’ve designed, such as a custom basket. You can also send (POST) items to the basket and amend them once in the basket (PATCH, DELETE). You can edit Customer information (PATCH, DELETE)
- A session cookie must be explicitly included in the calls to ensure the session is carried over between sending and retrieving information.
- New integrations should use the current version of our API (v3). API v.1 and API v.2 are our legacy APIs and we no longer support this version for new integrations.
Web Components (logged in status, basket summary)
- Custom components built off the Spektrix API v3 that can provide an enhanced customer experience by providing clear information to customers about their login status and what’s in their basket at all times.
- They don’t replace the normal flow of your site, but rather complement it.
- The component itself contains the functionality to dynamically display information. You unlock that functionality by placing your own markup within it. We are providing the components to allow you to ship units of business logic to the client’s pages without having to write any Javascript (if you don't want to).
- Efficient to deploy, offering flexibility in design.
CMS
Spektrix does not provide a CMS solution. It is CMS agnostic and can be integrated with any CMS. We don’t offer plugins to integrate CMS with Spektrix, however we have various web partners who have developed their own tools and plugins.
Full list of API endpoints can be found here.
For tech partners building a partner product
The multi-tenancy of our platform means that each client has their own separate database on a shared deployment. Clients are always running the same single version of Spektrix and we maintain consistency in our API, so integrations are compatible with all of our clients.
There are two ways you can integrate with Spektrix:
- Our API is open to access for you to build an integration with your own product.
- The API is two way, allowing you to retrieve and write back information.
- Available in:
- System owner mode which requires authentication and gives you access to the overview of the system. Most partner products, for example EPOS, ticket kiosks, streaming, require System owner mode, because they are updating customer records, processing orders etc.
- Web mode which gives you access to public information only. This may be used for example to build a listings aggregator site where all of the info is public.
- Note that processing card payments processing is not possible by the API, although you can mark transactions as being paid for with a Custom Payment.
- Full list of API endpoints is here.
- We provide various different ways to format data held in client databases, in both human and machine-readable formats. If you are looking to build a revenue management or customer analytics solution, this will likely be your point of entry. Please note don’t have a reporting API.
For ticket agents
The Agency API feed allows ticket agents to gain live access to sell for or on behalf of a client. This allows a flexible working relationship by allowing agents access to live inventory in real time, all selling from the live plan alongside customers online and client users.
We have a list of agent API endpoints and a sample approach for ticket agents to integrate with Spektrix.
Support
As you're building your integration with Spektrix, get in touch with our support team who can provide consultancy and troubleshooting. There is no fee for this for any partner working with a client or building a partner product.
You can reach us via
- email to support@spektrix.com
- phone at 0207 183 3586 (UK/IE) or 1-800-961-5971 (US/CA)
Please ensure you include:
- The type of integration you are building (web, partner product, ticket agent).
- The name of the client you are working with, if applicable.
- Any deadlines we should be aware of.