Sie haben Ihren ersten Kunden mit einem Lastschriftmandat eingerichtet und können nun Zahlungen einziehen. Sie haben zwei Möglichkeiten zur Einrichtung Ihrer Zahlungen. Die Entscheidung hängt davon ab, wofür Sie GoCardless verwenden:
- Einmalige Zahlung: Sie können im Rahmen des Lastschriftmandats jederzeit eine Zahlung über die API auslösen. Dies eignet sich für Situationen, in denen Sie einen bestimmten Einzelbetrag von Ihren Kunden einziehen möchten.
- Daueraufträge: Sie können eine automatisierte regelmäßige Zahlung einrichten. Dies eignet sich für Situationen, in denen Sie regelmäßig den gleichen Betrag einziehen möchten (z. B. 5 £ pro Woche oder 20 £ am Monatsersten).
Sie können diese beiden auch in Kombination verwenden. Wenn Sie über ein Lastschriftmandat verfügen, können Sie die Kunden flexibel belasten.
Probieren Sie jetzt beides aus. Wir empfehlen Ihnen, sich in Ruhe mit beiden Optionen zu befassen, um sämtliche Möglichkeiten der API kennen zu lernen.
Einmalige Zahlung
Zum Erstellen einer Zahlung für einen Kunden sind die folgenden Felder erforderlich:
amount - Der Betrag in Pence (GBP), Cent (AUD/EUR), Öre (SEK) oder Øre (DKK).
currency - Der Währungscode gemäß ISO 4217. Zurzeit werden GBP, EUR, SEK und AUD unterstützt.
links[mandate] - Das Kennzeichen des Lastschriftmandats des Kunden, unter dem die Zahlung eingezogen wird.
Sie müssen die für das Lastschriftmandat, das Sie einrichten, geeignete currency verwenden. Diese hängt vom verwendeten Lastschriftschema ab. Das Lastschriftschema Ihres Lastschriftmandats, das über eine Umleitung eingerichtet wurde, hängt von Ihrem Standort ab (Sie können es allerdings auch manuell festlegen, indem Sie ein scheme angeben):
| Standort | currency |
|---|---|
| Großbritannien | GBP |
| Schweden | SEK |
| Australien | AUD |
| Alle anderen | EUR |
Neben diesen Feldern können die folgenden optionalen Parameters gesendet werden:
app_fee - Der Betrag, der von der Zahlung als OAuth-App-Gebühr abgezogen wird, in Pence/Cent/Öre/Øre. (gilt nur für Partner)
charge_date - Ein in der Zukunft liegendes Datum, an dem die Zahlung eingezogen werden soll. Wenn nichts angegeben ist, wird die Zahlung so bald wie möglich eingezogen. Das Datum muss am oder nach dem next_possible_charge_date des Lastschriftmandats liegen und wird von GoCardless auf ein späteres Datum verschoben, wenn es sich nicht um einen Bankgeschäftstag handelt.
description - Eine für Menschen verständliche Beschreibung der Zahlung. Diese wird in der Benachrichtigungs-E-Mail angegeben, die GoCardless an Ihre Kunden sendet, sofern Ihre Organisation nicht eigene Benachrichtigungen versendet (siehe die Compliance-Anforderungen).
metadata - Schlüsselwertspeicher für benutzerdefinierte Daten. Es sind bis zu drei Schlüssel zulässig, wobei die Schlüsselnamen bis zu 50 Zeichen und die Werte bis zu 500 Zeichen enthalten dürfen.
reference - Ein optionaler Verwendungszweck, der im Kontoauszug Ihres Kunden angegeben wird. Hierfür gelten die folgenden Längenbeschränkungen: Bei Bacs-Zahlungen bis zu 10 Zeichen, bei SEPA-Zahlungen bis zu 140 Zeichen, bei Zahlungen über Betalingsservice bis zu 30 Zeichen und bei Zahlungen über Bankeinzug (autogiro) bis zu 11 Zeichen. Einschränkung: Sie können einen Verwendungszweck für Bacs-Zahlungen (d. h. beim Einzug aus Großbritannien) nur angeben, wenn Sie über ein GoCardless Plus- oder Pro-Paket verfügen.
Codebeispiele finden Sie im Leitfaden, den Sie hier aufrufen können.
Idempotenz-Schlüssel
Idempotenz-Schlüssel -Header bereitstellen. Wenn eine eindeutige, für diese Zahlung spezifische Zeichenfolge angegeben wird (z. B. ihr Kennzeichen in unserer eigenen Datenbank), stellt die API sicher, dass diese Zahlung nur ein einziges Mal erstellt wird.Wenn also eine API-Anforderung aufgrund einer Zeitüberschreitung fehlschlägt oder bei Ihnen ein Fehler auftritt, kann es in keinem Fall passieren, dass Sie einen Kunden zweimal belasten. Weitere Informationen hierzu finden Sie in unserem Blogpost. Sie können Idempotenz-Schlüssel immer verwenden, wenn Sie etwas unter Verwendung der API erstellen.
Daueraufträge
Daueraufträge ermöglichen die Erstellung von Zahlungen nach einem Zeitplan.
Zum Erstellen eines Dauerauftrags für einen Kunden sind die folgenden Felder erforderlich:
amount - Der Betrag in Pence (GBP), Cent (AUD/EUR), Öre (SEK) oder Øre (DKK).
currency - Der Währungscode gemäß ISO 4217. Zurzeit werden GBP, EUR, SEK, AUD und DKK unterstützt.
interval_unit - Der Zeitraum zwischen den Tagen, an denen der Kunde belastet wird. Kann weekly, monthly oder yearly sein.
links[mandate] - Das Kennzeichen des Lastschriftmandats des Kunden, unter dem der Dauerauftrag Zahlungen erstellt.
Neben diesen Feldern können die folgenden optionalen Parameters gesendet werden:
name - Optionale Bezeichnung für den Dauerauftrag, der außerdem die Beschreibung der einzelnen Zahlungen darstellt.
interval - Die Anzahl der „interval_units“ zwischen den einzelnen Belastungsdaten. Dabei muss mindestens eine Belastung pro Jahr erfolgen. Bei fehlender Angabe wird standardmäßig 1 eingetragen.
count - Die Gesamtzahl der Zahlungen, die im Rahmen des Dauerauftrags eingezogen werden. Wenn keine Anzahl angegeben ist, läuft der Dauerauftrag für eine unbestimmte Dauer.
day_of_month - Der Tag des Monats (1–28), an dem Ihr Kunde belastet werden soll. Sie können auch -1 eintragen, um den letzten Tag des Monats anzugeben.
month - Der Name des Monats, in dem der Kunde belastet wird.
start_date - Das Datum, an dem die erste Zahlung belastet werden soll. Dieses Datum muss innerhalb eines Jahres nach Erstellung des Dauerauftrags und am oder nach dem next_possible_charge_date des Lastschriftmandats liegen. Wenn dieser Parameter nicht angegeben ist, wird die erste Zahlung so früh wie möglich belastet.
payment_reference - Dieser Parameter ist nur für Pro-Konten verfügbar. Ein optionaler Verwendungszweck, der für alle Zahlungen festgelegt und im Kontoauszug Ihres Kunden angegeben wird.
Codebeispiele finden Sie im Leitfaden, den Sie hier aufrufen können.
Weitere Informationen zu Wiederholungsregeln und Tipps zur Implementierung finden Sie in diesem ausführlichen Artikel.