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

# Manage Payment Methods

> Add, edit, and remove payment methods for your customers

## Overview

Payment methods are the foundation for automated billing. Fynn supports various payment methods:

<CardGroup cols={2}>
  <Card title="SEPA Direct Debit" icon="building-columns">
    Automatic debit via SEPA mandate. Supported by EBICS and Stripe.
  </Card>

  <Card title="Credit Card" icon="credit-card">
    Visa, Mastercard, American Express, and more. PCI-compliant via Stripe.
  </Card>

  <Card title="PayPal" icon="paypal">
    Popular payment method for online purchases. One PayPal account per customer.
  </Card>

  <Card title="Bank Transfer" icon="money-bill-transfer">
    For manual payments. No automatic debit.
  </Card>
</CardGroup>

***

## Add Payment Method

<Tabs>
  <Tab title="Using Web App">
    <Steps>
      <Step title="Open Customer Details">
        Navigate to **Customers** and select the customer for whom you want to add a payment method.

        Switch to the **Master Data** tab.
      </Step>

      <Step title="Add Payment Method">
        Click **+ Add** in the **Payment Methods** section and select the desired type:

        <AccordionGroup>
          <Accordion title="Capture SEPA Mandate" icon="building-columns">
            Capture a SEPA mandate directly in Fynn:

            * **IBAN**: The customer's bank details
            * **Account Holder**: Name of the account holder
            * **Mandate Reference**: Automatically generated or manually entered
            * **Signature Date**: Date of mandate signature

            <Info>
              The SEPA mandate is stored digitally and can be viewed at any time.
            </Info>
          </Accordion>

          <Accordion title="Stripe Payment Method" icon="credit-card">
            Credit cards and SEPA direct debits can be added via Stripe.

            The customer receives a secure link to enter their payment details.
          </Accordion>

          <Accordion title="Add PayPal" icon="paypal">
            Connect the customer's PayPal account.

            <Warning>
              Only one PayPal account can be stored per customer.
            </Warning>
          </Accordion>
        </AccordionGroup>
      </Step>

      <Step title="Set as Default">
        After adding, you can mark the payment method as **Default**.

        The default payment method is automatically used for new subscriptions and invoices.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Send Link to Customer">
    You can send the customer a link through which they can add a payment method themselves:

    <Steps>
      <Step title="Create Link">
        Click **Request Payment Method** in the action menu (...) of the customer details.
      </Step>

      <Step title="Send Link">
        Choose whether the link should be sent by email to the customer, or copy the link manually.

        <Info>
          The link is valid for **7 days**.
        </Info>
      </Step>

      <Step title="Customer Adds Payment Method">
        The customer can securely enter their payment details via the link.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Using API">
    Use the [Payment Method Link](/api-reference/paymentmethod/create-payment-method-link) endpoint:

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

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

***

## Remove Payment Method

<Warning>
  Removing a payment method can affect existing subscriptions.
  Fynn guides you through all necessary steps.
</Warning>

### Remove Default Payment Method

If you remove the current **default payment method**, you must select a new default payment method:

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/fynnsubscriptionbilling/images/payment-method-remove-default.png" alt="Select New Default Payment Method" />
</Frame>

<Steps>
  <Step title="Select New Default">
    Choose one of the remaining payment methods as the new default payment method.
  </Step>

  <Step title="Confirm">
    After selection, the new default payment method becomes active immediately.

    All subscriptions that use the "Customer's Default Payment Method" will automatically use the new payment method.
  </Step>
</Steps>

### Payment Method with Subscriptions

If subscriptions **explicitly** use this payment method, you must decide where to migrate the subscriptions:

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

<AccordionGroup>
  <Accordion title="Default Payment Method" icon="star" defaultOpen>
    The subscriptions will be switched to the **customer's default payment method**.

    <Tip>
      This is the recommended option, as future changes to the default payment method will be automatically adopted.
    </Tip>
  </Accordion>

  <Accordion title="Other Payment Method" icon="credit-card">
    The subscriptions will be switched to a **specific other payment method**.

    This remains permanently assigned until manually changed.
  </Accordion>
</AccordionGroup>

***

## Change Default Payment Method

<Tabs>
  <Tab title="Using Web App">
    <Steps>
      <Step title="Open Master Data">
        Navigate to **Customers** -> Select customer -> **Master Data** tab.
      </Step>

      <Step title="Set as Default">
        Click on the radio button icon next to the desired payment method to mark it as default.

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

  <Tab title="Using API">
    Use the [Set Default Payment Method](/api-reference/paymentmethod/set-default-payment-method) endpoint:

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

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

***

## SEPA Mandates

### View Mandate

For SEPA payment methods, you can view the stored mandate at any time:

<Steps>
  <Step title="SEPA Mandate Badge">
    Click on the **SEPA Mandate** badge for the corresponding payment method.
  </Step>

  <Step title="Mandate Details">
    A popover shows all relevant information:

    * Mandate reference
    * Creditor ID
    * IBAN (masked)
    * Account holder
    * Signature date
    * Mandate type (One-time/Recurring)
  </Step>
</Steps>

### SEPA Errors

For failed SEPA direct debits, the payment method is handled according to the error type:

| Error Type                             | Action                        |
| -------------------------------------- | ----------------------------- |
| **Mandate Problem** (MD01, MD02, etc.) | Payment method is deactivated |
| **Account Problem** (AC01, AC04, etc.) | Payment method is deactivated |
| **Temporary** (AM04, AM05, etc.)       | Automatic retry is scheduled  |
| **Regulatory** (AG01, RR01, etc.)      | Manual review required        |

<Info>
  For deactivated payment methods, the customer automatically receives a notification with a link to add a new payment method.
</Info>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I restore a deleted payment method?">
    No, removed payment methods are deactivated and cannot be restored.

    The customer must add a new payment method.
  </Accordion>

  <Accordion title="What happens to ongoing subscriptions?">
    When removing, you will be prompted to migrate the subscriptions to another payment method or to the default payment method.

    There is no interruption to billing.
  </Accordion>

  <Accordion title="How long is the payment method link valid?">
    Links for adding a payment method are valid for **7 days**.

    After that, a new link must be created.
  </Accordion>

  <Accordion title="Can a customer have multiple payment methods?">
    Yes, a customer can have any number of payment methods.

    **Exception:** Only one PayPal account is possible per customer.
  </Accordion>
</AccordionGroup>
