BPCE DEVELOPER PORTAL - 89C3 API

Obtenir la liste des bénéficiaires

➤ Prérequis

Cet appel permet de récupérer la liste des bénéficiaires de confiance du PSU (usager d'un service de paiement) pour lequel l'AISP (prestataire de service de paiement) est connecté.

Ce service nécessite que le PSU soit abonné aux services portail de la banque en ligne « Consultation de la listes des bénéficaires (VLCB)» ou « Modification de la listes des bénéficaires (SLCB)».

Un lien self sera présent pour revenir à la page obtenue juste après exécution de la requête.

Les accès à cette méthode sont limités à 4 accès batch maximum par jour calendaire, pour un client, pour un compte ou pour un TPP.

➤ Requête

"GET /trusted-beneficiaries"

➤ Paramètre

Aucun paramètre spécifique n'est requis lors de l'appel à ce service (en dehors du jeton OAUTH2).

➤ Exemple

Requête

GET www.30007.sandbox.api.89c3.com/stet/psd2/v1.6.2/trusted-beneficiaries

Résultat

Status code : HTTP 200

Body

{
 "_links": {
 "self": {
 "href": "https://www.30007.sandbox.api.89c3.com/stet/psd2/v1.6.2/trusted-beneficiaries"
 }
 },
 "beneficiaries": [
 {
 "creditorAgent": {
 "bicfi": "NATXFRPP"
 },
 "creditorAccount": {
 "iban": "FR7630007999999401665105511"
 },
 "creditor": {
 "postalAddress": {
 "country": "FR",
 "addressLine": "Adresse du beneficiaire 75000 PARIS"
 },
 "name": "Tiers1"
 }
 },
 {
 "creditorAgent": {
 "bicfi": "NATXFRPP"
 },
 "creditorAccount": {
 "iban": "FR7630007999990661665104493"
 },
 "creditor": {
 "postalAddress": {
 "country": "FR",
 "addressLine": "Adresse du beneficiaire 75000 PARIS"
 },
 "name": "Tiers2"
 }
 },
 {
 "creditorAgent": {
 "bicfi": "NATXFRPP"
 },
 "creditorAccount": {
 "iban": "FR963000799999866166510BB50"
 },
 "creditor": {
 "postalAddress": {
 "country": "FR",
 "addressLine": "Adresse du beneficiaire 75000 PARIS"
 },
 "name": "Tiers3"
 }
 },
 {
 "creditorAgent": {
 "bicfi": "NATXFRPP"
 },
 "creditorAccount": {
 "iban": "FR813000799999866166510CC17"
 },
 "creditor": {
 "postalAddress": {
 "country": "FR",
 "addressLine": "Adresse du beneficiaire 75000 PARIS"
 },
 "name": "Tiers4"
 }
 },
 {
 "creditorAgent": {
 "bicfi": "NATXFRPP"
 },
 "creditorAccount": {
 "iban": "FR663000799999866166510DD81"
 },
 "creditor": {
 "postalAddress": {
 "country": "FR",
 "addressLine": "Adresse du beneficiaire 75000 PARIS"
 },
 "name": "Tiers5"
 }
 },
 {
 "creditorAgent": {
 "bicfi": "NATXFRPP"
 },
 "creditorAccount": {
 "iban": "FR643000799999A66166510EE10"
 },
 "creditor": {
 "postalAddress": {
 "country": "FR",
 "addressLine": "Adresse du beneficiaire 75000 PARIS"
 },
 "name": "Tiers6"
 }
 },
 {
 "creditorAgent": {
 "bicfi": "NATXFRPP"
 },
 "creditorAccount": {
 "iban": "FR7630007999999661665109960"
 },
 "creditor": {
 "postalAddress": {
 "country": "FR",
 "addressLine": "Adresse du beneficiaire 75000 PARIS"
 },
 "name": "Tiers7"
 }
 },
 {
 "creditorAgent": {
 "bicfi": "NATXFRPP"
 },
 "creditorAccount": {
 "iban": "FR7630007999990771665109968"
 },
 "creditor": {
 "postalAddress": {
 "country": "FR",
 "addressLine": "Adresse du beneficiaire 75000 PARIS"
 },
 "name": "Tiers8"
 }
 },
 {
 "creditorAgent": {
 "bicfi": "NATXFRPP"
 },
 "creditorAccount": {
 "iban": "FR983000799999077166510A044"
 },
 "creditor": {
 "postalAddress": {
 "country": "FR",
 "addressLine": "Adresse du beneficiaire 75000 PARIS"
 },
 "name": "Tiers9"
 }
 },
 {
 "creditorAgent": {
 "bicfi": "NATXFRPP"
 },
 "creditorAccount": {
 "iban": "FR373000799999A77166510A091"
 },
 "creditor": {
 "postalAddress": {
 "country": "FR",
 "addressLine": "Adresse du beneficiaire 75000 PARIS"
 },
 "name": "Tiers10"
 }
 }
 ]
}

➤ Tests d'acceptance

Ces tests ont pour objectif de s'assurer que l'API respecte la norme STET. Ils devraient être validés avant tout déploiement applicatif.

Description du test	Nature du test	Jeu de données
Récupération de tous les tiers de confiance d'un PSU contexte de prise en charge du PSU = BY-AISP scope OAuth2 = aisp	Obligatoire	Persona : Utilisateur : WUBUPA57 Résultat : Restitution de 10 tiers de confiance
Requête HTTP avec un jeton d'accès non autorisé pour la ressource (scope erroné) =>L'accès à la ressource est refusé : code HTTP 403	Obligatoire	Persona : Utilisateur : WUBUPA57 Résultat : Un message d'erreur HTTP403 est retourné
Récupération de tous les tiers de confiance d'un PSU contexte de prise en charge du PSU = BY-AISP scope OAuth2 = aisp code HTTP 404	Obligatoire	Utilisateur : MOVEZY48 Résultat : pas de tiers de confiance (404)