Magazine
Annonce

L’API Memo Bank est disponible

21 juillet 2022

icon dot
icon clock

5 minutes

Notre équipe technique est très heureuse de vous annoncer la naissance de l’API Memo Bank, une API qui va vous permettre de gérer vos comptes Memo Bank sans passer par votre espace Memo Bank.

AP qui ? AP quoi ?

Si vous découvrez la notion d’API en lisant cet article, dites-vous qu’une API (application programming interface) est une interface qui permet à des machines de communiquer entre elles selon un protocole établi à l’avance. Une API n’est ni plus ni moins qu’un ensemble de règles, qui disent en gros « si vous envoyez telle requête à tel endroit, vous recevrez telle réponse avec tels éléments dedans ». Bien que leur maniement requiert des compétences techniques pointues, les API sont présentes dans de nombreux services destinés au grand public. Et ça ne date pas d’hier. Quand vous appeliez l’horloge parlante dans votre jeunesse (au 36 99), vous utilisiez une API sans le savoir. L’horloge parlante avait un numéro de téléphone spécifique, et sa réponse contenait toujours la même chose, à savoir des données horaires structurées (date et heure). C’était une sorte d’API horaire.

De la même manière, pour connaître le solde de votre compte Memo Bank sans passer par votre espace Memo Bank, il vous suffit d’envoyer une requête GET sur notre API, à l’adresse https://api.memo.bank/v1/accounts/{id} — où {id} correspond à votre numéro de compte Memo Bank. Ici, la requête GET tient lieu de coup de fil et l’adresse web (URL) joue le rôle du numéro de téléphone, mais le fonctionnement reste le même que celui de l’horloge parlante : un numéro spécial permet d’obtenir une information spécifique. Une fois votre requête GET envoyée à notre API, vous recevrez une réponse structurée, qui contiendra votre solde. Comme la réponse envoyée par notre API arrivera directement dans votre système, vous pourrez l’exploiter dans votre outil de gestion, sans passer par votre espace Memo Bank.

Ce n’est pas très spectaculaire dit comme ça, mais une fois intégrée dans votre système, une bonne API peut vous faire gagner énormément de temps, en vous dispensant de réaliser à la main tout un tas de tâches rébarbatives. L’intérêt des API tient aux fait que vous pouvez créer des enchaînements d’instructions techniques, pour faire en sorte que tel évènement sur votre compte débouche sur telle action. L’API Memo Bank peut par exemple vous avertir quand vous recevez des fonds sur votre compte courant, et moyennant un peu de développement, vous pouvez utiliser cette information pour exécuter un virement sortant de votre côté, dans la foulée, automatiquement. Tout ce qui nécessitait jusque-là des clics sur votre espace Memo Bank peut être remplacé par une série d’actions déclenchées par des requêtes sur notre API.

Une seule API pour tout faire

En quoi l’API Memo Bank est-elle différente des autres API bancaires disponibles sur le marché ? Nous ne sommes pas la première banque à proposer une API, loin s’en faut. Mais contrairement aux banques traditionnelles, qui proposent parfois des dizaines d’API différentes faute de trouver un dénominateur commun à leurs nombreuses briques techniques, nous vous proposons une seule et unique API. L’API Memo Bank est une API indivisible, intégrée, qui vous permet de tout faire au même endroit. C’est moins de temps d’intégration pour vos équipes techniques et moins de dépendances à gérer par la suite pour vous.

Actions disponibles (endpoints)

Avec l’API Memo Bank, vous pouvez réaliser les actions suivantes, dans les domaines suivants.

Comptes courants

  • Obtenir le détail d’un compte courant : nom du compte, solde, IBAN…
  • Obtenir la liste de vos comptes : avec leur nom, leur solde…

IBAN

  • Obtenir la liste des IBAN liés à un même compte courant
  • Créer un nouvel IBAN virtuel (utilisable immédiatement)
  • Obtenir les caractéristiques d’un IBAN
  • Supprimer définitivement un IBAN existant
  • Mettre à jour un IBAN pour modifier son nom

Transactions

  • Obtenir les détails d’une transaction : date, montant, libellé…
  • Obtenir la liste des transactions liées à un compte courant

Pièces jointes

  • Obtenir le détail d’une pièce jointe : nom, taille, type mime…
  • Supprimer définitivement une pièce jointe existante
  • Obtenir la liste des pièces jointes liées à une opération donnée
  • Importer et lier une pièce jointe à une opération existante

Virements SEPA

  • Exécuter un virement SEPA sur le champ (standard ou instantané)

Voilà pour les endpoints disponibles dans la première version (v1) de l’API Memo Bank.

Notifications possibles (webhooks)

L’API Memo Bank peut aussi vous envoyer une requête HTTPS quand un évènement particulier a lieu sur votre espace Memo Bank. Libre à vous d’utiliser ces notifications pour effectuer des actions sur votre compte Memo Bank, toujours par le biais de notre API. Voyez ça comme le premier maillon d’une possible chaîne d’actions réalisées automatiquement.

Les évènements suivants peuvent faire l’objet d’une notification de notre part.

