Dezelfde vertrouwde envelop
Als u de Wealthreader-API al gebruikt, antwoordt MyBankMatch met dezelfde structuur en dezelfde integratiegewoonten.
Ontwikkelaars
MyBankMatch is een endpoint van de Wealthreader-API: HTTPS, formulierparameters en een JSON-antwoord. Verstuur het IBAN en de naam, en ontvang het resultaat van de verificatie.
Om de dienst te activeren koppelen wij eenmalig een rekening van uw bedrijf vanuit het klantenpaneel van Wealthreader: via deze rekening worden de raadplegingen van de Verificatie van de Begunstigde uitgevoerd. Uw klanten en leveranciers hoeven niets te doen.
Een POST-verzoek met uw API-sleutel, het IBAN van de rekening en de naam van de persoon of het bedrijf dat zich als rekeninghouder voordoet.
curl https://api.wealthreader.com/my-bank-match/ \
-d api_key=$API_KEY \
-d iban=ES9121000418450200051332 \
--data-urlencode name="Talleres Ruiz SL"
Het antwoord komt binnen in dezelfde aanroep, met dezelfde envelop als de rest van de API: success, payload en statistics.
{
"success": true,
"payload": {
"result": "MATCH"
},
"statistics": {
"SESSION": "…",
"execution_time": 1.84,
"warnings": []
}
}
Als de naam lijkt op die van de rekeninghouder maar niet identiek is, bevat het antwoord suggested_name met de naam die bij de bank bekend is.
De waarden zijn illustratief.
{
"success": true,
"payload": {
"result": "PARTIAL_MATCH",
"suggested_name": "Talleres Ruiz Martínez SL"
}
}
Parameters, resultaten en fouten van POST /my-bank-match/. De volledige details staan in de integratiehandleiding.
| Parameter | Validatie |
|---|---|
api_key | Uw API-sleutel, met het product MyBankMatch geactiveerd en beschikbaar tegoed. |
iban | IBAN van een SEPA-land. Spaties en hoofdletters worden genegeerd; de lengte voor het betreffende land en de controlecijfers worden gecontroleerd. |
name | Naam van de persoon of het bedrijf dat zich als rekeninghouder voordoet, maximaal 140 tekens. |
result | Betekenis | Verbruikt tegoed | Aanvullende velden |
|---|---|---|---|
MATCH |
De naam komt overeen met de rekeninghouder. | Ja | — |
PARTIAL_MATCH |
De naam lijkt op die van de rekeninghouder; suggested_name bevat de naam die bij de bank bekend is. | Ja | suggested_name |
NO_MATCH |
De naam komt niet overeen met de rekeninghouder. | Ja | — |
NOT_CONFIGURED |
Aan uw sleutel is nog geen rekening gekoppeld; setup_url leidt naar de koppeling. | Nee | setup_url |
REAUTH_REQUIRED |
De gekoppelde bank vraagt om opnieuw te authenticeren; setup_url leidt naar het opnieuw koppelen. | Nee | setup_url, reason_code |
NOT_POSSIBLE |
De bank kon de rekening op dit moment niet verifiëren; reason geeft de reden aan. | Nee | reason |
| Foutcode | Betekenis |
|---|---|
2 | Onjuiste aanroep: methode, API-sleutel, niet-geactiveerd product of limiet van aanroepen. |
4000 | Ongeldig IBAN. |
4001 | Ongeldige naam van de rekeninghouder. |
1 | Interne fout. |
Fouten worden niet in rekening gebracht en verbruiken geen tegoed.
Als u de Wealthreader-API al gebruikt, antwoordt MyBankMatch met dezelfde structuur en dezelfde integratiegewoonten.
Het IBAN en de naam worden gevalideerd voordat de bank wordt geraadpleegd: een onjuiste invoer geeft direct een foutmelding.
MATCH, PARTIAL_MATCH en NO_MATCH verbruiken tegoed. Raadplegingen die niet tot een conclusie leiden, niet.
De stapsgewijze handleiding en de API-referentie beschrijven het volledige contract, met voorbeelden.
Open de MyBankMatch-handleiding (opent in een nieuw tabblad) Open de API-referentie (opent in een nieuw tabblad) Toegang aanvragen
Wij tonen MyBankMatch aan de hand van de betalingen en registraties van uw bedrijf.