Skip to main content
Learn how to verify closed consumer groups using Beans iD Whitelabel API. Use Beans iD Whitelabel API to verify the closed consumer group status of your users so you can provide them with savings, exclusive to them. Beans iD Whitelabel API allows you to:
  • Verify a users status from up to 10 consumer groups in over 100 countries
  • Take complete ownership of your customer experience & provision a consumer group status against your existing user accounts
  • Build customer loyalty, retention & LTV

​
The Challenge

  1. You want to grow your loyalty program with consumer group benefits, but don’t know where to start.
  2. You’re already running consumer group offers, but:
    • They have no link to your loyalty program, meaning an affiliate is controlling your data, SEO and user experience.  
    • Your offer program lacks a network of pre-verified users and advertising opportunities.
    • You don’t have one partner that covers all consumer groups and all countries across your website, app and stores.
  3. You want end to end control of the customer experience and do not want any third parties present on your application(s)

​
The solution

You’re in control of your offering, so start by setting up that communication to your users. The type of offering you put forward will be unique to your businesses goals, ambitions and user expectation. The four most common styles of offering are:
1

Create your offering

  • Automatic saving applied at checkout (15% off when you connect your [insert chosen consumer group] status)
  • Points based loyalty (Double points each time you purchase when you connect you [consumer group] status)
  • Loyalty ‘free item’ (Get x free when you buy y on [day(s) of the week] when you connect your [consumer group] status)
  • Loyalty subscription (Get [subscription] for £7.99 a month when you connect your [consumer group] status instead of it’s £10.99 a month)
2

Verify user’s consumer group status

Customers quickly and securely verify their consumer group status using our Whitelabel API.
3

Enable offering

You take the successful consumer group verification and provision the users account that you hold with that status. They will then have access to the offering you’re looking to provide, and will not need to continue to verify their status unless it moves to an expired state.

​
How to Integrate

The integration method we have available is a combination of simple API requests and a very low weight script which is fully customised to look and feel exactly like your application.

​
Start a verification

Your users are already logged in. You create a verification request and send a users basic user information to us.

​
Verify the user

We handle the entire verification journey for you. Choose between a seamless embedded script that keeps users on your site using our embedded UI, or a hosted implementation that directs them to a dedicated whitelabel verification page which is customised to look and feel like your brand.

​
Get the verification result

We will provide a verification result for the consumer group verification request. This allows you to provision your user with a consumer group status, giving them access to the offering that you would like to provide.

​
Beans iD Whitelabel API Technical Documentation

For in-depth guides on how you can integrate with Beans iD Whitelabel API to verify your users, see our technical documentation below:

🧩 Embedded Implementation

Verify your users’ consumer group status using a seamless, Pion-powered interface that lives within your own UI via a simple script.

🔗 Hosted Implementation

Verify your users’ consumer group status using a dedicated whitelabel verification page which is customised to look and feel like your brand.

🌐 Native Implementation

Verify your users’ consumer group status using your own UI and hook into our best-in-class verification service via our Pion API endpoints.