Skip to main content

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.