Ressourcen

MyBankMatch

Prüfen Sie über die Empfängerüberprüfung (Verification of Payee, VoP) Ihrer eigenen, mit Ihrer Wealthreader-Lizenz verknüpften Bank, ob eine IBAN dem angegebenen Inhaber gehört.

Produkt in der Validierungsphase. Wir nehmen schrittweise weitere Banken auf. Wenn Ihre Bank beim Verbinden nicht in der Liste erscheint, eröffnen Sie beim Support ein Ticket mit Angabe des Instituts, und wir schalten es frei; das dauert in der Regel etwa 24 Stunden.

Verbindung vorbereiten

Sie benötigen eine aktive Lizenz mit dem Produkt MY_BANK_MATCH und verfügbarem Kontingent.
Öffnen Sie Clients · MyBankMatch mit Ihrer authentifizierten Sitzung und der entsprechenden Lizenz.
Klicken Sie auf Connect bank und schließen Sie die Authentifizierung im von Wealthreader gehosteten Fenster ab. Die tokenisierte Verbindung wird Ihrem api_key zugeordnet; das Bank-Token wird nicht an den Browser übergeben und ist kein Abfrageparameter.
Aktualisieren Sie den Status in Clients. Wenn die Bank eine erneute Authentifizierung verlangt, verwenden Sie Reconnect. Das Panel bietet außerdem einen expliziten IBAN-/Namenstest und die letzten maskierten Abfragen.

Der Aussteller verwendet einen signierten Einmal-Link und eine an den Browser gebundene Fortsetzung. Wenn der Link abgelaufen ist oder diese Fortsetzung verliert, fordern Sie in Clients einen neuen an.

Eine Abfrage aus dem Backend senden

POST https://api.wealthreader.com/my-bank-match/
Content-Type: application/x-www-form-urlencoded

Parameter	Erforderlich	Vertrag
`api_key`	Ja	Schlüssel aus 8 Hexadezimalzeichen einer aktiven Lizenz mit `MY_BANK_MATCH` und verfügbarem Kontingent. Bewahren Sie ihn im Backend auf.
`iban`	Ja	IBAN eines SEPA-Landes. Leerzeichen werden entfernt, der Wert wird in Großbuchstaben umgewandelt, und die länderspezifische Länge sowie die Mod-97-Prüfung werden validiert.
`name`	Ja	Name des Inhabers: nicht leer, gültiges UTF-8, keine Steuerzeichen und bis zu 140 Zeichen. Er wird gekürzt, und Leerzeichen werden normalisiert.

Es wird kein JSON gesendet und kein X-API-Key verwendet: Der Schlüssel ist Teil des formularcodierten Bodys, genau wie bei /entities/.

curl --request POST 'https://api.wealthreader.com/my-bank-match/' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'api_key=<SU_API_KEY>' \
  --data-urlencode 'iban=ES9321005707250200257112' \
  --data-urlencode 'name=Wealthreader S.L.'

<SU_API_KEY> ist ein Platzhalter, kein verwendbarer Schlüssel. IBAN und Name veranschaulichen die Abnahmeanfrage; es wurde hier nicht geprüft, dass sie ein bestimmtes Ergebnis liefern. Die Abfrage kann kostenpflichtig sein: Lösen Sie sie nicht als automatische Aktualisierung der Oberfläche aus.

MyBankMatch gibt das Ergebnis der Bank zurück. Es ersetzt diese Antwort nicht durch eine lokale Berechnung der Namensähnlichkeit. Es erstellt, autorisiert oder führt auch keinen Zahlungsauftrag aus.

Die Antwort auswerten

HTTP 200 bedeutet, dass ein Ergebnis des Produkts vorliegt, nicht, dass der Name zwingend übereinstimmt. Prüfen Sie success und anschließend payload.result.

Illustratives Beispiel für eine Teilübereinstimmung (Name und SESSION simuliert):

{
  "success": true,
  "payload": {
    "result": "PARTIAL_MATCH",
    "suggested_name": "TITULAR DE EJEMPLO S.L."
  },
  "statistics": {
    "SESSION": "0000000000000000",
    "execution_time": 0.42,
    "warnings": []
  }
}

statistics.SESSION identifiziert diese Abfrage für die Diagnose, und execution_time wird in Sekunden angegeben. Eine erfolgreiche Antwort enthält kein error-Objekt und gibt nicht das Token der Bankverbindung zurück.

`payload.result`	Bedeutung	Zusätzliche Felder	Kostenpflichtig
`MATCH`	Die Bank betrachtet den Namen als übereinstimmend mit dem Inhaber.	Keine.	Ja, 0,10 EUR.
`PARTIAL_MATCH`	Die Bank meldet eine Teilübereinstimmung (`CLOSE_MATCH`).	`suggested_name`: tatsächlicher, von der Bank mitgeteilter Name, kein lokal erzeugter Vorschlag.	Ja, 0,10 EUR.
`NO_MATCH`	Die Bank gibt an, dass der Name nicht übereinstimmt.	Keine.	Ja, 0,10 EUR.
`NOT_CONFIGURED`	Mit der Lizenz ist noch keine Bank verknüpft.	`setup_url`.	Nein.
`REAUTH_REQUIRED`	Die Verbindung erfordert eine erneute Authentifizierung.	`setup_url` und `reason_code`, eine Ganzzahl aus der 2xxx-Familie.	Nein.
`NOT_POSSIBLE`	Es konnte kein verwertbares Ergebnis ermittelt werden. Das ist nicht gleichbedeutend mit `NO_MATCH`.	`reason`, eine technische Kennung.	Nein.