Comptes courants

  • Un compte courant est créé
  • Un compte courant est mis à jour (changement de nom par exemple)
  • Un compte courant est clôturé

Pièces jointes

  • Une pièce jointe est créée
  • Une pièce jointe est supprimée

IBAN

  • Un IBAN est créé
  • Un IBAN est mis à jour (nouveau nom par exemple)
  • Un IBAN est supprimé

Transactions

  • Nouvelle transaction à venir (un prélèvement à venir par exemple)
  • Nouveau virement sortant programmé depuis votre espace Memo Bank
  • Transaction rejetée (l’opération est refusée et rien ne change)
  • Transaction autorisée (les fonds sont mobilisés)
  • Transaction confirmée (les fonds sont définitivement débités)
  • Transaction annulée (les fonds jusque-là mobilisés sont libérés)

Exemple d’utilisation de l’API Memo Bank

Que peut-on faire avec l’API Memo Bank ? Réponse : plein de choses. Imaginons une agence immobilière. L’agence loue des appartements pour le compte de propriétaires. Pour faciliter le travail des propriétaires, l’agence collecte les loyers des locataires dans un premier temps, avant de les reverser aux propriétaires dans un second temps. De leur côté, les locataires font donc un virement sur le compte de l’agence quand ils doivent payer leur loyer. Ils ne sont jamais en contact avec les propriétaires. Sur son compte Memo Bank, l’agence reçoit des dizaines de virements, qui correspondent en fait à des loyers versés par les locataires, et qu’elle doit transformer en virements destinés aux propriétaires. Les loyers vont ainsi des locataires à l’agence, et de l’agence aux propriétaires.

Ce fonctionnement en deux temps contraint l’agence à réaliser deux opérations bancaires qui peuvent prendre un temps fou :

  1. La réconciliation des virements entrants, qui nécessite d’associer un locataire à chaque virement reçu sur le compte courant de l’agence. Pour peu que les virements arrivent tous sur le même IBAN et soient mal libellés par les locataires, l’exercice peut vite devenir pénible.
  2. L’exécution des virements sortants, pour faire suivre aux propriétaires les loyers qui leur sont dûs. Le personnel de l’agence doit potentiellement exécuter des dizaines de virements sortants, à la chaîne, et sans jamais se tromper dans les montants envoyés si possible.

Ces deux tâches peuvent être effectuées à la main, bien sûr, moyennant pas mal de temps, assez peu de gratification pour la personne chargée d’une telle mission, et quelques erreurs de saisie au passage. Ou alors, l’agence peut utiliser l’API Memo Bank pour automatiser la réconciliation des virements entrants (la collecte des loyers) et la redistribution des loyers aux propriétaires (l’exécution des virements sortants).

Avec l’API Memo Bank, l’agence pourrait faire en sorte que chaque nouveau locataire inscrit dans son fichier reçoive un IBAN virtuel spécifique — la création de l’IBAN pouvant être automatisée au moyen de l’API. Ceci aurait pour effet de résoudre les problèmes de réconciliation en les supprimant, car les virements entrants seraient alors « identifiés » dès leur arrivée sur le compte Memo Bank de l’agence. Un virement reçu sur l’IBAN dont le nom serait « locataire A » ne pourrait par exemple pas provenir du locataire B ou C. Le fait que les IBAN virtuels puissent avoir un nom en plus de leur numéro facilite le travail de l’agence ici. Voilà qui transformerait une première tâche chronophage en simple formalité.

Pour l’envoi des fonds aux propriétaires, l’agence pourrait là encore utiliser l’API Memo Bank, afin de faire des callbacks cette fois. En configurant un webhook, l’agence pourrait faire en sorte que chaque virement entrant envoyé sur tel IBAN virtuel Memo Bank soit automatiquement transformé en un virement sortant expédié vers tel autre IBAN. Un loyer versé sur l’IBAN virtuel « locataire A » serait ainsi automatiquement suivi d’un virement instantané destiné au titulaire de l’IBAN « propriétaire A ». Dans cette configuration, à peine l’agence a-t-elle reçu un loyer que le propriétaire du bien associé est déjà payé. L’agence minimise ainsi le temps qu’elle passe sur l’exécution des virements sortants, elle évacue le risque d’erreur de saisie, et elle satisfait les propriétaires qui lui confient leur bien en les payant de bonne heure. Carton plein.

Accès et prise en main

Si l’API Memo Bank vous intéresse, pour votre agence immobilière ou pour tout autre chose, contactez-nous. Et si vous avez déjà un abonnement, contactez votre chargé d’affaires Memo Bank pour obtenir vos accès à l’API Memo Bank. L’accès à notre API prend la forme d’une option payante, qui s’ajoute à votre abonnement mensuel. Notre documentation technique (en anglais) devrait quant à elle vous aider à connecter vos outils à vos comptes Memo Bank pour créer des applications bancaires sur-mesure.

L’API Memo Bank n’en est qu’à sa première version (v1). Nous avons hâte de l’enrichir et nous comptons sur vos suggestions pour y parvenir.