The Identiway Developer Hub

Welcome to the Identiway developer hub. You'll find comprehensive guides and documentation to help you start working with Identiway as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Support

Getting started

Introduction

The Identiway service allows Donors (banks, telcos, national ID schemes, Identiway services, ID scanning) to share their customer data with Recipients (sometimes also referred to as Merchants) in a unified and dynamic manner using OAuth 2.0. In the Identiway system user data is called attributes and can be dynamically configured both from the Donor and Recipient sides.

Overview

In order to integrate Identity service you will need to do the following steps:

1) Sign up (contact sales@identiway.com)
2) Get your Unique Id
3) Get your Recipient Id
4) Get your API credentials
5) Embed idt.js to your website (Donor discovery) or use the Discovery API
6) Server-side implementation (Data retrieval)

Unique Id

Location in the control panel:

Recipient Id

Location in the control panel:

API credentials

Location in the control panel:

Data Attributes

Recipients can configure which user attributes they want to receive and which of them are required. If the required attribute is missing in the Donor system, this donor will not be shown to the user.

List of commonly used attributes (more or less attributes might be available depending on which Donor(s) are used):

Name
Type
Description

first_name

string

First name

last_name

string

Last name

personal_number

string

National personal number

country

string

Full country name

city

string

Full city name

address

string

Full address

phone

string

Phone number

email

string

Email address

document_number

string

Document number (e.g. passport number or ID document number)

document_expires

string

Expire date of the document

Getting started