> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Zahlungsmethoden verwalten

> Hinzufügen, bearbeiten und entfernen von Zahlungsmethoden für deine Kunden

## Übersicht

Zahlungsmethoden sind die Grundlage für automatisierte Abrechnungen. Fynn unterstützt verschiedene Zahlungsmethoden:

<CardGroup cols={2}>
  <Card title="SEPA-Lastschrift" icon="building-columns">
    Automatischer Einzug via SEPA-Mandat. Unterstützt durch EBICS und Stripe.
  </Card>

  <Card title="Kreditkarte" icon="credit-card">
    Visa, Mastercard, American Express und weitere. PCI-konform über Stripe.
  </Card>

  <Card title="PayPal" icon="paypal">
    Beliebte Zahlungsmethode für Online-Käufe. Ein PayPal-Konto pro Kunde.
  </Card>

  <Card title="Überweisung" icon="money-bill-transfer">
    Für manuelle Zahlungen. Keine automatische Abbuchung.
  </Card>
</CardGroup>

***

## Zahlungsmethode hinzufügen

<Tabs>
  <Tab title="Web-App verwenden">
    <Steps>
      <Step title="Kundendetails öffnen">
        Navigiere zu **Kunden** und wähle den Kunden aus, für den du eine Zahlungsmethode hinzufügen möchtest.

        Wechsle zum Tab **Stammdaten**.
      </Step>

      <Step title="Zahlungsmethode hinzufügen">
        Klicke im Bereich **Zahlungsmethoden** auf **+ Hinzufügen** und wähle den gewünschten Typ:

        <AccordionGroup>
          <Accordion title="SEPA-Mandat erfassen" icon="building-columns">
            Erfasse ein SEPA-Mandat direkt in Fynn:

            * **IBAN**: Die Bankverbindung des Kunden
            * **Kontoinhaber**: Name des Kontoinhabers
            * **Mandatsreferenz**: Wird automatisch generiert oder manuell eingegeben
            * **Unterschriftsdatum**: Datum der Mandatsunterschrift

            <Info>
              Das SEPA-Mandat wird digital gespeichert und kann jederzeit eingesehen werden.
            </Info>
          </Accordion>

          <Accordion title="Stripe Zahlungsmethode" icon="credit-card">
            Über Stripe können Kreditkarten und SEPA-Lastschriften hinzugefügt werden.

            Der Kunde erhält einen sicheren Link zur Eingabe seiner Zahlungsdaten.
          </Accordion>

          <Accordion title="PayPal hinzufügen" icon="paypal">
            Verbinde das PayPal-Konto des Kunden.

            <Warning>
              Pro Kunde kann nur ein PayPal-Konto hinterlegt werden.
            </Warning>
          </Accordion>
        </AccordionGroup>
      </Step>

      <Step title="Als Standard festlegen">
        Nach dem Hinzufügen kannst du die Zahlungsmethode als **Standard** markieren.

        Die Standard-Zahlungsmethode wird automatisch für neue Abonnements und Rechnungen verwendet.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Link an Kunde senden">
    Du kannst dem Kunden einen Link senden, über den er selbst eine Zahlungsmethode hinzufügen kann:

    <Steps>
      <Step title="Link erstellen">
        Klicke im Aktions-Menü (···) der Kundendetails auf **Zahlungsmethode anfordern**.
      </Step>

      <Step title="Link versenden">
        Wähle, ob der Link per E-Mail an den Kunden gesendet werden soll, oder kopiere den Link manuell.

        <Info>
          Der Link ist **7 Tage** gültig.
        </Info>
      </Step>

      <Step title="Kunde fügt Zahlungsmethode hinzu">
        Der Kunde kann über den Link sicher seine Zahlungsdaten eingeben.
      </Step>
    </Steps>
  </Tab>

  <Tab title="API verwenden">
    Verwende den [Payment Method Link](/api-reference/paymentmethod/create-payment-method-link) Endpunkt:

    ```bash theme={null}
    POST /payment-methods/link
    ```

    ```json theme={null}
    {
      "customer": "cus_abc123",
      "sendEmail": true,
      "allowedPaymentMethodTypes": ["card", "sepa_debit"]
    }
    ```
  </Tab>
</Tabs>

***

## Zahlungsmethode entfernen

<Warning>
  Das Entfernen einer Zahlungsmethode kann Auswirkungen auf bestehende Abonnements haben.
  Fynn führt dich durch alle notwendigen Schritte.
</Warning>

### Standard-Zahlungsmethode entfernen

Wenn du die aktuelle **Standard-Zahlungsmethode** entfernst, musst du eine neue Standard-Zahlungsmethode auswählen:

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/fynnsubscriptionbilling/images/payment-method-remove-default.png" alt="Neue Standard-Zahlungsmethode auswählen" />
</Frame>

<Steps>
  <Step title="Neue Standard auswählen">
    Wähle eine der verbleibenden Zahlungsmethoden als neue Standard-Zahlungsmethode.
  </Step>

  <Step title="Bestätigen">
    Nach der Auswahl wird die neue Standard-Zahlungsmethode sofort aktiv.

    Alle Abonnements, die die "Standard-Zahlungsmethode des Kunden" verwenden, nutzen automatisch die neue Zahlungsmethode.
  </Step>
