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
Register your Company
Register your company, configure your services, and obtain your client credentials.
sdk
Get the SDK
Download the SDKs and sample code for your platform (Android, iOS, and Web).
integration
Integrate your App
Start creating your ZenKey solution (Android, iOS, and Web)

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

The SIM Tenure API

Definition: SIM Tenure is the amount of time the SIM card in the end user’s primary device is associated with the end user’s account through a participating wireless carrier.

For the SIM Tenure option, configure the following:

  • User behavior actions to be monitored, such as attempted bank transactions, and/or users/MDNs to be checked for sim_tenure_24.
  • Process for querying the user's carrier.
  • Process for checking sim_tenure_24.
  • Process for inputting the sim_tenure_24 into your existing fraud prevention system.
  • User remediation - actions to be implemented for users whose sim_tenure_24 is false.

Test the option

With the simulator tool and environment of your choice, follow these steps to test your implementation:

  1. Swap a mobile phone's SIM card.
  2. Use the phone to connect to your application.
  3. Submit an API query to the carrier for the phone for it's sim_tenure_24.
  4. Review the response.
  5. Check that the sim_tenure_24 for your phone was input into your test fraud protection system and remediation actions have been set.
@startuml sim_tenure_24participant spbox "jv"
participant score as "fraud score"
participant di as "discovery"
participant auditlogs
end boxbox "mno"participant source
participant CCID_IDP
participant usertraitnote over sp,usertrait
   SP has previously authenticated a user
   and tracked their Sub id
end notesp->sp: identify a usersp->di: call discover
di->sp: latest carrier configsp->sp: generate request
sp->sp: sign requestsp->usertrait: query
usertrait ->CCID_IDP: verify sp authentication
usertrait-> CCID_IDP: verify user has consented SP
usertrait-> source: fetch tenure
usertrait-> usertrait: format response
usertrait-> sp: sim_tenure_24:true|falseusertrait -> auditlogs: usertrait [email protected]

Updated 6 months ago



The SIM Tenure API


Definition: SIM Tenure is the amount of time the SIM card in the end user’s primary device is associated with the end user’s account through a participating wireless carrier.

Suggested Edits are limited on API Reference Pages

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