ResytechResytech Docs
Plugins

Distance Pricing

Price a ride or a delivery by how far it goes. Guests enter an address on your booking page, see the distance, and book at the price for that distance.

The Distance Pricing plugin is for anything you price by how far it goes: a hotel car service that is free nearby and paid further out, a shuttle, a delivery. You decide the distances and the price for each. Your guest enters an address, and the booking page works out the rest.

It gives you three things:

  • A card on your booking page for each service. It opens an address page where the guest types where they are going, or taps one of your landmarks.
  • A price for each distance. You set bands such as "up to 1 mile", "up to 1.5 miles", "up to 2 miles". Each band books an activity of yours, at that activity's price.
  • Control over who can use it. A service can be on your booking page for everyone, only on an affiliate's signed-in device, only on the pages of your website that name it, or switched off.

This is a feature plugin, so there is nothing to connect.

How it works

  1. The guest picks the service's card on your booking page.
  2. They enter an address, or tap a landmark.
  3. The page shows the road distance from your starting point, a map of the route, and the activity and price for that distance.
  4. They continue to that activity and book it like any other: date and time, guests, payment.

The drop-off address is saved on the booking as the answer to a Drop-off address question, so your drivers see it wherever a booking's answers are shown.

How a distance is measured

  • By road, not in a straight line, from the service's starting point to the address.
  • One way, from the starting point to the address.
  • The same at any time of day. Traffic is ignored, so the same address always gives the same distance.
  • To one decimal. The number the guest sees is the number that decides the price. 1.34 miles shows as 1.3; 1.35 shows as 1.4.

A band covers every address up to its distance and beyond the band before it. If your bands are 1.0, 1.5 and 2.0 miles, an address 1.2 miles away books the 1.5 band. An address beyond your largest band is out of range: the guest is told so and cannot book.

Leave a little room above any distance you have promised someone. Road distance depends on the route, so an address a guest thinks of as "a mile away" can measure 1.1.

What happens to the activities

An activity you use for a band belongs to that service:

  • It can only be booked online through the service. Its own link opens the service's address page instead, for a visitor the service is offered to. Anyone else is taken to your booking page.
  • It is not listed. It is left off your booking page, search by date, your Resytech website and your reseller channels, whatever its own Hidden setting says.
  • It gets a Drop-off address question. If the activity has no Address question, a required one is added when you save the service. The booking page fills it in for the guest, and the dashboard fills it in when your staff book by address. You can rename it, but you can't delete it or change its type while the activity is in a service.
  • Your staff book it by address too. See Booking from the dashboard.

A service needs at least one distance band to be offered. With none, its card is gone and its address page is not served.

Remove the activity from the service to make it an ordinary activity again. It keeps its Drop-off address question, so the bookings already made keep their address, and it is now asked of anyone who books the activity. The setup page names each activity this happens to. If you no longer want the question asked, remove it on the activity's Custom Fields tab.

Setup

  1. Create one activity for each price. See Set up the activities.
  2. Open Plugins → Browse Plugins and click Install on Distance Pricing.
  3. On the setup page, click Add service and fill it in. The fields are described below.
  4. Click Enable. Do this at each location that should use the plugin.

A service belongs to the location you are viewing. Distance Pricing is managed entirely from its setup page and does not add a page of its own to the Plugins menu. To come back to it, open Plugins → Browse Plugins and click Set up on Distance Pricing.

A card can take up to a minute to appear on the booking page after you enable the plugin, add a location's first service, give a service its first band, or turn a service back on. Changes to a card that is already showing appear straight away.

If the setup page says address lookup is not set up yet, contact Resytech support. Until it is, the booking page shows no card.

Set up the activities

Each band books one activity, so you need one activity per price. For a car service that is free within a mile and then steps up:

ActivityPrice
Car Service, Complimentary$0
Car Service, up to 1.5 miles$35
Car Service, up to 2 miles$40

Set each one up as you would any activity: equipment, schedule, guests. Publish them. You do not need to hide them; an activity that belongs to a service is never listed.

If the activities share one vehicle, give them the same equipment and keep Exclusive across activities on, so a ride booked on one blocks the others.

Add a service

FieldDescription
TitleThe card's title on your booking page.
TaglineA line under the title.
Price labelText shown on the card where your theme shows prices, such as "Complimentary within 1 mile". It is never a charge.
Button textThe card's button. Leave it empty to use your theme's own.
Heading and IntroductionShown at the top of the address page. The heading is the title when left empty.
When an address is too farThe message a guest sees when their address is beyond your largest band.
Who can use itPublic, Affiliates, Selected pages or Off. See Who can use a service.
Starting pointWhere distances are measured from. Search for it, pick it from the list, then give it the name guests should see ("From Waldorf Astoria Chicago").
Distance bandsMiles or kilometres, then one row per band: "Up to" a distance, and the activity it books.
LandmarksCommon destinations a guest can tap, in groups you name.

Distance bands

Add a row for each price. The largest distance is as far as the service goes.

For a free ride within 1.3 miles and three paid steps:

Up toBooks
1.3 miCar Service, Complimentary
1.5 miCar Service, up to 1.5 miles
2.0 miCar Service, up to 2 miles

An activity can be used by one service only, and for one band.

