API Afterbanks (Arcopay) API

Description de l'API Afterbanks

Afterbanks est une API d’agrégation bancaire qui vise à standardiser la connexion avec différents établissements bancaires en temps réel. Sa documentation officielle expose des endpoints pour lister les banques disponibles, consulter l’utilisation de licence et récupérer la position globale ainsi que les mouvements bancaires.

Qu'est-ce que l'API Afterbanks ?

L'API Afterbanks est une solution orientée open banking et AIS, utile pour centraliser des données financières issues de plusieurs banques dans un même système. Elle est particulièrement adaptée aux entreprises qui veulent automatiser l’accès aux soldes, aux transactions et aux produits bancaires tout en s’appuyant sur une structure d’API REST.

Caractéristiques de l'API Afterbanks

• Liste des banques prises en charge : l’endpoint /forms permet d’obtenir les banques disponibles selon le pays et les informations nécessaires pour afficher le formulaire de connexion.
• Contrôle de licence : l’endpoint /me retourne les informations de licence et le nombre d’appels restants pour le cycle en cours.
• Extraction des mouvements bancaires : l’endpoint /serviceV3 renvoie la position globale d’un utilisateur et ses mouvements à partir d’une date donnée.
• Support des produits bancaires : l’API expose des types de produits comme les comptes courants, cartes, dépôts, prêts ou investissements.
• Gestion d’erreurs structurée : les réponses d’erreur incluent des codes détaillés, par exemple pour un paramètre invalide, un accès interrompu ou une banque indisponible.
• Sandbox de test : la documentation mentionne un environnement sandbox pour tester les appels avant intégration en production.

Comment intégrer l'API Afterbanks : Exemple d'implémentation

Les exemples ci-dessous illustrent un appel vers l’endpoint /forms pour récupérer la liste des banques supportées. La documentation officielle précise que certains endpoints nécessitent une servicekey valide, ainsi que des paramètres comme le pays ou le code bancaire.

const axios = require('axios');

const API_URL = 'https://www.afterbanks.com/forms';
const SERVICE_KEY = 'YOUR_SERVICE_KEY';

async function getBanks(countryCode = 'ES') {
  try {
    const response = await axios.get(API_URL, {
      params: {
        servicekey: SERVICE_KEY,
        country_code: countryCode
      }
    });
    return response.data;
  } catch (error) {
    console.error('Erreur lors de la récupération des banques Afterbanks :', error.response?.data || error.message);
    throw error;
  }
}

// Exemple d'utilisation
// getBanks().then(data => console.log(data));
                

import requests

API_URL = 'https://www.afterbanks.com/forms'
SERVICE_KEY = 'YOUR_SERVICE_KEY'

def get_banks(country_code='ES'):
    params = {
        'servicekey': SERVICE_KEY,
        'country_code': country_code
    }
    response = requests.get(API_URL, params=params)
    if response.status_code == 200:
        return response.json()
    raise Exception(f"Erreur lors de la récupération des banques Afterbanks: {response.status_code} - {response.text}")

# Exemple d'utilisation
# data = get_banks()
# print(data)
                

-- php --
$serviceKey = 'YOUR_SERVICE_KEY';
$apiUrl = 'https://www.afterbanks.com/forms';

function getBanks($apiUrl, $serviceKey, $countryCode = 'ES') {
    $query = http_build_query([
        'servicekey' => $serviceKey,
        'country_code' => $countryCode
    ]);

    $ch = curl_init($apiUrl . '?' . $query);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode === 200) {
        return json_decode($response, true);
    }

    throw new Exception("Erreur lors de la récupération des banques Afterbanks: $httpCode - $response");
}

// Exemple d'utilisation
// $data = getBanks($apiUrl, $serviceKey);
// print_r($data);
?>
                

Idées d'utilisation de l'API Afterbanks

• Applications fintech : agréger plusieurs comptes bancaires dans une interface unique pour simplifier la gestion financière.
• Outils de trésorerie : automatiser le suivi des soldes, des flux entrants et sortants, et des positions bancaires.
• Comptabilité et ERP : rapprocher les mouvements bancaires avec la comptabilité de l’entreprise.
• Analyse financière : exploiter l’historique des transactions pour produire des rapports et des indicateurs de performance.
• Intégration bancaire métier : connecter des solutions internes aux banques supportées sans développer une connexion spécifique pour chaque établissement.