> ## 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 Cash App

> Configure Cash App payments with mail forwarding on Komerza

Follow this guide to connect your Cash App account to Komerza and automate payment confirmation via Gmail forwarding.

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

    <img className="block dark:hidden rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/cash-app/1-light.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=fdc40749fa234dc29d7f7dca2f099b4c" alt="Connect Cash App in Dashboard" width="1736" height="588" data-path="images/cash-app/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/cash-app/1-dark.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=94f96a680fe181bc66b5a6f1b3a07cd5" alt="Connect Cash App in Dashboard" width="1742" height="632" data-path="images/cash-app/1-dark.png" />
  </Step>

  <Step title="Configure 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/cash-app/2-light.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=e2e135bc461b433660eea0798360f18c" alt="Cash App Settings Dialog" width="1412" height="1440" data-path="images/cash-app/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/cash-app/2-dark.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=38c6b31f31766a18447a30562154eb7c" alt="Cash App Settings Dialog" width="1450" height="1418" data-path="images/cash-app/2-dark.png" />

    * **Cash Tag**: Enter your unique Cash App tag (e.g., `$YourName`).
    * **Email Address**: The email associated with your Cash App account that receives payment receipts.

    <Note>
      We highly recommend using a **Gmail** address. Other email providers may not be supported or may experience delivery issues.
    </Note>

    ### Advanced Options

    <AccordionGroup>
      <Accordion title="Notes Version">
        **Version 2 (Recommended)**: More realistic notes that are harder to detect, helping to reduce the risk of account bans.
        **Version 1**: Basic notes. Use only if you have a specific preference.
      </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 Cash App frequently forces you to manually accept payments in the app.</Warning>
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Setup Email Forwarding">
    After clicking Next, copy the unique forwarding email address ending in `@hermes.komerza.com`.

    <img className="block dark:hidden rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/cash-app/3-light.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=63c8420c4855ecd5cab756a76b3f4b8b" alt="Copy Forwarding Email" width="1378" height="1214" data-path="images/cash-app/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/cash-app/3-dark.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=dec14b1883be0433231df8cbe2089d13" alt="Copy Forwarding Email" width="1376" height="1250" data-path="images/cash-app/3-dark.png" />

    ### Add Forwarding Address in Gmail

    1. Login to Gmail and go to **Settings** > **See all settings** > **Forwarding and POP/IMAP**.
    2. Click **Add a forwarding address**, paste the `@hermes.komerza.com` address, and click **Next**.
    3. Complete the Google identity verification step.
    4. Check your inbox (or spam) for the confirmation email and click the confirmation link.

    ### Configure Forwarding Filter

    <Warning>
      **Important:** Return to the **Forwarding and POP/IMAP** tab and ensure **"Disable forwarding"** is selected. Do not enable global forwarding.
    </Warning>

    1. Click **"creating a filter"** link in the "Forwarding" section.
    2. Set **From** to `cash@square.com`.

    <img className="block rounded-lg border border-gray-200 dark:border-gray-800" src="https://mintcdn.com/komerza/UInWQBC_HudBwafj/images/cash-app/4.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=1536f4c8b721f956cfc1505b9e6131b0" alt="Create Filter Step 1" width="1468" height="744" data-path="images/cash-app/4.png" />

    3. Click **Create filter**.
    4. 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/cash-app/5.png?fit=max&auto=format&n=UInWQBC_HudBwafj&q=85&s=7656b96ada6a9dc727597eef1aa72f8f" alt="Create Filter Step 2" width="1470" height="1162" data-path="images/cash-app/5.png" />

    5. Click **Create filter** to finish.
  </Step>

  <Step title="Test the Integration">
    Your Cash App integration is now set up!

    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>