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

# Setup PayPal F&F

> Configure PayPal Friends & Family payments with IPN or mail forwarding

Follow this guide to connect your PayPal account to Komerza. You can choose between IPN (Instant Payment Notification) or Email Forwarding integration.

<Steps>
  <Step title="Connect PayPal">
    Navigate to the [Komerza Dashboard Payments](https://dashboard.komerza.com/account?payment) page and click the **Connect** button next to **PayPal Friends & Family**.

    <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="Connect PayPal in Dashboard" 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="Connect PayPal in Dashboard" width="910" height="582" data-path="images/paypal/1-dark.png" />
  </Step>

  <Step title="Configure Basic Settings">
    In the dialog box, enter the following details:

    <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 Settings Dialog" 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 Settings Dialog" width="1462" height="1102" data-path="images/paypal/2-dark.png" />

    * **PayPal Email**: Enter the email address associated with your PayPal account.
          <Note>
            If you plan to use **Email Forwarding**, this **must** be a Gmail address. If using **IPN**, any email provider is supported.
          </Note>

    ### Risk Settings

    <AccordionGroup>
      <Accordion title="Accept Held Payments">
        PayPal sometimes holds payments for review. Enable this if you want to deliver orders immediately even if the payment is held.

        <Warning>
          **High Risk**: Held payments can be reversed by PayPal. Only enable this if you are willing to accept the risk of losing the funds.
        </Warning>
      </Accordion>

      <Accordion title="Accept Payment Requests">
        Enable this if you want Komerza to automatically try to accept payment requests.

        <Warning>
          This feature carries some risk. Only enable it if PayPal frequently forces you to manually accept payments in the app.
        </Warning>
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Choose Integration Type">
    Select the integration method that best fits your needs:

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

    * **Pros**: Very stable, standard integration.
    * **Cons**: Easily detectable by PayPal.
    * **Recommendation**: Not recommended for high-volume merchants who want to stay under the radar.

    **To setup IPN:**

    1. Select **IPN** as the integration type.
    2. Click **Next**.
    3. The dialog will provide you with a Notification URL.
    4. Log in to your PayPal account settings and paste this URL into the [IPN settings area](https://www.paypal.com/merchantnotification/ipn/preference/edit).
    5. Paste the URL into the **Notification URL** field.
    6. Ensure **Receive IPN messages (Enabled)** is selected.
    7. Click **Save**.

    <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 Configuration" width="2386" height="1412" data-path="images/paypal/4.png" />

    ### Option B: Email Forwarding

    * **Pros**: Harder to detect, very reliable for privacy.
    * **Cons**: Relies on email parsing, which can break if PayPal changes email formats.
    * **Note**: "Notes Version" is forced to **Version 1** for stability when using this method.

    **To setup Email Forwarding:**

    1. Select **Email Forwarding** as the integration type.
    2. Click **Next**.
    3. You will be given a `@hermes.komerza.com` forwarding address.

    <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="Copy Forwarding Email for PayPal" 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="Copy Forwarding Email for PayPal" width="1460" height="1276" data-path="images/paypal/3-dark.png" />
  </Step>

  <Step title="Setup Email Forwarding (If Selected)">
    If you chose **Email Forwarding**, follow these steps to forward payment receipts to Komerza.

    ### 1. Add Forwarding Address

    1. Login to your Gmail account.
    2. Go to **Settings** > **See all settings** > **Forwarding and POP/IMAP**.
    3. Click **Add a forwarding address**.
    4. Paste the `@hermes.komerza.com` address provided in the dashboard.
    5. Complete the verification steps (check your inbox/spam for the code).

    ### 2. Configure Filter

    <Warning>
      **Important:** Ensure **"Disable forwarding"** is selected in the Forwarding tab. Do not enable global forwarding.
    </Warning>

    1. Click **"creating a filter"** in the Forwarding tab.
    2. You need to set the **From** address to your specific PayPal service email.

    #### Finding Your PayPal "From" Address

    The "From" address varies by region. **To be certain, check a recent email from PayPal or send yourself a test payment (\$0.01).**

    <Note>
      **Most users outside of major specific regions will use:** `service@intl.paypal.com`
    </Note>

    **Common Addresses:**

    | Region                                                                                       | From Address              |
    | -------------------------------------------------------------------------------------------- | ------------------------- |
    | <span className="kflag kflag-united-states" role="img" aria-label="USA" /> USA               | `service@paypal.com`      |
    | <span className="kflag kflag-united-kingdom" role="img" aria-label="UK" /> UK                | `service@paypal.co.uk`    |
    | <span className="kflag kflag-germany" role="img" aria-label="Germany" /> Germany             | `service@paypal.de`       |
    | <span className="kflag kflag-france" role="img" aria-label="France" /> France                | `service@paypal.fr`       |
    | <span className="kflag kflag-spain" role="img" aria-label="Spain" /> Spain                   | `service@paypal.es`       |
    | <span className="kflag kflag-italy" role="img" aria-label="Italy" /> Italy                   | `service@paypal.it`       |
    | <span className="kflag kflag-australia" role="img" aria-label="Australia" /> Australia       | `service@paypal.com.au`   |
    | <span className="kflag kflag-brazil" role="img" aria-label="Brazil" /> Brazil                | `service@paypal.com.br`   |
    | <span className="kflag kflag-mexico" role="img" aria-label="Mexico" /> Mexico                | `service@paypal.com.mx`   |
    | <span className="kflag kflag-canada" role="img" aria-label="Canada" /> Canada                | `service@paypal.ca`       |
    | <span className="kflag kflag-netherlands" role="img" aria-label="Netherlands" /> Netherlands | `service@paypal.nl`       |
    | <span className="kflag kflag-belgium" role="img" aria-label="Belgium" /> Belgium             | `service@paypal.be`       |
    | <span className="kflag kflag-poland" role="img" aria-label="Poland" /> Poland                | `service@paypal.pl`       |
    | <span className="kflag kflag-sweden" role="img" aria-label="Sweden" /> Sweden                | `service@paypal.se`       |
    | <span className="kflag kflag-india" role="img" aria-label="India" /> India                   | `service@paypal.co.in`    |
    | <span className="kflag kflag-singapore" role="img" aria-label="Singapore" /> Singapore       | `service@paypal.com.sg`   |
    | <span className="kflag kflag-hong-kong" role="img" aria-label="Hong Kong" /> Hong Kong       | `service@paypal.com.hk`   |
    | 🌍 International                                                                             | `service@intl.paypal.com` |

    3. Enter your region's address (e.g., `service@paypal.com`) in the **From** field.

    <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="Create Filter Step 1" width="1470" height="746" data-path="images/paypal/5.png" />

    4. Click **Create filter**.
    5. Check **Forward it to:** and select the hermes email address.

    <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="Create Filter Step 2" width="1470" height="1166" data-path="images/paypal/6.png" />

    6. Click **Create filter**.
  </Step>

  <Step title="Test the Integration">
    Your PayPal integration is configured.

    We strongly recommend making a **\$1 test payment** on your store to confirm that the system correctly detects the payment and marks the order as paid.
  </Step>
</Steps>