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

# PayPal F&F einrichten

> PayPal Freunde & Familie-Zahlungen mit IPN oder E-Mail-Weiterleitung konfigurieren

Folge dieser Anleitung, um dein PayPal-Konto mit Komerza zu verbinden. Du kannst zwischen IPN (Instant Payment Notification) oder E-Mail-Weiterleitung wählen.

<Steps>
  <Step title="PayPal verbinden">
    Gehe zur [Zahlungsseite im Komerza-Dashboard](https://dashboard.komerza.com/account?payment) und klicke auf die Schaltfläche **Verbinden** neben **PayPal Freunde & Familie**.

    <img className="block dark:hidden rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/paypal/1-light.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=2245ff84a90c66f6ac0d98b97504f1be" alt="PayPal im Dashboard verbinden" width="946" height="640" data-path="images/paypal/1-light.png" />

    <img className="hidden dark:block rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/paypal/1-dark.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=07541448b2b74335132062ed86dd8bb3" alt="PayPal im Dashboard verbinden" width="910" height="582" data-path="images/paypal/1-dark.png" />
  </Step>

  <Step title="Grundeinstellungen konfigurieren">
    Gib im Dialog folgende Informationen ein:

    <img className="block dark:hidden rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/paypal/2-light.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=0b508019259c21be1688bfb78dc32073" alt="PayPal Einstellungsdialog" width="1436" height="1088" data-path="images/paypal/2-light.png" />

    <img className="hidden dark:block rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/paypal/2-dark.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=acdaf505eaf7cde33b45b1dbe5540279" alt="PayPal Einstellungsdialog" width="1462" height="1102" data-path="images/paypal/2-dark.png" />

    * **PayPal E-Mail**: Gib die E-Mail-Adresse deines PayPal-Kontos ein.
          <Note>
            Wenn du **E-Mail-Weiterleitung** nutzen möchtest, **muss** dies eine Gmail-Adresse sein. Bei **IPN** wird jeder E-Mail-Anbieter unterstützt.
          </Note>

    ### Risikoeinstellungen

    <AccordionGroup>
      <Accordion title="Zurückgehaltene Zahlungen akzeptieren">
        PayPal hält manchmal Zahlungen zur Prüfung zurück. Aktiviere dies, wenn du Bestellungen sofort liefern möchtest, auch wenn die Zahlung zurückgehalten wird.

        <Warning>
          **Hohes Risiko**: Zurückgehaltene Zahlungen können von PayPal rückgängig gemacht werden. Aktiviere dies nur, wenn du bereit bist, das Risiko des Geldverlusts zu akzeptieren.
        </Warning>
      </Accordion>

      <Accordion title="Zahlungsanfragen akzeptieren">
        Aktiviere dies, wenn Komerza automatisch versuchen soll, Zahlungsanfragen anzunehmen.

        <Warning>
          Diese Funktion birgt gewisse Risiken. Aktiviere sie nur, wenn PayPal dich häufig auffordert, Zahlungen manuell in der App zu akzeptieren.
        </Warning>
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Integrationstyp wählen">
    Wähle die Integrationsmethode, die am besten zu deinen Anforderungen passt:

    ### Option A: IPN (Instant Payment Notification)

    * **Vorteile**: Sehr stabil, Standard-Integration.
    * **Nachteile**: Leicht von PayPal erkennbar.
    * **Empfehlung**: Nicht empfohlen für umsatzstarke Händler, die unauffällig bleiben möchten.

    **IPN einrichten:**

    1. Wähle **IPN** als Integrationstyp aus.
    2. Klicke auf **Weiter**.
    3. Der Dialog stellt dir eine Benachrichtigungs-URL bereit.
    4. Melde dich in deinen PayPal-Kontoeinstellungen an und füge diese URL in den [IPN-Einstellungsbereich](https://www.paypal.com/merchantnotification/ipn/preference/edit) ein.
    5. Füge die URL in das Feld **Benachrichtigungs-URL** ein.
    6. Stelle sicher, dass **IPN-Nachrichten empfangen (Aktiviert)** ausgewählt ist.
    7. Klicke auf **Speichern**.

    <img className="block rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/paypal/4.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=8113cff6340038f8a5e119a37114b277" alt="PayPal IPN-Konfiguration" width="2386" height="1412" data-path="images/paypal/4.png" />

    ### Option B: E-Mail-Weiterleitung

    * **Vorteile**: Schwerer erkennbar, sehr zuverlässig für Datenschutz.
    * **Nachteile**: Basiert auf E-Mail-Parsing, das brechen kann, wenn PayPal E-Mail-Formate ändert.
    * **Hinweis**: Die „Notizen-Version" wird bei dieser Methode zur Stabilität auf **Version 1** gesetzt.

    **E-Mail-Weiterleitung einrichten:**

    1. Wähle **E-Mail-Weiterleitung** als Integrationstyp aus.
    2. Klicke auf **Weiter**.
    3. Du erhältst eine `@hermes.komerza.com`-Weiterleitungsadresse.

    <img className="block dark:hidden rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/paypal/3-light.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=65f3636969c933a2a68f0009690e768f" alt="Weiterleitungs-E-Mail für PayPal kopieren" width="1376" height="1212" data-path="images/paypal/3-light.png" />

    <img className="hidden dark:block rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/paypal/3-dark.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=631889845cdaf8ecf726b654b6c4c405" alt="Weiterleitungs-E-Mail für PayPal kopieren" width="1460" height="1276" data-path="images/paypal/3-dark.png" />
  </Step>

  <Step title="E-Mail-Weiterleitung einrichten (falls gewählt)">
    Wenn du **E-Mail-Weiterleitung** gewählt hast, folge diesen Schritten, um Zahlungsquittungen an Komerza weiterzuleiten.

    ### 1. Weiterleitungsadresse hinzufügen

    1. Melde dich bei deinem Gmail-Konto an.
    2. Gehe zu **Einstellungen** > **Alle Einstellungen anzeigen** > **Weiterleitung und POP/IMAP**.
    3. Klicke auf **Weiterleitungsadresse hinzufügen**.
    4. Füge die im Dashboard angegebene `@hermes.komerza.com`-Adresse ein.
    5. Schließe die Verifizierungsschritte ab (prüfe deinen Posteingang/Spam auf den Code).

    ### 2. Filter konfigurieren

    <Warning>
      **Wichtig:** Stelle sicher, dass **„Weiterleitung deaktivieren"** in der Weiterleitungs-Registerkarte ausgewählt ist. Aktiviere keine globale Weiterleitung.
    </Warning>

    1. Klicke auf **„Filter erstellen"** in der Weiterleitungs-Registerkarte.
    2. Setze die **Von**-Adresse auf deine regionsspezifische PayPal-Service-E-Mail.

    #### Deine PayPal-„Von"-Adresse finden

    Die „Von"-Adresse variiert je nach Region. **Überprüfe zur Sicherheit eine aktuelle E-Mail von PayPal oder sende dir selbst eine Testzahlung (0,01 \$).**

    <Note>
      **Die meisten Nutzer außerhalb großer spezifischer Regionen verwenden:** `service@intl.paypal.com`
    </Note>

    **Häufige Adressen:**

    | Region           | Von-Adresse               |
    | ---------------- | ------------------------- |
    | 🇺🇸 USA         | `service@paypal.com`      |
    | 🇬🇧 UK          | `service@paypal.co.uk`    |
    | 🇩🇪 Deutschland | `service@paypal.de`       |
    | 🇫🇷 Frankreich  | `service@paypal.fr`       |
    | 🇪🇸 Spanien     | `service@paypal.es`       |
    | 🇮🇹 Italien     | `service@paypal.it`       |
    | 🇦🇺 Australien  | `service@paypal.com.au`   |
    | 🇧🇷 Brasilien   | `service@paypal.com.br`   |
    | 🇲🇽 Mexiko      | `service@paypal.com.mx`   |
    | 🇨🇦 Kanada      | `service@paypal.ca`       |
    | 🇳🇱 Niederlande | `service@paypal.nl`       |
    | 🇧🇪 Belgien     | `service@paypal.be`       |
    | 🇵🇱 Polen       | `service@paypal.pl`       |
    | 🇸🇪 Schweden    | `service@paypal.se`       |
    | 🇮🇳 Indien      | `service@paypal.co.in`    |
    | 🇸🇬 Singapur    | `service@paypal.com.sg`   |
    | 🇭🇰 Hongkong    | `service@paypal.com.hk`   |
    | 🌍 International | `service@intl.paypal.com` |

    3. Gib die Adresse deiner Region (z. B. `service@paypal.de`) in das Feld **Von** ein.

    <img className="block rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/paypal/5.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=cad749972aa4997767f848305e713112" alt="Filter erstellen - Schritt 1" width="1470" height="746" data-path="images/paypal/5.png" />

    4. Klicke auf **Filter erstellen**.
    5. Hake **Weiterleiten an:** an und wähle die Hermes-E-Mail-Adresse aus.

    <img className="block rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/paypal/6.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=b970a1a6fbb046ef7af39894bf802ad5" alt="Filter erstellen - Schritt 2" width="1470" height="1166" data-path="images/paypal/6.png" />

    6. Klicke auf **Filter erstellen**.
  </Step>

  <Step title="Integration testen">
    Deine PayPal-Integration ist konfiguriert.

    Wir empfehlen dringend, eine **Test-Zahlung von 1 \$** in deinem Shop durchzuführen, um zu bestätigen, dass das System die Zahlung korrekt erkennt und die Bestellung als bezahlt markiert.
  </Step>
</Steps>
