How do external systems integrate with Line-Up?
By integrating with our API.
Once the external system has done the integration on their side, we will provide them with an API Key so that they can access our software.
What is an API?
It is a process to retrieve data.
Specifically, it is a series of URLs that are used to access software.
If external systems, such as Ticket Agents, want to sell our client's Tickets via Line-Up's software, they will need access to the Line-Up API.
We have more info about the Line-Up API on the Integrations page on our website.
How does Line-Up integrate with other systems?
As well as the API, Line-Up has two integrations you can set up yourself:
Webhooks - send Line-Up data to another system automatically when something happens, e.g. when a Transaction completes.
Mailchimp - sync your Customers to a Mailchimp audience for marketing.
Learn more - Overview & FAQ: Webhooks, Overview & FAQ: Mailchimp
FAQs
What should the Agent do if they have issues with the API?
What should the Agent do if they have issues with the API?
They should contact us directly via our Slack community. If they are not yet a member, ask them to contact Support for an invite.
Which systems are integrated with the Line-Up API?
Which systems are integrated with the Line-Up API?
The list includes Ticket Agents and various partners who we work with to help sell our clients' Tickets.
How does an external system integrate with the Line-Up API if they are not already integrated?
How does an external system integrate with the Line-Up API if they are not already integrated?
Depending on the system and their experience, integration with our API can take as short as a few weeks but sometimes can take a matter of months.
The system has integrated with your API - what next?
The system has integrated with your API - what next?
You will need to give them access to your Event data:
Set up a Channel for them
Give that Channel the appropriate access to the Event(s), Performances and Prices.
When the Channel is set up, we will let you know the API Key for that Channel. This allows them to see the data you give that Channel access to.
Learn more - Guide: Set Up Third-Party Seller
What is an API Key?
What is an API Key?
A code (sometimes called a token) that allows external systems to see the data you give that Channel access to.
As long as the system is integrated with Line-Up, we can generate an API Key for them.
You just need to create a Channel for them and we will send you the API Key for that Channel, which you can pass on.
Is there anything else I need to provide the external system?
Is there anything else I need to provide the external system?
Yes, they will need the following:
The Line-Up API URL - https://api.line-up.tickets/api/
Delivery Method ID - for the Delivery Method that they are using
Payment Method ID - for the Payment Method that they are using
How do I process payments/fees with Agents?
How do I process payments/fees with Agents?
If the Agent is taking payment directly from the Customer, using the Line-Up API, then follow these steps:
Create a Custom Payment Method, e.g. Agent Invoice, for the Agent to use. This will pull through on Line-Up Transactions and Reports.
To receive the payment from the Agent, you'll need to invoice them, using a Report to work out fees/commissions.
When they pay you, they'll need to deduct the commission, i.e. the Adjuster fee you will have created and enabled their Channel for.
If you would like third-party payments to go directly into your account, then you will need to check if they are integrated with your payment provider.
If they are and they have agreed for their Customer payments to go directly to you, then you can add their Channel to the Payment Method you use for online sales (e.g. Stripe, Adyen or Square).
An Agent can't see any of my Performances or Prices in the API.
An Agent can't see any of my Performances or Prices in the API.
This will likely be because their Channel hasn't been added to Performances and/or Variants on your Price Table.
Once you've done that, the best way to check that they have the correct access is by going to Box Office and selecting their Channel. The information that you will see here is what is showing in the API.
If they're saying that they still can't see the data, please ask them to contact us directly on Slack.