Allowed registration URLs

The purpose of this feature is to provide mobile apps with a means to allow unregistered customers to complete their Perkville registration within their mobile app. This ensures that the Perkville cookie resides in the mobile app, allowing the customer to avoid logging in again after registering. Without this capability, customers will likely be directed to their default browser to complete their registration, necessitating a subsequent login within the mobile app to access Perkville.

The mobile app may feature a link for the business's loyalty program, enabling customers to view their points, redeem rewards, and register for the program if they haven't already done so. When a customer enters their email (or if the email is pre-populated by the app) on the program's registration page, Perkville sends an email prompting them to complete their registration. The "Allowed registration URLs" feature supports the business in including a "register_at" parameter in the original link to Perkville (within its mobile app) to direct customers back to the mobile app to complete registration, ensuring the Perkville cookie is tied to the app.

How It Works

To facilitate in-app registration, businesses can add an optional "register_at" query parameter to the loyalty program URL within their app. This allows customers to register for Perkville directly within the application.

https://mybiz.perkville.com/?register_at=myapp%3A%2F%2F

When the customer accesses this URL while logged out and begins the registration process, they will receive an email containing a link similar to this:

myapp://?registration_url=https%3A%2F%2Fmybiz.perkville.com%2Fregister%2F123registrationcode%2F%253Fnext%253Dhttps%253A%252F%252Fmybiz.perkville.com%252F

When the customer clicks the link provided in the Perkville registration email, your application must decode the "registration_url" query parameter and open the registration URL within your in-app browser. This allows the customer to complete the registration process in your mobile app.

Important Considerations

• The "register_at" parameter must be added to your business's list of Allowed registration URLs in the Advanced Settings of Perkville. If the URL is not authorized, the customer will be directed to a standard registration URL.

• The registration URL must be either your business's custom domain or a subdomain of Perkville (e.g., https://rewards.client-custom-domain.com/ or https://client.perkville.com/).