Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.passentry.com/llms.txt

Use this file to discover all available pages before exploring further.

Geofencing lets your passes show up at exactly the right moment – when a customer is near your store, venue or checkpoint. Instead of relying on emails or SMS, the wallet surfaces the pass automatically based on location. With PassEntry, you can use GPS-based geofences for broader areas like stores or venues or iBeacons for precise, short-range interactions such as entrances, counters or specific sections inside a location.

​
Geofence Notifications

  • When a user enters a geofenced area, a notification appears on the lock screen, displaying a preview of the pass from the wallet app along with any set geofence message.
Custom geofence messages are supported only on Apple Wallet. On Google Wallet, the pass is surfaced using the standard notification header and icon, without a custom message.
  • Tapping the notification opens the pass in the wallet app, facilitating quick access to barcodes or NFC validation.
  • Geofence notifications are passive, meaning the system does not notify PassEntry when a user enters a geofence. This design respects privacy and security considerations.
  • Geofence notifications will remain active and visible until the user has left the geofence.
Note: When setting 2 or more geofences in close proximity, there may be a delay in the notification appearing when moving between geofences. The device implements a cooldown period to ensure that the user has left the previous geofence before entering the next one. You can easily configure geofences using our interactive Pass Template builder:

​
Locations

  • Utilizes exact coordinates (latitude and longitude) to define the targeted area.
  • The radius for geofencing can be set between 10 and 1000 meters (depending on pass type). This allows you to tailor the geofenced area to your specific needs, such as covering the area of a small store or a larger outdoor venue.
Geofence radius configuration is supported on Apple Wallet passes only.
  • Each pass can include up to 10 geofenced locations. For more extensive coverage, consider using beacons.
  • PassEntry is not able to track the exact location of the user, we do not have access to the user’s location data, as this never leaves the device.

​
Google Wallet Geofence Radius

Google’s effective notification radius is determined by Google and may be between 50m and 1000m. The exact value is based on a non-public heuristic, enforced by Google and subject to change without notice.
When configuring geofence locations for Google Wallet passes, Google applies its own logic to determine the effective radius, meaning the actual notification trigger area may differ slightly from your configured value.

​
Beacons

iBeacons are supported only on Apple Wallet passes.
iBeacons are a technology standard developed by Apple that allows mobile apps to listen for signals from beacons in the physical world and react accordingly. The technology is based on Bluetooth Low Energy (BLE) proximity sensing, which enables a device to perform actions when in close proximity to a beacon. PassEntry is not able to track the exact location of the user, we do not have access to the user’s location data, as this never leaves the device. Learn more about beacons here: iBeacon

​
Testing beacons without hardware

You do not need to purchase a physical beacon to test iBeacon behaviour on your pass. Apps such as Beacon Walker (available for iOS and macOS) can broadcast a configurable iBeacon signal from one device, which you can then detect on another device holding the pass. To test:
  1. Install Beacon Walker on a spare iOS or macOS device.
  2. Configure it to broadcast using the same proximity_uuid, major and minor values defined on your pass.
  3. Add the pass to Apple Wallet on a second device and bring it within range of the broadcasting device.
If you have a large number of location you would like to enable geofence capabilities for, here’s an example: Use Case: PassEntry Coffee Chain
  • Scenario: PassEntry Coffee, a chain with 100 locations across London, Dubai, and Singapore, uses iBeacons to offer location-based promotions.
  • Each location is equipped with two beacons: one in the bakery section and another in the cafe section.
  • The PassEntry Coffee loyalty pass incorporates different campaigns across regions, utilizing the same UUID for all beacons but varying Major and Minor values for location and section identification.
  • In total, PassEntry Coffee would purchase and configure 200 iBeacons (100 locations x 2 sections).
Configuration Example
  • UUID: All beacons use E2C56DB5-DFFB-48D2-B060-D0F5A71096E0.
  • Major: Represents the city (e.g., 1 for London, 2 for Dubai).
  • Minor: Specifies the section within a location (e.g., 1 for the bakery, 2 for the cafe).
In this example: PassEntry Coffee would configure their 200 beacons like so: 
London (50 locations):
Bakery Section beacons:
    uuid: E2C56DB5-DFFB-48D2-B060-D0F5A71096E0
    major: 1
    minor: 1
    name: 'london-bakery'
Cafe Section beacons:
    uuid: E2C56DB5-DFFB-48D2-B060-D0F5A71096E0
    major: 1
    minor: 2
    name: 'london-cafe'

Dubai (30 locations):
Bakery Section beacons:
    uuid: E2C56DB5-DFFB-48D2-B060-D0F5A71096E0
    major: 2
    minor: 1
    name: 'dubai-bakery'
Cafe Section beacons:
    uuid: E2C56DB5-DFFB-48D2-B060-D0F5A71096E0
    major: 2
    minor: 2
    name: 'dubai-cafe'

Singapore (20 locations):
Bakery Section beacons:
    uuid: E2C56DB5-DFFB-48D2-B060-D0F5A71096E0
    major: 3
    minor: 1
    name: 'singapore-section'
Cafe Section beacons:
    uuid: E2C56DB5-DFFB-48D2-B060-D0F5A71096E0
    major: 3
    minor: 2
    name: 'singapore-cafe'
When building the pass via the PassEntry API, the following JSON structure would be used to define the beacons: 
{
"beacons": [
    {
    "proximity_uuid": "E2C56DB5-DFFB-48D2-B060-D0F5A71096E0",
    "major": 1,
    "minor": 1,
    "message": "£10 off on cakes!",
    "name": "london-bakery"
    }, {
    "proximity_uuid": "E2C56DB5-DFFB-48D2-B060-D0F5A71096E0",
    "major": 1,
    "minor": 2,
    "message": "Buy one get one free juice",
    "name": "london-cafe"
    }, {
    "proximity_uuid": "E2C56DB5-DFFB-48D2-B060-D0F5A71096E0",
    "major": 2,
    "minor": 1,
    "message": "AED 20 off on cakes!",
    "name": "dubai-bakery"
    }, {
    "proximity_uuid": "E2C56DB5-DFFB-48D2-B060-D0F5A71096E0",
    "major": 2,
    "minor": 2,
    "message": "Try our pumpkin spice lattes!",
    "name": "dubai-cafe"
    }, {
    "proximity_uuid": "E2C56DB5-DFFB-48D2-B060-D0F5A71096E0",
    "major": 3,
    "minor": 1,
    "message": "$5 off on kuih lapis!",
    "name": "singapore-bakery"
    }, {
    "proximity_uuid": "E2C56DB5-DFFB-48D2-B060-D0F5A71096E0",
    "major": 3,
    "minor": 2,
    "message": "Buy one get one free teh tarik!",
    "name": "singapore-cafe"
    }
]
}