API-Einstellungen
Hier finden Sie Einstellungsmöglichkeiten für die Nutzung der konfipay-API. Die API-Einstellungen sind in Prüfungen und Aktionen unterteilt. Hierbei sind Prüfungen dazu da, eingereichte Daten überprüfen und ggf. Fehler melden. Aktionen verändern Daten automatisch und können dazu dienen, Fehler in eingereichten Daten zu korrigieren.
Prüfungen
Die Prüfungen dienen dazu, syntaktische und/oder logische Fehler möglichst frühzeitig in der Zahlungsverarbeitung zu erkennen. Da verschiedene Banken unterschiedlich tolerant gegenüber Fehlern sind, können Sie jede Prüfung einzeln aktivieren oder deaktivieren, um sie an die Prüfkriterien Ihrer Bank anzupassen.
Die folgende Tabelle beschreibt die einzelnen Prüfungen im Detail:
Prüfung | Beschreibung |
|---|---|
SEPA Teilnehmerland | Prüfung, ob die IBAN der gegenüberstehenden Partei der Überweisung oder Lastschrift zu einem SEPA-Teilnehmerland gehört. Gilt nur für Zahlungsformate, welche der SEPA-Länderbeschränkung unterliegen. |
IBAN Validierung | Validierung der IBAN durch Berechnung und Abgleich der Prüfziffer. |
IBAN/BIC Zusammengehörigkeit | Prüfung der Zusammengehörigkeit von IBAN und BIC. |
XML-Schema Validierung | Validierung der eingereichten Dateien gegen das referenzierte XML Schema. |
DFÜ-Zeichensatzprüfung | Prüfung der Dateien gegen den im DFÜ-Abkommen erlaubten Zeichensatz. Bei dieser Prüfung kann zwischen dem “Standard-Zeichensatz” und dem “Erweiterten Zeichensatz” gewählt werden. Gilt nur für Dateien, welche der DFÜ-Zeichensatzbeschränkung unterliegen. |
EPC-/DK Regeln | Prüfung von Einschränkungen und Regeln des European Payment Council und der Deutschen Kreditwirtschaft. |
Prüfung der Kontrollwerte | Überprüfung der in der Datei angegebenen Anzahl an Zahlungen und der Kontrollsumme gegenüber den tatsächlichen Werten. |
AZV-Dateiprüfung | Überprüfung von Struktur und Inhalt bei Auslandsüberweisungen im DTAZV-Format. |
Doppeleinreichung | Prüfung, ob die gleiche Datei innerhalb eines definierten Zeitraums bereits eingereicht wurde. Der Zeitraum kann individuell festgelegt werden (1 bis 48 Stunden). |
Adressprüfung für Lastschriften außerhalb der EU | Überprüfung, ob die Adresse des Zahlungspflichtigen in der Lastschrift enthalten ist. Befindet sich das kontoführende Kreditinstitut des Zahlungspflichtigen außerhalb der EU, so ist die Angabe der Adresse zwingend notwendig. |
Prüfung der EBICS-Auftragsart | Überprüfung, ob der zur Ausführung einer Zahlung verwendete EBICS-Kontakt über die notwendige Auftragsart verfügt. |
Ausführungsdatum | Überprüfung des Ausführungsdatums für eingereichte Zahlungsaufträge. Das Ausführungsdatum darf nicht in der Vergangenheit liegen. |
Gläubiger-Identifikationsnummer | Überprüfung der Gläubiger-Identifikationsnummer für eingereichte Zahlungsaufträge. |
Eindeutige Message-ID | Prüfung auf Eindeutigkeit der Message-ID. |
Erstellung von Offline-Konten | Ist die Einstellung aktiv, wird die Erstellung von Offline-Konten über die API zugelassen. Ist die Einstellung deaktiviert, wird die Erstellung von Offline-Konten über die API abgelehnt. Offline-Konten sind weder mit einem EBICS-Zugang verknüpft noch an ein Service-Rechenzentrum angebunden, sodass keinerlei Online-Aktion möglich ist. |
Aktionen
Die Aktionen greifen automatisch in die übertragenen Daten oder in den Datenbestand von konfipay ein, sofern bestimmte Bedingungen erfüllt sind. Die Aktionen können helfen, Workflows zu optimieren oder Fehler in den übertragenen Daten automatisch zu korrigieren.
Die Aktionen sind standardmäßig deaktiviert und müssen vom Nutzer aktiv ausgewählt werden. Die folgende Tabelle beschreibt die einzelnen Aktionen im Detail:
Aktion | Beschreibung |
|---|---|
Konvertierung nicht erlaubter Zeichen | Automatische Konvertierung von nicht erlaubten Zeichen (gemäß DFÜ-Abkommen) für SEPA-Zahlungen. Die Konvertierung erfolgt gemäß des EPC SEPA Conversion Table, und funktioniert in konfipay entsprechend der Konvertierungstabelle, die Sie am unteren Ende dieser Seite finden. |
Bankkonten automatisch anlegen | Automatische Anlage von Bankkonten aus Zahlungsverkehrsdateien. |
Konvertierung von COR1 in CORE | COR1 wird als Lastschrifttyp nicht mehr unterstützt. |
Bankfachliche XML-Dateien formatieren | Bankfachliche XML-Dateien werden formatiert ausgegeben (Zeilenumbrüche und Einrückungen). |
XML-Deklaration in bankfachlichen XML-Dateien | Die XML-Deklaration <?xml version='1.0' encoding='utf-8' ?> wird bankfachlichen XML-Dateien vorangestellt. |
Konvertierung veralteter Zahlungsauftragsdateien | Zahlungsauftragsdateien im SEPA pain-Format werden automatisch auf eine akuelle Version angehoben. Die Konvertierung erfolgt ausschließlich für Versionen, welche laut DFÜ-Abkommen nicht mehr gültig sind, nach folgendem Schema:
|
Asynchrone Dateiverarbeitung | Zahlungsverkehrsdateien werden nach der Einreichung asynchron verarbeitet. Empfohlen für große Dateien (>2 MB). |
Konvertierung von Zahlungsauftragsdateien in länderspezifische Formate | Automatische Konvertierung von eingereichten SEPA-Zahlungen in das länderspezifische Zielformat. Das Zielformat richtet sich nach dem ISO-Ländercode des jeweiligen EBICS-Kontakts. Hinweis: Aufgrund inhaltlicher Einschränkungen ist die Konvertierung nicht in allen Fällen möglich. Mögliche Konvertierungen sind nachfolgenden Tabellen zu entnehmen: Legende 💛 Eine Konvertierung ist nicht vorgesehen. Das Original-Dokument wird zurückgegeben. ❌ Eine Konvertierung ist nicht möglich (unbekannte pain-Formate oder gravierende Unterschiede in Quelle- und Ziel-XSD-Schema). ✅ Eine Konvertierung ist möglich: u. U. je nach Belegung der Felder können Fehler auftreten. Überweisungen  Lastschriften  |
Konvertierung von Eilüberweisungen in Echtzeitüberweisungen | Eingereichte Eilüberweisungen werden für eine noch schnellere Übertragung automatisch in Echtzeitüberweisungen konvertiert. Stellen Sie bei der Aktivierung dieser Aktion sicher, dass Ihre Bank Echtzeitüberweisungen anbietet. Das Betragslimit legt fest, bis zu welchem Überweisungsbetrag Eilüberweisungen in Echtzeitüberweisungen umwandelt. Falls das Betragslimit mit einer Zahlung überschritten wird, wird die Zahlung bei Einreichung mit einer entsprechenden Fehlermeldung abgelehnt. |
Konvertierungstabelle nicht erlaubter Zeichen
Nicht erlaubtes Zeichen | Konvertierung zu |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|