Kann ich Anfragen und Antworten in verschiedenen Fällen sehen?

Kann ich Anfragen und Antworten in verschiedenen Fällen sehen?

Ja. Die API-Referenz enthält zu jedem Endpunkt eine Beispielanfrage und eine Beispielantwort. Hier die häufigsten Fälle.

SEPA-Überweisung (SCT)

curl -X POST https://api.generatesepa.com/api/v2/sct \
  -u "IHR_API_SCHLUESSEL:" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Muster GmbH",
    "iban": "DE89370400440532013000",
    "payments": [{
      "name": "Lieferant Schmidt KG",
      "iban": "DE02120300000000202051",
      "amount": 125000,
      "date": "2026-12-05",
      "description": "Rechnung R-2026-311",
      "reference": "ZAHLUNG-311"
    }]
  }'

amount steht in Cent (125000 = 1.250,00 €). Optional ist das Feld reason: salary (Gehalt, Code SALA) oder pension (Rente, Code PENS); ohne Angabe trägt die Datei den Code OTHR.

SEPA-Lastschrift CORE oder B2B (SDD)

Gleiche Struktur an /api/v2/sdd, mit sepa_identifier (Ihrer Gläubiger-ID) auf oberster Ebene und einem Array debits. Jede Lastschrift enthält zusätzlich mandate_reference (die Mandatsreferenz) und mandate_signature (Datum der Mandatsunterschrift, JJJJ-MM-TT, nicht in der Zukunft). Das Feld scheme ist standardmäßig CORE; für eine Firmenlastschrift senden Sie B2B.

Die erzeugte Datei trägt immer den Sequenztyp RCUR, auch beim ersten Einzug eines Mandats: Die EPC-Regeln erlauben das seit November 2016.

Mehrere Ausführungsdaten in einem Aufruf

Haben Ihre Buchungen unterschiedliche Daten, gruppiert die API sie nach Datum: eine einzige Datei mit je einem Zahlungsblock (PmtInf) pro Datum.

Erfolgreiche Antwort (201)

{
  "id": 701,
  "format": "SCT",
  "file": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4K...",
  "operations": 1,
  "amount": 125000,
  "name": "Muster GmbH",
  "sepa_identifier": null,
  "created_at": 1764892800
}

file enthält das Base64-kodierte XML, created_at ist ein Unix-Zeitstempel.

Fehler

• 401: API-Schlüssel fehlt oder ist falsch (HTTP-Basic-Authentifizierung abgelehnt), oder das Konto hat kein aktives Abonnement. Im zweiten Fall lautet der Body {"error": "..."}.
• 422: ungültige Daten. Der Body enthält errors mit einer Meldung pro gefundenem Problem (ungültige IBAN, fehlender Verwendungszweck, Mandatsdatum in der Zukunft usw.).

{
  "errors": ["El adeudo para Max Mustermann tiene un IBAN inválido"]
}

Die Validierungsmeldungen sind derzeit auf Spanisch.

Fazit

Nehmen Sie das Beispiel, das Ihrem Fall am nächsten kommt, testen Sie es mit einer einzelnen Buchung und senden Sie dann den kompletten Stapel.