Let’s get you onboard

Non-Ticketer customers

If you don't use Ticketer ETMs on your buses then you may not be able to make use of live buses or QR codes in myTrip. All is not lost as you'll still be able to be part of myTrip and sell mobile tickets.

If you have a different supplier for live buses or QR codes, then get in touch.

Ticketer customers

Requesting ticketer authorise myTrip

If you use Ticketer ETMs on your buses then you'll need to send them an email on our behalf. This will authorise us to integrate with the Ticketer system, access your live bus data and generate QR codes in the app that scan on your buses.

This process can take a couple of weeks, so we've drafted the email below for you to copy and paste to speed things up.

If you don't have passenger counting set up with Ticketer, you can remove the last bullet point.

To: [email protected]
cc: [email protected]
Subject: Live buses and QR code setup for myTrip by Passenger

Hi Ticketer Support,

I hope you're having a great week. We're having a very exciting time as we're currently onboarding with myTrip by Passenger.

Please take this email as authorisation to provide Passenger with what they need to access our live buses data and generate QR codes for our tickets.

For QR codes, please provide:

• Operator ID

• Private Key

• Public Key

• Session Keys

• Scheme Version

For live buses, please provide SIRI-VM credentials:

• URL (this is normally https://siri.ticketer.org.uk/api/vm)

• Username

• Password (note: the integration doesn't always work with passwords with special characters)

• Please include all our services in the feed

• Please include passenger counting data in the feed

Please direct correspondence to [[email protected]](mailto:[email protected]) and cc myself.

Kind regards,

Setting up your services and vehicles in Ticketer

Your services and vehicles need to be added into the Ticketer Portal before they'll start showing in myTrip. You can start getting them ready now, ahead of the integration being set up. Log in to your Ticketer Portal to get started.

Depending on how Ticketer set up the live buses feed, you may need to manually add in your services for them to start showing too.

The Ticketer Portal will include operator codes, which reference your bus company. These are typically required to match your National Operator Codes. You can change these within the Portal if you need to.

Setting up your tickets

For QR codes to work, ticket products need to be set up in both the Ticketer Portal and in myTrip. Ticketer advise that separate products are set up for mobile to make it easier to differentiate them. This includes different products for each mobile app, if you sell tickets in an app already.

As well as setting up the normal product details, you'll need to decide on a unique "External Identifier" to use for each ticket. These can be up to 4 characters. It's up to you but we suggest using a naming convention like A1DC for Adult 1 day City Zone.

Send us a TransXChange export

We need your network data so we know what services you operate and where your bus stops are. This is provided in a TXC file and should cover your whole network. You should be able to generate an export from your timetabling software. This may result in lots of XML files, which you can add to 1 big zip file.

Take a look at our more detailed TXC guidance to make sure your timetabling software is exporting the right data for myTrip.

The TXC files will include operator codes, which reference your bus company. These codes are typically required to match your National Operator Codes. Please ensure the codes match between your TransXChange and the Ticketer portal. If operator codes do not match then live vehicle location matching is not possible.

If you don't have timetabling software that can generate TXC files then don't panic! You can use the DfT's free tool, available here https://www.gov.uk/guidance/publish-bus-open-data#transxchange. The DfT's friendly support team will be eager to help you if you mention the magic phrase "open data".

Send your TransXChange to [email protected]. Sending it all in 1 go makes things much easier for us.

Once we've imported this into Passenger Cloud and are receiving live bus data (eg from Ticketer) then you'll start seeing your buses moving around in the myTrip app!

We can also host your open data for DfT's BODS service too, but more on that later.

Send us a list of the tickets you want to sell in myTrip

We need to know details about all the tickets you want to sell so we can make them available for sale in myTrip. The easiest way to do this is to fill out our Product list template spreadsheet.

Try to be as specific as you can, especially with things like fixed date school term tickets. Remember that your ticket information needs to be clear and easy to understand so people know which ones to buy.

Send this over to [email protected]

Once you've provided the list of tickets then our commercial strategy team will review your tickets and may provide some feedback.

Fill out the onboarding form

We have a form that helps us capture lots of odd little details that we need to set up myTrip. This saves a lot of back and forth with emails or phone calls.

There's 3 sections in the form and it should only take a few minutes to complete. Once you submit the form, it'll let us know automatically.

Try out a ticket

This is where it gets exciting! Get the myTrip app from the app store if you haven't already and sign up with the same email address you're using to communicate with us.

We'll email a ticket to you or a couple of your staff for you to see within myTrip. You'll be able to use this to get on one of your buses, just like members of the public will be able to when you go live.

You can double check QR codes are working and see what it's going to be like from your driver and passenger perspectives.

We'll also send you a list of boarding codes. These are used for mobile tickets when QR codes aren't available: either if you don't have Ticketer ETMs or as a backup for your drivers to use or if there's any issues with the ETMs. Keep these secure.

Confirm you're ready to accept myTrip tickets

You're pretty much done. Before you go on to the next step, it's worth confirming that you and your staff are ready to accept myTrip tickets. If you have QR codes then your buses will accept them automatically. You'll still need to let your drivers and any support staff know what's going on for a smooth launch day.

Provide your bank details for payouts

Once all the previous steps are ready then we'll provide you with access to Passenger Cloud - our web-based system for managing myTrip.

To start with you won't see much in Passenger Cloud. You'll be able to login and connect your bank account. This is through our payment partner Stripe.

By connecting your bank account to myTrip you are also confirming that you're happy for your tickets to be sold to the public and they will automatically appear in myTrip.

Anyone will be able to find them and buy them for use on your buses. Payments will go into your bank account in line with your operator agreement.

🎉 Congratulations

You have now completed onboarding and are now live with myTrip!

We'll be celebrating you joining us and we hope you'll be just as excited.

At this point you are now in the hands of our very capable support team. If you need to get in touch then email [email protected] and we'll do our best to help.

We'll send over a fancy marketing pack in the next few days to help you promote your mobile tickets to passengers.