De haufigste Integrationsfehler bij de Verification of Payee ist, een NO_MATCH als fehlgeschlagene Anfrage naar behandeln. Het ist es nicht. Een erfolgreiche controle, de sagt „dieser Name gehort niet naar dieser IBAN“, ist trotzdem een 200-Antwort met nutzlichen Daten. Verwechseln U de beiden, schlucken U entwede fraudessignale of zeigen Nutzern beangstigende Fehler.
De vier Schemacodes
Elk Verification of Payee-antwoord komt overeen met een van de vier gestandaardiseerde SEPA-schemacodes. Vertak op de code, niet op vrije tekst:
- MTCH — MATCH: De Name stimmt met de rekeninghoude uberein. Fortfahren.
- CMTC — CLOSE_MATCH: fast richtig (fehlende zweiter Vorname, Handelsname vs. Firmenname). Zeigen U de vorgeschlagenen gecontroleerten Namen en bitten U de Zahler naar bestatigen.
- NMTC — NO_MATCH: de naam hoort niet bij de IBAN. Waarschuw duidelijk en blokkeer automatische goedkeuring.
- NOAP — NOT_APPLICABLE: De controle konnte niet abgeschlossen werden (z. B. antwortende bank niet erreichbar). Lassen U de Nutzer met zusatzlicher Vorsicht entscheiden.
Ergebnis vs. Fehler
Is de HTTP-status 200, dan hebt u een verificatieresultaat — lees scheme_code. Is het 4xx/5xx, dan hebt u een fout — lees de foutcode. Map NO_MATCH nooit op uw foutpad.
CLOSE_MATCH goed afhandelen
Bij CLOSE_MATCH wordt goede UX gewonnen of verloren. Het antwoord kan de geverifieerde rekeninghoudernaam dragen; toon die als suggestie ('Bedoelde u…?') zodat de betaler bevestigt of corrigeert in plaats van de betaling af te breken. CMTC als harde mislukking behandelen frustreert legitieme gebruikers.
Echte Fehlercodes
Getrennt van Schema-Ergebnissen geben Probleme op Transportebene Standard-HTTP-Fehler zuruck — etwa invalid_iban (400), unauthorized (401), rate_limited (429) en scheme_unavailable (503). Jede tragt een request id, damit de Support u verfolgen kann. Ubergeben U bij jedem Aufruf een stabile external id, damit Retries idempotent bleiben en Logs sich abgleichen.