Zeigen Sie bei einer Teilübereinstimmung den eingegebenen Namen und suggested_name getrennt an; ersetzen Sie den eingegebenen Namen nicht stillschweigend. Wenn Sie sie in HTML darstellen, maskieren Sie sie als Text.

Die Einrichtungs-URL für NOT_CONFIGURED und REAUTH_REQUIRED lautet:

https://www.wealthreader.com/clients/#my-bank-match

Eine erneute Authentifizierung kann zum Beispiel diesen payload zurückgeben:

{
  "result": "REAUTH_REQUIRED",
  "setup_url": "https://www.wealthreader.com/clients/#my-bank-match",
  "reason_code": 2000
}

reason_code muss eine Ganzzahl zwischen 2000 und 2999 sein; 2000 steht zum Beispiel für einen Fehler bei den Zugangsdaten. Verbinden Sie die Bank in Clients erneut, statt die Verifizierung endlos zu wiederholen.

NOT_POSSIBLE kann auf eine vorübergehende Nichtverfügbarkeit, eine ungültige Bankantwort, das Fehlen einer verwendbaren Zahler-IBAN oder einen nicht verfügbaren Adapter zurückgehen. Bewahren Sie reason für die Diagnose auf, werten Sie diese Fälle aber weder als Bestätigung der Inhaberschaft noch als negative Übereinstimmung.

Validierung, Kontingent und Fehler

Validierungs- oder Lizenzfehler folgen dem üblichen Umschlag: success: false, payload, error.code, error.message und statistics mit SESSION, Dauer und Warnungen. Kontrollierte Validierungen antworten mit HTTP 400; die Meldung kann Diagnoseinformationen enthalten und darf nicht als stabile Kennung verwendet werden.

`error.code`	Grund
`4000`	Ungültige IBAN: Format, nicht unterstütztes Land, Länge oder Prüfziffern.
`4001`	Ungültiger Name: leer, Format oder Länge.
`2`	Falsche Methode oder falscher `api_key`, inaktive Lizenz, nicht zulässiges Produkt oder erschöpftes Kontingent.
`1`	Interner Verfügbarkeits- oder Persistenzfehler.

Eingabefehler und nicht eindeutige Ergebnisse verbrauchen kein Kontingent für kostenpflichtige Abfragen. Das Kontingent wird verbraucht, wenn die Bank MATCH, PARTIAL_MATCH oder NO_MATCH zurückgibt; wenn ein anderer Aufruf es gleichzeitig erschöpft, wird der Limitfehler zurückgegeben, statt das Ergebnis als erfolgreich zu bestätigen.

Diese Methode bietet weder einen Idempotenzschlüssel noch eine Garantie für kostenlose Wiederholungen. Wenn Sie die Antwort wegen eines Timeouts, eines Netzwerkfehlers oder eines nicht auswertbaren Bodys verlieren, können das Ergebnis und der damit verbundene Kontingentverbrauch für Ihre Anwendung unbekannt sein. Senden Sie dieselbe Abfrage nicht automatisch erneut: Prüfen Sie den Verlauf in Clients und wenden Sie sich an den Support, wenn Sie den Versuch klären müssen.

Der Preis von 0,10 EUR gilt ausschließlich für die drei eindeutigen Ergebnisse des Vertrags. Die Abrechnung pro Abfrage und der Ausschluss verifizierter Verknüpfungssitzungen sind implementiert, setzen aber das vorherige Schema sowie die Aktivierung/Prüfung der Abrechnungsabfragen durch einen Operator voraus; diese Seite belegt diese Bereitstellung nicht. Nur eine verifizierte serverseitige Zuordnung erlaubt es, eine Sitzung von der Standardberechnung der Zugangsdaten/Produkte auszuschließen: Eine operation_id aus dem Browser genügt nicht. Abgelaufene, nicht geprüfte oder historische Versuche ohne diese Herkunft sind nicht automatisch ausgenommen, und es werden keine weiteren kostenlosen Zählereffekte garantiert.

Grenzen dieser Version

Die Verifizierung nutzt die eigene tokenisierte Verbindung des Kunden zu Santander Privatkunden. Die tatsächliche Bankkompatibilität wurde noch nicht validiert, und die Veröffentlichung dieser Seite garantiert keine kommerzielle Verfügbarkeit.
Der gehostete Ablauf unterstützt Zugangsdaten und OTP-/Push-Challenges, die Methodenauswahl und begrenzte Raster-QR-Codes. Script-, OAuth-, CAPTCHA- oder Mehrvertrags-Challenges sind nicht implementiert und führen zu einem sicheren Fehler; Sie können in Clients einen neuen Link anfordern.
Das Panel erfordert eine authentifizierte Sitzung. Das Laden des Status, die Rückkehr aus dem Bankfenster und das Aktualisieren des Verlaufs senden keine Verifizierungen an die Bank: Nur das ausdrückliche Absenden des Formulars löst eine potenziell kostenpflichtige Abfrage aus.
Bewahren Sie den api_key auf Ihrem Server auf und protokollieren Sie keine Zugangsdaten, Bank-Tokens oder vollständigen Namen in unnötigen Integrationslogs. Verwenden Sie SESSION für den Support und beachten Sie die Unterscheidung zwischen Ergebnis, Fehler und Konfigurationsstatus.

Zuletzt aktualisiert 2026-11-08