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:

  1. Simple city and state match (default)
  2. 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 or 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 button. This will load your boundary on 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.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us