Documentation

API OlkyPass – Documentation standard

Introduction

L’objet de cette documentation technique est de décrire les processus de communication entre les systèmes externes et le serveur d’identité bancaire dénommé « OlkyPass ».

Les Services

Sont regroupées sous la dénomination « Services », les actions qui permettent de mettre à jour l’identité bancaire dénommée « ENTITY » de personnes physiques dénommées « NP¹ » et de personnes morales dénommées « LE² ».

¹ Natural Person
² Legal Entity

L’identité bancaire

L’identité bancaire est une notion qui comprend des données d’identification de personnes morales ou physiques liées à des alias.

L’authentification des personnes physiques ou morales comprend deux niveaux : l’authentification simple (ou déclarative) et l’authentification forte.

Les Alias

Les alias sont des informations qui permettent d’identifier des ENTITY, c’est-à-dire des personnes physiques ou morales.
Il existe plusieurs catégories d’alias : MAIL, MOBILE, IBAN, WALLET, CARD TOKEN, KEYWORD, QR CODE.

Les Alias publics

Pour chaque catégorie, un alias peut être déclaré « public ». Cela signifie qu’il permet d’identifier l’ENTITY de manière unique : L’alias public permet d’identifier de manière unique un bénéficiaire ou un payeur pour effectuer une opération de paiement ou de transfert d’actifs numériques.

Il n’est pas obligatoire de rendre public un alias par catégorie. Mais si une ENTITY n’a pas d’alias, elle ne peut jamais être utilisée dans une opération de paiement ou de transfert d’actif numérique. Pour éviter cette situation, il est souhaitable de déclarer au minimum un alias public par ENTITY.

Il peut y avoir N alias de chaque catégorie pour une même personne, mais un seul par catégorie peut être rendu public. L’activation d’un alias public désactive le précédent s’il existait.

Un alias peut aussi être lié à plusieurs ENTITY distinctes. Mais dans ce cas, il ne peut pas être public.

Principales règles des ENTITY

• Les alias sont liés à des ENTITY, personnes physiques ou morales
• Les alias des catégories Mail et Mobile peuvent aussi être liés à une relation {NP LE}.
• Il ne peut exister qu’un seul alias par catégorie lié à une même relation {NP LE}.
• Il y a au maximum un alias public par catégorie et par ENTITY.
• Un même alias ne peut jamais être public pour 2 ENTITY distinctes.
• Deux ENTITY ne peuvent être liées que par un seul lien.

Les relations

• Les ENTITY peuvent être liées entre elles.
• Les liens entre les personnes morales et les personnes physiques {NP LE} permettent de décrire les relations de type bénéficiaire effectifs, mandataires, signataires, etc.
• Les liens entre plusieurs personnes morales {LE LE} permettent de décrire les structures de groupe.
• Les liens entre plusieurs personnes physiques {NP NP} permettent de décrire les relations entre individus, par exemple familiales, associations de fait, etc .

Exemple d’identités bancaires

Dans cet exemple d’identités bancaires, nous trouvons :

• 4 personnes physiques (NP)
• 2 personnes morales (LE)
• 5 liens {NP LE}
• 1 lien {LE LE}
• 1 lien {NP NP}
• 1 alias MOBILE
• 6 alias MAIL dont 2 publics et 2 liés à des relations {NP LE}
• 1 alias KEYWORD public
• 2 alias IBAN dont 1 public

Pierre Pons peut être identifié dans le cadre d’une opération de paiement ou de transfert via son adresse mail pipons@gmail.com car il s’agit d’un alias public. De même, la société Salami SARL peut être identifiée pour un virement ou transfert par ses 2 alias publics contact@salami.com et LE BON SALAMI

La relation entre Pierre Pons et la société Salami SARL utilise l’adresse mail pierre@salami.com

La relation entre Pierre Pons et la société Salaison SA utilise l’adresse mail ppons@salaison.eu

Services OlkyPass

Référence API Identité

Référence API Alias