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

# Get Payment

> Ruft den aktuellen Status und die Details einer initiierten Zahlung ab.

**Cost:** 1 Credit



## OpenAPI

````yaml GET /v2/banking/payments/{id}
openapi: 3.1.0
info:
  title: Business OS API
  description: >-
    API für Business OS – Zugang zu DATEV und Banking Enterprise-Schnittstellen.
    Alle Endpoints erfordern einen API Key im `x-api-key` Header. Credits werden
    pro API-Call abgezogen.
  version: 2.0.0
  contact:
    name: Business OS Support
    email: impressum@business-os.de
    url: https://business-os.de/kontakt
servers:
  - url: https://api.business-os.de
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: DATEV Allgemein
    description: >-
      Modulübergreifende DATEV-Endpunkte (z. B. Abo-/Service-Diagnose für
      Mandanten)
  - name: DATEV DUO
    description: DATEV Unternehmen Online — Kassenbuch, Belegbilder und Buchungsvorschläge
  - name: DATEV ReWe - Write
    description: 'DATEV Rechnungswesen — Write: Buchungen, Kontakte, Belegtypen, Steuersätze'
  - name: DATEV ReWe - Read
    description: >-
      DATEV Rechnungswesen — Read (Export): Geschäftsjahre und weitere
      Lesemodule
  - name: Banking AIS
    description: >-
      Account Information Services — Verbindungen, Kontostände und Transaktionen
      verwalten
  - name: Banking PIS
    description: Payment Initiation Services — Zahlungen ausführen und Status abrufen
  - name: Banking Webhooks
    description: Webhook-Konfiguration für Echtzeit-Benachrichtigungen
paths:
  /v2/banking/payments/{id}:
    get:
      tags:
        - Banking PIS
      summary: Get Payment
      description: |-
        Ruft den aktuellen Status und die Details einer initiierten Zahlung ab.

        **Cost:** 1 Credit
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Payment-ID
          example: '7364509182736450918'
        - $ref: '#/components/parameters/ApiParam'
      responses:
        '200':
          description: Zahlungsdetails und Status
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Payment'
        '401':
          description: Ungültiger API Key
        '402':
          description: Nicht genügend Credits
        '404':
          description: Zahlung nicht gefunden
components:
  parameters:
    ApiParam:
      name: api
      in: query
      schema:
        type: string
        enum:
          - partner
          - openbanking
        default: partner
      description: >-
        Banking-API: `partner` (regulierte Banken) oder `openbanking`
        (unregulierte wie AMEX, Revolut)
  schemas:
    Payment:
      type: object
      description: Eine initiierte Zahlung
      properties:
        id:
          type: string
          description: Eindeutige Payment-ID
          example: '7364509182736450918'
        reference:
          type: string
          nullable: true
          description: >-
            Lokales Label, das beim Erstellen über das Feld `reference`
            mitgegeben wurde (z.B. die eigene Rechnungsnummer). Von Business OS
            gespeichert und hier zur Identifikation zurückgegeben — kein Feld
            der Bank.
          example: RG-2026-03024
        provider_code:
          type: string
          description: Technischer Provider-Code
          example: musterbank_oauth_client_de
        provider_name:
          type: string
          description: Name der Bank
          example: Musterbank
        created_at:
          type: string
          format: date-time
          description: Erstellungszeitpunkt
          example: '2026-03-24T12:26:30Z'
        updated_at:
          type: string
          format: date-time
          description: Letzter Aktualisierungszeitpunkt
          example: '2026-03-24T12:27:10Z'
        refresh_interval:
          type: integer
          description: Aktualisierungsintervall in Sekunden
          example: 3600
        refresh_timeout:
          type: integer
          description: Timeout für Aktualisierung in Sekunden
          example: 172800
        status:
          type: string
          enum:
            - initiated
            - initiated_info_required
            - authorizing
            - authorized
            - processing
            - executed
            - settled
            - failed
            - rejected
          description: >-
            Zahlungsstatus des Payment-Objekts. `executed` = Auftrag von der
            Bank ausgeführt (Settlement noch nicht bestätigt), `settled` =
            Settlement vollständig abgeschlossen (finaler Erfolg). Hinweis: Der
            Zwischenstatus `initiated_info_required` wird per Webhook bewusst
            nicht ausgeliefert (siehe PIS-Webhook).
          example: settled
        raw_provider_status:
          type: string
          nullable: true
          description: Roher Statuscode der Bank (z.B. ACCC, ACSC)
          example: ACCC
        template_identifier:
          type: string
          enum:
            - SEPA
            - SEPA_INSTANT
          description: Zahlungsart
          example: SEPA
        payment_attributes:
          type: object
          description: Zahlungsdetails
          properties:
            amount:
              type: string
              description: Betrag als String
              example: '1.00'
            debtor_iban:
              type: string
              description: IBAN des Absenders
              example: DE89370400440532013000
            description:
              type: string
              description: Verwendungszweck
              example: Rechnung RE-2026-001
            creditor_iban:
              type: string
              description: IBAN des Empfängers
              example: DE27100777770209299700
            creditor_name:
              type: string
              description: Name des Empfängers
              example: Mustermann GmbH
            creditor_bic:
              type: string
              description: BIC des Empfängers (optional, abhängig vom Provider)
              example: TRISDE55XXX
            currency_code:
              type: string
              description: Währungscode
              example: EUR
            end_to_end_id:
              type: string
              description: Ende-zu-Ende-Referenz
              example: RE-2026-001
            customer_ip_address:
              type: string
              description: IP-Adresse des Kunden (automatisch gesetzt)
              example: 203.0.113.42
        last_attempt:
          type: object
          description: Details zum letzten Zahlungsversuch
          properties:
            id:
              type: string
              description: Attempt-ID
              example: '5091827364509182736'
            custom_fields:
              type: object
              description: Benutzerdefinierte Felder
              example: {}
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Dein Business OS API Key. Erstelle einen unter
        [app.business-os.de](https://app.business-os.de/) → API Keys.

````