Développeurs

Une API. Un verdict par compte.

MyBankMatch est un point d’accès de l’API Wealthreader : HTTPS, paramètres de formulaire et réponse JSON. Envoyez l’IBAN et le nom, et recevez le résultat de la vérification.

Pour activer le service, nous associons une seule fois un compte de votre entreprise depuis l’espace Clients de Wealthreader : c’est lui qui effectue les requêtes de Vérification du bénéficiaire. Vos clients et vos fournisseurs n’ont rien à faire.

  1. Envoyez l’IBAN et le nom

    Une requête POST avec votre clé d’API, l’IBAN du compte et le nom de la personne ou de l’entreprise qui se déclare titulaire.

    curl https://api.wealthreader.com/my-bank-match/ \
      -d api_key=$API_KEY \
      -d iban=ES9121000418450200051332 \
      --data-urlencode name="Talleres Ruiz SL"
  2. Recevez le résultat

    La réponse arrive dans le même appel, avec la même enveloppe que le reste de l’API : success, payload et statistics.

    {
      "success": true,
      "payload": {
        "result": "MATCH"
      },
      "statistics": {
        "SESSION": "…",
        "execution_time": 1.84,
        "warnings": []
      }
    }
  3. Concordance partielle : nom suggéré

    Si le nom est proche sans être identique, la réponse inclut suggested_name avec le nom inscrit auprès de la banque.

    Les valeurs sont illustratives.

    {
      "success": true,
      "payload": {
        "result": "PARTIAL_MATCH",
        "suggested_name": "Talleres Ruiz Martínez SL"
      }
    }

Référence rapide

Paramètres, résultats et erreurs de POST /my-bank-match/. Le détail complet figure dans le guide d’intégration.

Paramètres de la requête
ParamètreValidation
api_keyVotre clé d’API, avec le produit MyBankMatch activé et du quota disponible.
ibanIBAN d’un pays SEPA. Les espaces et la casse sont ignorés ; la longueur propre à son pays et les chiffres de contrôle sont vérifiés.
nameNom de la personne ou de l’entreprise qui se déclare titulaire, jusqu’à 140 caractères.
Valeurs de result
resultSignificationConsomme du quotaChamps supplémentaires
MATCH Le nom correspond au titulaire du compte. Oui —
PARTIAL_MATCH Le nom est proche de celui du titulaire ; suggested_name fournit le nom inscrit auprès de la banque. Oui suggested_name
NO_MATCH Le nom ne correspond pas au titulaire du compte. Oui —
NOT_CONFIGURED Votre clé n’a pas encore de compte associé ; setup_url mène à l’association. Non setup_url
REAUTH_REQUIRED La banque associée demande une nouvelle authentification ; setup_url mène à la reconnexion. Non setup_url, reason_code
NOT_POSSIBLE La banque n’a pas pu vérifier le compte pour le moment ; reason indique le motif. Non reason
Codes d’erreur
Code d’erreurSignification
2Appel incorrect : méthode, clé d’API, produit non activé ou limite d’appels.
4000IBAN non valide.
4001Nom du titulaire non valide.
1Erreur interne.

Les erreurs ne sont pas facturées et ne consomment pas de quota.

Détails d’intégration

La même enveloppe que d’habitude

Si vous utilisez déjà l’API Wealthreader, MyBankMatch répond avec la même structure et les mêmes habitudes d’intégration.

Validation avant la banque

L’IBAN et le nom sont validés avant d’interroger la banque : une donnée mal formée renvoie immédiatement une erreur.

Vous ne payez que le concluant

MATCH, PARTIAL_MATCH et NO_MATCH consomment du quota. Les requêtes qui n’aboutissent pas à une conclusion, non.

Documentation publique

Le guide pas à pas et la référence de l’API décrivent le contrat complet, avec des exemples.

Avant d’envoyer l’argent, vérifiez à qui

Nous vous présentons MyBankMatch avec les paiements et les ouvertures de compte de votre activité.

Demander une démo