Toki.

Docs/Merchants/Wallet Passes

Location notifications

Last updated

Location notifications turn your wallet pass into a gentle nudge at the right moment. When a customer who has your pass in Apple Wallet is near one of your stores, their iPhone shows a notification on the lock screen with a message you choose. It's a simple way to remind people to scan their pass, use their balance, or just come in.

How it works

You add one or more locations to a pass. Each location is a point on the map (latitude and longitude) plus the text to show in the notification. When the customer's phone is near that point, it shows your message.

You don't set a distance. Apple Wallet decides when the phone is close enough to the point and shows your message on the lock screen.

Location notifications are a feature of the Apple Wallet pass. Customers who save the Google Wallet version get the same card, fields, and QR code; the locations you add apply to the Apple Wallet pass.

Add a location

  1. Open Wallet Passes.
  2. Click New to start a new pass, or click Edit on the pass you want to change.
  3. Scroll to the Locations section.
  4. Click Add Location. A new block appears, labeled Location 1, Location 2, and so on.
  5. Fill in the fields (see the table below).
  6. Click Save in the save bar at the top of the page.

Repeat for every store you want to cover. There is no set number — add as many locations as you have stores.

Location settings

FieldWhat it does
Relevant TextThe message shown in the notification, for example "You're near our Main Street store — show your pass for a free coffee."
LatitudeThe north–south coordinate of the location, in decimal format (for example 40.7128).
LongitudeThe east–west coordinate of the location, in decimal format (for example -74.0060). Locations in the Americas have a negative longitude.

Enter the coordinates by hand for each store. Most map apps show a place's coordinates when you look up its address. Copy them as decimal numbers with a dot, not degrees and minutes. In Google Maps on a computer, right-click the place: the coordinates appear at the top of the menu, latitude first, and clicking them copies them.

The pass appears near your stores only on phones with Location Services turned on, since the phone has to know where the customer is.

Remove a location

  1. In the Locations section, find the location you want to remove.
  2. Click the trash icon next to its heading.
  3. Click Save.

To change a location instead, edit its fields and click Save. Click Discard in the save bar if you want to go back to the last saved version.

Related

Didn't find what you need? Chat with us — a human answers, usually within the hour.