</Steps>

### Zahlungsmethode mit Abonnements

Wenn Abonnements diese Zahlungsmethode **explizit** verwenden, musst du entscheiden, wohin die Abonnements migriert werden:

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/fynnsubscriptionbilling/images/payment-method-remove-subscriptions.png" alt="Abonnements migrieren" />
</Frame>

<AccordionGroup>
  <Accordion title="Standard-Zahlungsmethode" icon="star" defaultOpen>
    Die Abonnements werden auf die **Standard-Zahlungsmethode des Kunden** umgestellt.

    <Tip>
      Dies ist die empfohlene Option, da zukünftige Änderungen der Standard-Zahlungsmethode automatisch übernommen werden.
    </Tip>
  </Accordion>

  <Accordion title="Andere Zahlungsmethode" icon="credit-card">
    Die Abonnements werden auf eine **spezifische andere Zahlungsmethode** umgestellt.

    Diese bleibt fest zugewiesen, bis sie manuell geändert wird.
  </Accordion>
</AccordionGroup>

***

## Standard-Zahlungsmethode ändern

<Tabs>
  <Tab title="Web-App verwenden">
    <Steps>
      <Step title="Stammdaten öffnen">
        Navigiere zu **Kunden** → Kunde auswählen → Tab **Stammdaten**.
      </Step>

      <Step title="Als Standard festlegen">
        Klicke bei der gewünschten Zahlungsmethode auf das Radio-Button-Symbol, um sie als Standard zu markieren.

        <Frame>
          <img src="https://mintlify.s3.us-west-1.amazonaws.com/fynnsubscriptionbilling/images/payment-method-set-default.png" alt="Als Standard festlegen" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="API verwenden">
    Verwende den [Set Default Payment Method](/api-reference/paymentmethod/set-default-payment-method) Endpunkt:

    ```bash theme={null}
    PUT /customers/{customerId}/payment-method
    ```

    ```json theme={null}
    {
      "paymentMethodId": "pm_abc123"
    }
    ```
  </Tab>
</Tabs>

***

## SEPA-Mandate

### Mandat einsehen

Für SEPA-Zahlungsmethoden kannst du das hinterlegte Mandat jederzeit einsehen:

<Steps>
  <Step title="SEPA-Mandat Badge">
    Klicke auf den **SEPA-Mandat** Badge bei der entsprechenden Zahlungsmethode.
  </Step>

  <Step title="Mandatsdetails">
    Ein Popover zeigt alle relevanten Informationen:

    * Mandatsreferenz
    * Gläubiger-ID
    * IBAN (maskiert)
    * Kontoinhaber
    * Unterschriftsdatum
    * Mandatstyp (Einmalig/Wiederkehrend)
  </Step>
</Steps>

### SEPA-Fehler

Bei fehlgeschlagenen SEPA-Lastschriften wird die Zahlungsmethode je nach Fehlerart behandelt:

| Fehlertyp                             | Aktion                           |
| ------------------------------------- | -------------------------------- |
| **Mandatsproblem** (MD01, MD02, etc.) | Zahlungsmethode wird deaktiviert |
| **Kontoproblem** (AC01, AC04, etc.)   | Zahlungsmethode wird deaktiviert |
| **Vorübergehend** (AM04, AM05, etc.)  | Automatischer Retry wird geplant |
| **Regulatorisch** (AG01, RR01, etc.)  | Manuelle Prüfung erforderlich    |

<Info>
  Bei deaktivierten Zahlungsmethoden erhält der Kunde automatisch eine Benachrichtigung mit einem Link zum Hinzufügen einer neuen Zahlungsmethode.
</Info>

***

## Häufige Fragen

<AccordionGroup>
  <Accordion title="Kann ich eine gelöschte Zahlungsmethode wiederherstellen?">
    Nein, entfernte Zahlungsmethoden werden deaktiviert und können nicht wiederhergestellt werden.

    Der Kunde muss eine neue Zahlungsmethode hinzufügen.
  </Accordion>

  <Accordion title="Was passiert mit laufenden Abonnements?">
    Beim Entfernen wirst du aufgefordert, die Abonnements zu einer anderen Zahlungsmethode oder zur Standard-Zahlungsmethode zu migrieren.

    Es gibt keine Unterbrechung der Abrechnung.
  </Accordion>

  <Accordion title="Wie lange ist der Zahlungsmethoden-Link gültig?">
    Links zum Hinzufügen einer Zahlungsmethode sind **7 Tage** gültig.

    Danach muss ein neuer Link erstellt werden.
  </Accordion>

  <Accordion title="Kann ein Kunde mehrere Zahlungsmethoden haben?">
    Ja, ein Kunde kann beliebig viele Zahlungsmethoden haben.

    **Ausnahme:** Pro Kunde ist nur ein PayPal-Konto möglich.
  </Accordion>
</AccordionGroup>