Skip to main content
Skip table of contents

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.
Bei Aktivierung wird der Lastschrifttyp automatisch von COR1 in CORE geändert.

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:

pain.001.002.03pain.001.001.03

pain.001.003.03pain.001.001.03

pain.008.002.02pain.008.001.02

pain.008.003.02pain.008.001.02

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

ä

a

ö

o

ü

u

Ä

A

Ö

O

Ü

U

ß (scharfes s)

s

& (kaufmännisches "und")

+ (Plus)

* (Asterisk)

. (Punkt)

$ (Dollarzeichen)

. (Punkt)

% (Prozent)

. (Punkt)

@ (At)

. (Punkt)

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.