Aller au contenu principal

Vérification d’identité et alias

Avant un transfert inter-participants, identifiez le payé par son alias ou par son compte. Présentez au client le nom et le pays trouvés avant de recueillir sa confirmation.

Vérifier un compte​

Sous /api/v1/{participantCode} :

  1. Appelez POST /identity-verifications avec accountId, payeeAgent et, si nécessaire, iban et endToEndId.
  2. Conservez verificationId et la consultation de Location.
  3. Lisez GET /identity-verifications/{verificationId} jusqu’au résultat ; les données du titulaire sont disponibles pour une vérification positive.
  4. Pour la route directe du transfert, réutilisez l’EndToEndId de cette recherche. Le parcours /transfer-initiations réalise cette coordination pour vous.

Le drapeau IBAN ne se choisit pas pour forcer le format d’un compte : il doit correspondre à son format et au participant payé. Le cœur vérifie cette cohérence.

Résoudre un alias​

GET /aliases/{key} exige l’en-tête x-pi-EndToEndId du transfert à venir. Utilisez une recherche pour cette opération ; la consultation du registre local n’est pas un substitut à la recherche préalable distante.

Gérer les alias​

La référence expose la création, la modification, la suppression, les initiations avec confirmation et les revendications. Les écritures d’alias demandent une clé d’idempotence selon la route ; consultez les en-têtes obligatoires dans la référence.

La gestion des alias doit rester liée au titulaire du compte et aux contrôles du participant, notamment pour la preuve de possession d’un numéro mobile. Les contrôles du cœur et du contrat PI-RAC s’ajoutent à la forme du corps : ne déduisez pas toutes les règles métier de la présence d’un champ dans un schéma.

Pour les opérations de masse, utilisez /alias-bulks et son suivi par élément. Les états incertains exigent une résolution avant une nouvelle action ; voir les reprises.

Revendications​

POST /aliases/{key}/claims initie une revendication. Consultez /alias-claims/{id} et utilisez ses routes d’acceptation ou de rejet selon le rôle du participant. Une revendication ne remplace pas une création d’alias et ne garantit pas une attribution immédiate.