Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.business-os.de/llms.txt

Use this file to discover all available pages before exploring further.

Definition

Über dieses Modul gibst du alle relevanten Zahlungsparameter mit, um die Zahlung auf einem spezifizierbaren Konto zu initiieren. Dieser Vorgang löst den TAN-Prozess deiner Bank aus, sodass du die Zahlung final über z.B. Push-TAN auf deinem Handy freigeben musst.

Initiate SEPA Payment

Erstelle eine neue Zahlung über den POST /v2/banking/payments Endpunkt.

Attribute

customer_id
string
Die Salt Edge Customer-ID. Wird automatisch aus deiner Organisation ermittelt, wenn nicht angegeben.
connection_id
string
required
Die Connection-ID des Bankzugangs, über den die Zahlung ausgeführt werden soll.
amount
number
required
Der Zahlungsbetrag in der angegebenen Währung.
currency_code
string
required
Währungscode (z.B. EUR).
description
string
required
Verwendungszweck der Überweisung.
creditor_iban
string
required
IBAN des Zahlungsempfängers.
creditor_name
string
required
Name des Zahlungsempfängers.

Get Payment Status

Rufe den Status einer bestehenden Zahlung über GET /v2/banking/payments/:id ab.
{
  "data": {
    "id": "4444444444444444444",
    "status": "processing",
    "amount": 150.00,
    "currency_code": "EUR",
    "description": "Rechnung 2025-001",
    "creditor_iban": "DE89370400440532013000",
    "creditor_name": "Beispiel GmbH",
    "created_at": "2025-03-15T10:30:00Z",
    "updated_at": "2025-03-15T10:31:00Z"
  }
}

Payment Status-Werte

StatusBeschreibung
processingZahlung wird verarbeitet, TAN-Freigabe ausstehend
successfulZahlung erfolgreich ausgeführt
failedZahlung fehlgeschlagen (z.B. unzureichendes Guthaben)
rejectedZahlung von der Bank abgelehnt

Verbrauch

Für das ausführen dieses Modul werden 3 Credits (nur bei erfolgreicher Zahlung) berechnet. Deinen detaillierten Verbrauche kannst Du in deinem Dashboard ansehen.