Derselbe gewohnte Aufbau
Wenn Sie die Wealthreader-API bereits nutzen, antwortet MyBankMatch mit derselben Struktur und denselben Integrationsgewohnheiten.
Entwickler
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.
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"
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": []
}
}
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"
}
}
Parameter, Ergebnisse und Fehler von POST /my-bank-match/. Die vollständigen Details finden Sie im Integrationsleitfaden.
| Parameter | Validierung |
|---|---|
api_key | Ihr API-Schlüssel, mit aktivem MyBankMatch-Produkt und verfügbarem Kontingent. |
iban | IBAN eines SEPA-Landes. Leerzeichen und Groß-/Kleinschreibung werden ignoriert; geprüft werden die Länge für das jeweilige Land und die Prüfziffern. |
name | Name der Person oder des Unternehmens, das sich als Inhaber ausgibt, mit bis zu 140 Zeichen. |
result | Bedeutung | Verbraucht Kontingent | Zusä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 |
| Fehlercode | Bedeutung |
|---|---|
2 | Fehlerhafter Aufruf: Methode, API-Schlüssel, nicht aktives Produkt oder Aufruflimit. |
4000 | Ungültige IBAN. |
4001 | Ungültiger Name des Inhabers. |
1 | Interner Fehler. |
Fehler werden nicht berechnet und verbrauchen kein Kontingent.
Wenn Sie die Wealthreader-API bereits nutzen, antwortet MyBankMatch mit derselben Struktur und denselben Integrationsgewohnheiten.
IBAN und Name werden validiert, bevor die Bank abgefragt wird: Fehlerhafte Daten führen sofort zu einem Fehler.
MATCH, PARTIAL_MATCH und NO_MATCH verbrauchen Kontingent. Abfragen, die zu keinem Ergebnis führen, nicht.
Der Schritt-für-Schritt-Leitfaden und die API-Referenz beschreiben den vollständigen Vertrag, mit Beispielen.
MyBankMatch-Leitfaden öffnen (öffnet in einem neuen Tab) API-Referenz öffnen (öffnet in einem neuen Tab) Zugang anfragen
Wir zeigen Ihnen MyBankMatch anhand der Zahlungen und Neuanlagen Ihres Unternehmens.