Managing Residency
Barkpass allows you to charge different prices based on Residency. This may be useful if you are selling a dog park pass, and you would like to charge a different price to residents and non-residents of a city. It's also useful if you want to restrict a specific pass to residents, like a pet license.
You may also wish to require residents to purchase one pass (like a pet license) before they can purchase a different pass (like a dog park pass). This is the Required Passes feature.
Residency Strategy
Barkpass offers two ways to determine customer residency for your organization:
- Simple city and state match (default)
- Geography-based
Simple Residency Strategy
By default, Barkpass will consider your customers residents if the city and state of the customer address matches the address listed for your organization.
You can verify how many of your customers are considered residents by visiting your Residency Settings page.
Geography Residency Strategy
Some Barkpass customers may wish to define geographic boundaries to determine residency.
Barkpass allows you to create Jurisdictions which are a geographic representation of your organization's residency area.
To create Jurisdictions, visit your Residency Settings page and click Create Jurisdiction.
Creating and Editing Jurisdictions
Barkpass allows you to define geographical areas as Jurisdictions by importing a GeoJSON file. Most GIS software allows you to export existing boundaries using the GeoJSON format.
If you do not yet have GIS software, you can find online software like geojson.io or felt.com to draw your boundary and export it as a GeoJSON file.
Once you've uploaded your GeoJSON file to Barkpass, you can preview a map of the Jurisdiction. Underneath the editor, you may also inspect how many of your customers are considered residents based on this specific jurisdiction.
You can optionally edit the current Jurisdiction's boundaries by clicking the Edit in geojson.io button. This will load your boundary on geojson.io where you can edit it as needed. Then, click Save > GeoJSON in the editor, download the file, and return to Barkpass. Provide the new GeoJSON file in the file input labeled "Update Coordinates from GeoJSON file" and click Save Jurisdiction.
Note: GeoJSON files uploaded to Barkpass must be of type "FeatureCollection" and must have a Polygon feature. The polygon should contain at least one set of coordinates denoting the outer boundary. Optional additional sets of coordinates can be provided within the same polygon to designate "holes" within the area.
Creating Additional Jurisdictions
You can create more than one jurisdiction if desired. Click Create Jurisdiction to add multiple jurisdictions.
When you have multiple jurisdictions defined, a customer is considered a resident if they are part of at least one of the jurisdictions.
Deleting Jurisdictions
You can delete a jurisdiction by clicking Delete on the jurisdiction's edit page.
Note: You cannot delete a jurisdiction if it is the only jurisdiction you have defined and you have set your organization's residency strategy to "Geography-based."
To delete the jurisdiction, either create one to replace it, or change your organization's residency strategy to "Simple" first,
Inspecting Residency Status
On the Residency Settings page, you can inspect how many of your customers are residents and how many customers are non-residents.
You can also search for customers by name, email, address, and more.
Changing Residency Strategy
Change your organization's residency strategy on the Residency Settings page.
After changing residency strategy, customers will receive the new residency classification automatically. The next time they attempt to purchase a pass, the new classification will be in effect.
Changing residency strategy does not impact any existing applications or passes.
You cannot switch to Geography-based residency strategy until you have created at least one Jurisdiction.