Ontwikkelaars

Eén API. Eén uitslag per rekening.

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.

  1. Verstuur IBAN en naam

    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"
  2. Ontvang het resultaat

    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": []
      }
    }
  3. Gedeeltelijke match: voorgestelde naam

    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"
      }
    }

Beknopte referentie

Parameters, resultaten en fouten van POST /my-bank-match/. De volledige details staan in de integratiehandleiding.

Parameters van het verzoek
ParameterValidatie
api_keyUw API-sleutel, met het product MyBankMatch geactiveerd en beschikbaar tegoed.
ibanIBAN van een SEPA-land. Spaties en hoofdletters worden genegeerd; de lengte voor het betreffende land en de controlecijfers worden gecontroleerd.
nameNaam van de persoon of het bedrijf dat zich als rekeninghouder voordoet, maximaal 140 tekens.
Waarden van result
resultBetekenisVerbruikt tegoedAanvullende 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
Foutcodes
FoutcodeBetekenis
2Onjuiste aanroep: methode, API-sleutel, niet-geactiveerd product of limiet van aanroepen.
4000Ongeldig IBAN.
4001Ongeldige naam van de rekeninghouder.
1Interne fout.

Fouten worden niet in rekening gebracht en verbruiken geen tegoed.

Integratiedetails

Dezelfde vertrouwde envelop

Als u de Wealthreader-API al gebruikt, antwoordt MyBankMatch met dezelfde structuur en dezelfde integratiegewoonten.

Validatie vóór de bank

Het IBAN en de naam worden gevalideerd voordat de bank wordt geraadpleegd: een onjuiste invoer geeft direct een foutmelding.

U betaalt alleen voor sluitende resultaten

MATCH, PARTIAL_MATCH en NO_MATCH verbruiken tegoed. Raadplegingen die niet tot een conclusie leiden, niet.

Openbare documentatie

De stapsgewijze handleiding en de API-referentie beschrijven het volledige contract, met voorbeelden.

Controleer eerst naar wie u het geld stuurt

Wij tonen MyBankMatch aan de hand van de betalingen en registraties van uw bedrijf.

Een demo aanvragen