Consommer l'API
La description des services proposés ci-après n’est que purement fonctionnelle. Les aspects techniques sont répertoriés dans la rubrique "Cas d’usage" > "Transmettre un dossier de financement" qui sont plus détaillées.
➤ Pré-requis
- Le partenaire doit signer une convention de partenariat avec l’établissement, ou la banque
- L’éditeur doit délivrer un certificat qu’il aura demandé et obtenu préalablement à une autorité de certification reconnue ; lors de la demande de GO-LIVE (validation technique faite par BPCE-IT).
- Le partenaire doit obtenir ses identifiants de connexion BPCE, à partir de l’Extranet Partenaires
➤ Cinématique globale de consommation de l'API
Création d'une application
L’API "Transmission de demandes de crédit immobilier" (ou API "Injection de données") est privée : vous devez vous inscrire sur le portail en créant un compte professionnel (sélectionnez "développements professionnels" dans la liste proposée).
La création de votre compte professionnel fait l’objet d’une validation par l’équipe Portail 89C3 (délai J+1 ouvré)
Vous devez, à partir du menu "Application", créer votre application concernant l’API "Injection de données" :
A la validation, vous arrivez sur l'onglet de gestion des identifiants de l'application :
Il faut générer l’identifiant OAuth (la clé d’APIs est inutile pour votre cas) en cliquant sur le bouton "Générer", il vous permet de récupérer l’IDClient et de préciser l’URL de redirection (qui doit être fournie par le partenaire) :
Vous devez fournir l’URL de redirection :
Vous devez identifier la clé secrète en cliquant sur le symbole identifié dans l’écran portail , onglet authentification, ligne identifiants OAuth :
Demande de GoLive
Vous devez saisir une demande de GoLive (formulaire) pour consommer l’API "Transmission de demandes de crédit immobilier".
Depuis le portail, sur notre application, vous devez cliquer sur le bouton "Demander GoLive" et vous devez remplir le formulaire demandé.
Saisie du Formulaire de demande de GoLive
Vous devez saisir des informations concernant votre entreprise et votre application.
Vous devez également télécharger la clé de votre certificat (.pem) et la joindre dans le formulaire.
Etapes de validation obligatoires suite à la demande de mise en production :
- Demande GoLive
- Validation technique (validation du certificat)
- Validation juridique (contrôle des contrats juridiques signés entre le partenaire et l’établissement/banque)
- Validation API Owner
- Etape finale
- Accès live