In einigen Fällen haben Ihre Benutzer möglicherweise bereits bestehende Lastschriftmandate außerhalb von GoCardless, die sie zusammen mit ihren GoCardless-Lastschriftmandaten verwalten möchten. Über die Lastschriftmandat-Import-API kann dieser Prozess reibungslos automatisiert werden.
Vorbereitung des Imports von Lastschriftmandaten
Wenn Sie diese Funktion nutzen möchten, müssen Sie sie zunächst in Ihrem Konto aktivieren lassen. Wenden Sie sich hierzu an Ihren Kundenbetreuer oder an unser Support-Team , dann kümmern wir uns so schnell wie möglich um Ihr Anliegen.
Wenn die Funktion in Ihrem Konto aktiviert ist, können Sie Lastschriftmandat-Importe erstellen. Dies läuft im Prinzip wie folgt ab:
- Erstellen Sie eine Lastschriftmandat-Importressource
- Fügen Sie für jedes zu importierende Lastschriftmandat eine Datensammlung – einen Lastschriftmandats-Importeintrag – hinzu
- Reichen Sie den Import zur Überprüfung ein
Erstellen eines Lastschriftmandat-Imports
Der erste Schritt ist einfach. Die einzigen Daten, die Sie zur Erstellung eines Lastschriftmandat-Imports benötigen, sind die Lastschriftschemata der Lastschriftmandate. Beachten Sie bitte, dass ein Lastschriftmandat-Import nur Lastschriftmandate von einem Lastschriftschema enthalten kann. Wenn Sie Lastschriftmandate in verschiedenen Lastschriftschemata übertragen möchten, müssen Sie für jedes Lastschriftschema einen Lastschriftmandat-Import durchführen.
Codebeispiele finden Sie hier.
Hinzufügen von Lastschriftmandat-Importeinträgen
Nachdem Sie den eigentlichen Lastschriftmandat-Import erstellt haben, müssen Sie Lastschriftmandat-Importeinträge für jedes zu importierende Lastschriftmandat hinzufügen. Für die Erstellung eines Lastschriftmandat-Importeintrags müssen Sie Folgendes angeben:
- das Kennzeichen des entsprechenden Lastschriftmandat-Imports
- eine Subressource für
customer(Kunde) mit Angaben zum Kunden, der mit diesem Lastschriftmandat belastet wird (je nach Lastschriftschema unterschiedliche Pflichtfelder; ausführliche Informationen finden Sie in der API-Referenz ) - eine Subressource für
bank_account(Bankkonto) mit den Bankdaten des Kontoinhabers (entweder eine IBAN oder lokale Daten)
Für Lastschriftmandate im SEPA-Lastschriftschema müssen Sie auch Ergänzungsinformationen über den aktuellen Status des Lastschriftmandats angeben. Weitere Informationen finden Sie in den Links zu Codebeispielen weiter unten und in der API-Referenz.
Es ist auch möglich – und wird empfohlen – einen Wert für record_identifier anzugeben. Das ist eine eindeutige Zeichenfolge für jeden Lastschriftmandat-Import. Damit können die Importe später leichter mit den Datensätzen in Ihrem eigenen System abgeglichen werden.
Codebeispiele finden Sie hier.
Bei der Eingabe ungültiger Daten wird eine Fehlermeldung angezeigt, sodass Sie eine Korrektur vornehmen können.
Beachten Sie bitte, dass bei allen Lastschriftmandat-Importen eine Obergrenze von 30.000 Einträgen besteht, daher empfehlen wir, den Import in mehrere kleinere Importe aufzuteilen, falls diese Grenze überschritten wird.
Einreichen des Lastschriftmandat-Imports zur Überprüfung
Nachdem alle Einträge hinzugefügt wurden, können Sie den Lastschriftmandat-Import zur Überprüfung einreichen.
Zum Schutz vor einem möglichen Missbrauch dieser Funktion werden alle Importe von GoCardless überprüft. Wir bemühen uns, diese Überprüfung so schnell wie möglich durchzuführen.
Codebeispiele finden Sie hier.
Verknüpfen von Ressourcen
Nach der Genehmigung wird der Lastschriftmandat-Import verarbeitet. Bei der Migration von Lastschriftmandaten erhalten Sie Webhooks, genau wie bei einer Erstellung über die Lastschriftmandat-API.
Wenn Sie die neuen Ressourcen mit Ihrem System abgleichen müssen, sollten Sie den Lastschriftmandat-Import regelmäßig überprüfen. Wenn der Status zu Verarbeitet wechselt, können Sie die Lastschriftmandat-Importeinträge auflisten, um die Kennungen für die Kunden-, Bankkonto- und Lastschriftmandatsressourcen zu erhalten, die für die einzelnen Lastschriftmandat-Importeinträge erstellt wurden.
Codebeispiele finden Sie hier.
Beachten Sie bitte auch, dass Sie für eventuelle Stornierungen eines Lastschriftmandat-Imports die vorhandene Stornierungs-API verwenden können. Wenn ein eingereichter Lastschriftmandat-Import von unserem Team genehmigt wurde, kann er nicht mehr storniert oder geändert werden.