Integrating with ZenKey is Easy

Whether you need to register first or are ready to access documentation right away, you’ll find everything you need here to quickly integrate ZenKey and enhance your customer experiences.

Here’s how to get started:
Register your Company
Register your company, configure your services, and obtain your client credentials.
Get the SDK
Download the SDKs and sample code for your platform (Android, iOS, and Web).
Integrate your App
Start creating your ZenKey solution (Android, iOS, and Web)

Need additional help to prevent fraud?
Add Trust Services to your ZenKey solution.
Need additional help to prevent fraud?
Add Trust Services to your ZenKey solution.

Discovery Flows

One of ZenKey's core design features makes a subscriber’s carrier the sole party able to authenticate and capture user consent. This means a central component for merchants integrating with ZenKey is the routing of requests to the correct carrier. ZenKey implemented two different, but complementary methods to enable a merchant to integrate and determine this discovery.

OpenID MODRNA Discovery Flows

The first method is based on OpenID MODRNA discovery flows. This method has two services from ZenKey:

  1. An API layer that, when given the correct discovery variables, returns the configuration for the correct carrier.
  2. An endpoint that is a visual experience for the user. This allows users with the ZenKey application to set up a binding to a secondary device.


Use MODRNA-Based Discovery if...

You want to use an OIDC compliant implementation. Find more information on the MODRNA-based discovery flow here.

Optimized Discovery Flow

The second method leverages a more common OpenID auth request process. In this case, merchants redirect the user to ZenKey who redirects them to the correct carrier after discovery is complete. Using this process, merchants must contact the ZenKey discovery issuer after the auth code is received so that merchants can route their token and UserInfo API calls to the correct carrier endpoints.


Use Optimized Discovery if...

you are looking to reuse existing OpenID connect logic and code. Find more information on the optimized discovery flow here.

Updated 6 months ago

Discovery Flows

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.