imin Checkout Setup

Last updated 3 months ago

Introduction

The Checkout user flow contains a page which enables the user to book activities. Here’s a quick demo of Checkout:

A Guide to Setting Up imin Checkout

You need to complete the actions in these boxes in order for us to setup Checkout for you.

Part I - Information required from you

This page contains a few important characteristics:

Specific branding

The example shown above is for Badminton England, where Checkout has been branded/themed to fit Badminton England’s colours, including the logo in the top left.

What information we require from you:

  • Full brand guidelines if available, or preferred brand colours at a minimum;

  • Logo (in transparent PNG, preferably); and

  • Any specific background images you would like to use (note: you must have licence to use this image). If not, we can select from our library of stock images. Please provide the highest resolution you can, with 1600x880 being the optimum.

This link is an email address that the user will use to ask any questions to you (as the brand providing them the booking).

What information we require from you:

  • The most appropriate email address for users to contact your helpdesk or organisation.

This link takes the users to the terms & conditions governing your provision, and their use, of the booking service.

What information we require from you:

  • The URL that contains the terms & conditions for the service. We have provided you with some standard text to add into your Terms & Conditions that govern imin’s involvement in the booking and payment flow (see “Actions You Need To Complete” at the end of this document).

Confirmation email

Users will receive a confirmation email from the service, which includes details of their booking, barcode for venue entry, etc. This email will have a “From” email address that you can select that represents your organisation.

What information we require from you:

  • Provide the selected email address that will appear in the “From” field for the confirmation emails that get sent to users

Part II - Actions you need to complete

DNS / CNAME settings

Checkout will be hosted on your top-level domain using a subdomain, e.g. checkout.yourwebsite.com.

By altering the DNS / CNAME settings accordingly, when users hit this URL, imin will be able to generate the page they see. It also allows imin to remotely update and resolve any issues.

What you need to do:

  1. Tell us what you want the url of your Checkout to be so we can generate the DNS target.

    • The Checkout domain name must start with checkout., following the format checkout.yourwebsite.com, where “yourwebsite.com” is the name of your domain.

    • Using your chosen domain name, we will create a DNS target for you to add a CNAME, for example, checkout.yourwebsite.com.herokudns.com.

    • By way of example, for www.badmintonengland.co.uk, the domain name chosen was checkout.badmintonengland.co.uk, with the CNAME generated from this.

  2. Add further DNS records to prevent confirmation emails going to the spam folder:

Once you have confirmed completion of this step, we will perform some tests before putting it live on your domain.

Adding a Book Now button

In your user flow, the user will need to perform an action (normally clicking a “Book” button or a link) to indicate they wish to proceed to Checkout, where they can select which session time slot they would like to book, and proceeding to payment.

In order for your branded Checkout to appear, you will need to ensure that the Book button opens the following webpage:

https://checkout.yourwebsite.com/[checkoutUrl]

The checkoutUrl is provided via the imin Search API for bookable sessions. Please note that there are two checkoutUrls provided within the API: a session-level checkoutUrl at root level; and an occurrence-level checkoutUrl for each specific occurrence of a bookable session. You can spot the occurrence-level checkoutUrl because it is has a datetime appended.

For example, for Badminton England, this will be:

https://checkout.badmintonengland.co.uk/fusion-N55USRZ25J59IFY

In this instance, fusion-NN55USRZ25J59IFY is the checkoutUrl provided in the imin Search API for the session that the user is trying to book.

When the user clicks the “Book” button, it should open in:

  • in the same tab for web

  • a SFSafariViewController for iOS

  • a Webview for Android

For more information on the checkoutUrl, please see the slide deck “A Guide to Booking and the checkoutUrl”.

Update your terms and conditions

Your terms & conditions need to reflect the fact that several parties are involved in providing the booking and payment service to the end-user.

What you need to do:

  1. Add the following text into your terms & conditions page (the same page that you provided above for the “T&Cs Link”):

  2. Supply the URL of the T&Cs so we can integrate into the Checkout page.

Every facility offered on this website will be subject to the specific leisure provider’s terms and conditions – you should read these to ensure suitability of facility, venue, any specific dress codes or other important terms prior to making a booking. Please note that all payments made when booking a facility on this website are made through a third party provider, IMIN LTD, a company registered in England and Wales with Company Number 07716450, whose trading address is 14-22, Elder Street, London, E1 6BT. By proceeding with a booking, you hereby agree to comply with IMIN LTD’s terms and conditions, a copy of which can be found here (hyperlink to http://www.imin.co/terms/consumer). At no time will a contract come into existence between you and IMIN LTD as it is only acting as a booking payment portal as between you and the leisure facility provider.