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.
Développeurs
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.
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"
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": []
}
}
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"
}
}
Paramètres, résultats et erreurs de POST /my-bank-match/. Le détail complet figure dans le guide d’intégration.
| Paramètre | Validation |
|---|---|
api_key | Votre clé d’API, avec le produit MyBankMatch activé et du quota disponible. |
iban | IBAN 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. |
name | Nom de la personne ou de l’entreprise qui se déclare titulaire, jusqu’à 140 caractères. |
result | Signification | Consomme du quota | Champs 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 |
| Code d’erreur | Signification |
|---|---|
2 | Appel incorrect : méthode, clé d’API, produit non activé ou limite d’appels. |
4000 | IBAN non valide. |
4001 | Nom du titulaire non valide. |
1 | Erreur interne. |
Les erreurs ne sont pas facturées et ne consomment pas de quota.
Si vous utilisez déjà l’API Wealthreader, MyBankMatch répond avec la même structure et les mêmes habitudes d’intégration.
L’IBAN et le nom sont validés avant d’interroger la banque : une donnée mal formée renvoie immédiatement une erreur.
MATCH, PARTIAL_MATCH et NO_MATCH consomment du quota. Les requêtes qui n’aboutissent pas à une conclusion, non.
Le guide pas à pas et la référence de l’API décrivent le contrat complet, avec des exemples.
Ouvrir le guide MyBankMatch (s’ouvre dans un nouvel onglet) Ouvrir la référence de l’API (s’ouvre dans un nouvel onglet) Demander l’accès
Nous vous présentons MyBankMatch avec les paiements et les ouvertures de compte de votre activité.