Changing a band later applies to addresses looked up from then on. A guest who has already been shown a price keeps it while they finish that booking, including a guest paying from a link an affiliate sent them.

Landmarks

Landmarks save typing for the places your guests ask for most. Add a group (Airports, Stadiums), then search for each place and give it the name guests should see.

A landmark is measured like any address. One that is beyond your largest band shows as out of range, so list the places your service actually reaches.

Who can use a service

SettingWhat it does
PublicThe card is on your booking page for every visitor.
AffiliatesThe card shows only on a signed-in affiliate device. Choose Every affiliate, or Only specific affiliates and tick them.
Selected pagesThe service can be used only from the pages of your own website that name it. It is not on your booking page for anyone else. You can also tick affiliates whose devices may use it. See Selected pages.
OffNobody sees the card, and the service's activities cannot be booked online. Staff can still book through it from the dashboard.

Affiliates needs the Affiliates plugin. A booking an affiliate makes through a service is credited to it like any other booking, and its staff can take payment on the device, send the guest a pay link, or book for payment at pickup, as your affiliate settings allow. A guest who opens a pay link sees the ride they were sent and its drop-off address, without entering the address again.

Turning a service Off, or disabling the plugin, takes effect at once, also for a guest who is part way through a booking.

A Public service is open to everyone who visits your booking page. If a free ride is meant for a hotel's guests only, offer it to that hotel as an affiliate and let its front desk book it, or offer it to Selected pages and put it on a page only those guests are given.

Selected pages

Use Selected pages when a service belongs on some pages of your website and not on your booking page: a page for one hotel's guests, a members' page, a page you link from a confirmation email.

  1. Under Who can use it, choose Selected pages and save the service.
  2. Open the service again. Under Selected pages is a line of button code with a Copy button.
  3. Paste the button into each page that should offer the service. The page needs your Resytech booking script, the same one your Book Now buttons use.

A guest who clicks the button goes straight to the service's address page. Visitors to your booking page, and to every page that does not name the service, are not shown the card and cannot open the address page.

Your developer can also list the service's card in the booking page a whole page opens, without a button of its own. See Services for selected pages.

To let a hotel's front desk book the same service, tick the hotel under Also on the devices of these affiliates. With nobody ticked, no affiliate device is offered it.

The button code holds the service's ID, and anyone who views the source of that page can read it. It keeps the service off your other pages. It does not keep it from someone determined, so do not rely on it alone for something that must stay private.

Changing a service to or from Selected pages applies to every address looked up from then on.

On your own website

A Public service works in the booking page you embed on your own website: its card is on the embedded page like on your booking page. Your developer can also add a button that opens straight on the service's address page, or build the address step into the site itself. See Distance Service Mode.

A service for Selected pages works there only on the pages that name it. See Selected pages.

A service for Affiliates is not offered there. It shows only on a signed-in affiliate device.

Booking from the dashboard

When the plugin is enabled, the Activity section of the New Booking page shows Price by distance, with a button for each service that has at least one distance band.

  1. Click the service.
  2. Search for the drop-off address, or click one of the service's landmarks. The search covers the same area as on your booking page.
  3. The page shows the distance from the starting point, the route map when maps are set up, and the activity that distance books. That activity is selected for you.
  4. Finish the booking as usual: date and time, customer, price.

The booking is created with the drop-off address saved as the answer to the activity's Drop-off address question, exactly as for a booking a guest makes.

Things to know:

  • Every service is available to staff, whoever it is offered to online. A service set to Affiliates, Selected pages or Off can still be booked from the dashboard.
  • An address outside the last band shows the service's out-of-range message and selects nothing.
  • Choosing a different activity removes the address. The address belongs to the activity its distance books. Click Change address to look up another one.
  • An address is good for about 50 minutes. If the page is left open longer, Create booking waits and the page says the address has to be looked up again. Click Look it up again and choose the address once more.
  • You can still pick one of the service's activities from the Activity list. The page then offers the address step for it. If you create the booking without an address, no drop-off address is saved on it.
  • To give a ride at a different price, look the address up and then use Edit price in the summary.
  • If the activity was taken out of the service after you looked the address up, the booking is not created and the page asks you to look the address up again.
  • The activity needs its Drop-off address question. If it has none, the booking is not created and the message says so. Open the service on the plugin's setup page and save it: saving adds the question.

Looking up an address needs the Bookings edit permission, the same one that creates a booking.

Where a service is not offered

  • Partner embeds. A service is never shown inside an approved partner's embedded booking page.
  • Reseller channels. The activities a service books are not sent to OCTO resellers.

What a booking keeps

The booking keeps the drop-off address. It does not keep the measured distance or the map: those are shown on the address page and not stored. The activity that was booked tells you which band the trip fell in.

Uninstalling

Remove your services before you uninstall the plugin. While a service still has activities, the uninstall is refused and says so: those activities are booked only through a service, and would stay off your booking page with no way to change it once the plugin is gone.

To stop offering a service without removing it, set it to Off, or disable the plugin. Both keep everything as you set it up.

Permissions

Setting up services needs the Plugins permission. Booking through a service from the dashboard needs the Bookings edit permission. No extra permission is needed to see the bookings a service produces.

On this page