How to set up Spektrix Connect as a Source System

Rachael Norris
Rachael Norris
  • Updated

To allow another organisation using Spektrix to start selling your tickets using Spektrix Connect, you’ll need to set up the Agency API and an Agent customer record for them.

User Permissions Sales User, General Administrator and Settings Administrator User Roles
Availability Early access - contact support
Requirements Agency API

Before starting, make sure you’re familiar with:

How to Connect Spektrix as a Source System

If you want to make your Spektrix system a Source System using Spektrix Connect, you’ll need to complete the following steps:

  1. The Agency API must be switched on. If you haven't used it before, contact support.
     
  2. For each organisation you want to work with, create a separate Agent Customer Record. You will need to add both a phone number (that can receive SMS messages) and an email address on the Customer Record.
     
  3. Within the Customer Record, find the Agent panel and click Edit.
     
  4. Check the box to allow the Customer Record access to the Agent API:

    You can also choose to apply an Agent Commission structure to tickets sold through the Agent System at this stage but this is optional.
     

  5. This will prompt you to add a mobile/cell number. The number must be added in international format. +44 for UK numbers, +3 for ROI numbers, +1 for US/CA numbers (for US/CA numbers, enter the number without any parentheses or dashes), +61 for AU and +64 NZ.
     
  6. An API verification code will be generated and sent to the Agent user on the specified mobile/cellnumber. The API verification code is used as a security measure. The Agent user will need to verify that they have received this before they receivethe API key that will allow them to link to your system via the API feed.
     
  7. The Agent will receive an email with a link to the key generation tool. The key generation tool will ask the Agent user for the API verification code which they should have received via text/SMS. Once entered, they will see the API key.
     
  8. Next, you’ll need to supply the Agent System organisation with your client name for them to complete their set up.
     
  9. Finally, configure your Events and Instances to be available in the API. The Agent system can only import and sell Instances that are Visible and On Sale to Agents.

Follow the steps in Setting up an Event for sale through the Agency API to make the Event Instances you want the Agent System to sell available in the API.

You can use the Bulk Instance Update Tool to manage multiple Instances at once.

TIP: You do not need to set up Agency Locks for Spektrix Connect.

Once the Agent System has completed their own set up steps, they’ll be able to start selling tickets for your Event Instances.

 

How to Manage Agent System Sales

Sales made by the Agent System will appear in your system in the same way as an Agency API Order.

You can read more information about searching for and viewing Agent System sales in Searching for Agency API Orders.

Sales are recorded against the Agent Customer Record and will appear as paid by Agent Credit.

The Details Supplied by Agent section will show the customer's name, the first line of their address and the Agent's Order ID. Tickets carry your own barcodes, so they scan at your venue as normal.

The Agent can't pass your Event Instances on to another system. Each organisation must connect to your system directly to sell tickets on your behalf.

Returns and Refunds

If the Agent system processes a return and refund, the same tickets will not automatically be returned in your Source System. 

In this scenario, the Agent System should contact you and ask you to return the Order in your system. You will then need to return the tickets using Agent credit payment/refund, as described in Working with Agents via the Agency API.

WARNING: Refunding the customer in your Agent system does not automatically return the tickets in the Source System. Your organisation may still be charged until the source organisation also returns the tickets.

How to Report and Invoice

You will need to invoice the Agent System organisation to collect funds and settle payments outside of Spektrix.

For more information about which Spektrix reports you can use to do this, read Reporting and Invoicing for Agencies.