> ## 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.

# Payments

> Zahlungen in SEPA oder SEPA Instant initiieren.

## 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

<ParamField path="customer_id" type="string">
  Die Banking-Customer-ID. Wird automatisch aus deiner Organisation ermittelt, wenn nicht angegeben.
</ParamField>

<ParamField path="connection_id" type="string" required>
  Die Connection-ID des Bankzugangs, über den die Zahlung ausgeführt werden soll.
</ParamField>

<ParamField path="amount" type="number" required>
  Der Zahlungsbetrag in der angegebenen Währung.
</ParamField>

<ParamField path="currency_code" type="string" required>
  Währungscode (z.B. `EUR`).
</ParamField>

<ParamField path="description" type="string" required>
  Verwendungszweck der Überweisung.
</ParamField>

<ParamField path="creditor_iban" type="string" required>
  IBAN des Zahlungsempfängers.
</ParamField>

<ParamField path="creditor_name" type="string" required>
  Name des Zahlungsempfängers.
</ParamField>

## Get Payment Status

Rufe den Status einer bestehenden Zahlung über `GET /v2/banking/payments/:id` ab.

<ResponseExample>
  ```200 - Erfolg theme={null}
  {
    "data": {
      "id": "7364509182736450918",
      "reference": "RE-2026-0042",
      "provider_code": "musterbank_de",
      "provider_name": "Musterbank",
      "status": "settled",
      "raw_provider_status": "ACCC",
      "template_identifier": "SEPA",
      "payment_attributes": {
        "amount": "150.00",
        "currency_code": "EUR",
        "description": "Rechnung RE-2026-0042",
        "creditor_name": "Beispiel Handels GmbH",
        "creditor_iban": "DE89370400440532013000",
        "creditor_bic": "COBADEFFXXX",
        "debtor_iban": "DE02100100100006820101",
        "end_to_end_id": "RE-2026-0042",
        "customer_ip_address": "203.0.113.42"
      },
      "refresh_interval": 60,
      "refresh_timeout": 600,
      "last_attempt": {
        "id": "8273645091827364509",
        "custom_fields": {}
      },
      "created_at": "2026-04-25T10:30:00Z",
      "updated_at": "2026-04-25T10:31:00Z"
    }
  }
  ```
</ResponseExample>

### Payment Status-Werte

| Status        | Beschreibung                                            |
| :------------ | :------------------------------------------------------ |
| `authorizing` | Zahlung wird vom Zahler autorisiert (TAN-/App-Freigabe) |
| `processing`  | Zahlung wird verarbeitet                                |
| `settled`     | Zahlung erfolgreich ausgeführt                          |
| `failed`      | Zahlung fehlgeschlagen (z.B. unzureichendes Guthaben)   |
| `rejected`    | Zahlung von der Bank abgelehnt                          |

## Verbrauch

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