Entwickler

Eine API. Ein Ergebnis pro Konto.

MyBankMatch ist ein Endpunkt der Wealthreader-API: HTTPS, Formularparameter und JSON-Antwort. Senden Sie die IBAN und den Namen und erhalten Sie das Prüfergebnis.

Zur Aktivierung des Dienstes verknüpfen wir einmalig ein Konto Ihres Unternehmens über das Kundenportal von Wealthreader: Es führt die Abfragen der Empfängerüberprüfung (Verification of Payee, VoP) durch. Ihre Kunden und Lieferanten müssen nichts tun.

  1. IBAN und Name senden

    Eine POST-Anfrage mit Ihrem API-Schlüssel, der IBAN des Kontos und dem Namen der Person oder des Unternehmens, das sich als Inhaber ausgibt.

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

    Die Antwort kommt im selben Aufruf, mit demselben Aufbau wie der Rest der API: success, payload und statistics.

    {
      "success": true,
      "payload": {
        "result": "MATCH"
      },
      "statistics": {
        "SESSION": "…",
        "execution_time": 1.84,
        "warnings": []
      }
    }
  3. Teilweise Übereinstimmung: vorgeschlagener Name

    Ist der Name ähnlich, aber nicht identisch, enthält die Antwort suggested_name mit dem bei der Bank hinterlegten Namen.

    Die Werte sind illustrativ.

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

Kurzreferenz

Parameter, Ergebnisse und Fehler von POST /my-bank-match/. Die vollständigen Details finden Sie im Integrationsleitfaden.

Parameter der Anfrage
ParameterValidierung
api_keyIhr API-Schlüssel, mit aktivem MyBankMatch-Produkt und verfügbarem Kontingent.
ibanIBAN eines SEPA-Landes. Leerzeichen und Groß-/Kleinschreibung werden ignoriert; geprüft werden die Länge für das jeweilige Land und die Prüfziffern.
nameName der Person oder des Unternehmens, das sich als Inhaber ausgibt, mit bis zu 140 Zeichen.
Werte von result
resultBedeutungVerbraucht KontingentZusätzliche Felder
MATCH Der Name stimmt mit dem Kontoinhaber überein. Ja —
PARTIAL_MATCH Der Name ähnelt dem des Inhabers; suggested_name enthält den bei der Bank hinterlegten Namen. Ja suggested_name
NO_MATCH Der Name entspricht nicht dem Kontoinhaber. Ja —
NOT_CONFIGURED Ihrem Schlüssel ist noch kein Konto zugeordnet; setup_url führt zur Verknüpfung. Nein setup_url
REAUTH_REQUIRED Die verknüpfte Bank verlangt eine erneute Authentifizierung; setup_url führt zur erneuten Verbindung. Nein setup_url, reason_code
NOT_POSSIBLE Die Bank konnte das Konto derzeit nicht prüfen; reason nennt den Grund. Nein reason
Fehlercodes
FehlercodeBedeutung
2Fehlerhafter Aufruf: Methode, API-Schlüssel, nicht aktives Produkt oder Aufruflimit.
4000Ungültige IBAN.
4001Ungültiger Name des Inhabers.
1Interner Fehler.

Fehler werden nicht berechnet und verbrauchen kein Kontingent.

Details zur Integration

Derselbe gewohnte Aufbau

Wenn Sie die Wealthreader-API bereits nutzen, antwortet MyBankMatch mit derselben Struktur und denselben Integrationsgewohnheiten.

Validierung vor der Bank

IBAN und Name werden validiert, bevor die Bank abgefragt wird: Fehlerhafte Daten führen sofort zu einem Fehler.

Sie zahlen nur für Eindeutiges

MATCH, PARTIAL_MATCH und NO_MATCH verbrauchen Kontingent. Abfragen, die zu keinem Ergebnis führen, nicht.

Öffentliche Dokumentation

Der Schritt-für-Schritt-Leitfaden und die API-Referenz beschreiben den vollständigen Vertrag, mit Beispielen.

Prüfen Sie, an wen Sie das Geld senden, bevor Sie es senden

Wir zeigen Ihnen MyBankMatch anhand der Zahlungen und Neuanlagen Ihres Unternehmens.

Demo anfragen