Hat GenerateSEPA eine API?

Hat GenerateSEPA eine API?

Ja. Mit der API von GenerateSEPA erzeugen Ihr ERP, Ihre SaaS-Plattform oder Ihre interne Anwendung SEPA-XML-Dateien, ohne den Umweg über die Weboberfläche.

Kurzübersicht

• JSON für Anfrage und Antwort.
• HTTP-Basic-Authentifizierung: Ihr API-Schlüssel ist der Benutzername, das Passwort bleibt leer. Den Schlüssel finden Sie in Ihrem Konto im Menü API.
• Endpunkte: POST /api/v2/sct (SEPA-Überweisungen) und POST /api/v2/sdd (SEPA-Lastschriften CORE oder B2B). Außerdem prüft die API IBANs (POST /api/v2/bank_accounts) und erstellt Mandate als PDF (/api/v2/mandates).
• Antwort: die SEPA-XML-Datei Base64-kodiert, dazu Anzahl der Vorgänge und Gesamtbetrag.
• Voraussetzung ist ein aktives Abonnement oder eine laufende Testphase; andernfalls antwortet die API mit 401.
• Überblick unter /de/api; die vollständige Feldreferenz finden Sie auf conversorsepa.readme.io.

Beispiel: eine Lastschriftdatei

curl -X POST https://api.generatesepa.com/api/v2/sdd \
  -u "IHR_API_SCHLUESSEL:" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Muster GmbH",
    "iban": "DE89370400440532013000",
    "sepa_identifier": "DE98ZZZ09999999999",
    "scheme": "CORE",
    "debits": [{
      "name": "Max Mustermann",
      "iban": "DE02120300000000202051",
      "amount": 2599,
      "date": "2026-12-05",
      "description": "Mitgliedsbeitrag Dezember",
      "reference": "RE-2026-120",
      "mandate_reference": "MANDAT-000123",
      "mandate_signature": "2026-01-15"
    }]
  }'

Beträge sind Ganzzahlen in Cent (2599 = 25,99 €), Datumsangaben im Format JJJJ-MM-TT. Für eine Überweisung senden Sie dieselbe Struktur an /api/v2/sct, mit einem Array payments statt debits (ohne Mandatsfelder).

Die Antwort (HTTP 201) enthält die Datei Base64-kodiert im Feld file:

{
  "id": 700,
  "format": "SDD",
  "file": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4K...",
  "operations": 1,
  "amount": 2599,
  "name": "Muster GmbH",
  "sepa_identifier": "DE98ZZZ09999999999",
  "created_at": 1764892800
}

Dekodieren Sie file, und Sie erhalten die pain.008-Datei (bei Überweisungen pain.001), die Sie direkt in Ihr Online-Banking hochladen können.

Wann lohnt sich die API?

• Wiederkehrende, automatisierte Dateierstellung (monatliche Abrechnung, Gehaltslauf).
• Anbindung an ERP oder CRM.
• SaaS-Plattformen, die Beiträge ihrer eigenen Kunden einziehen.
• Datenpipelines, in denen die Buchungen bereits in einem externen System liegen.

Fazit

Holen Sie sich Ihren API-Schlüssel im Konto, werfen Sie einen Blick auf die API-Seite und testen Sie den ersten Aufruf mit einer einzelnen Lastschrift oder Überweisung.