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

# Pocketsflow badge

> The "Powered by Pocketsflow" badge on your buyer pages: keep it to earn free months, or hide it on a paid plan.

Every store shows a small **Powered by Pocketsflow** badge in the footer of
its buyer pages. The badge is also your referral link: when a buyer clicks it,
opens their own store and makes a first payment, you earn **one free month of
your plan**.

## Where the badge shows

* your storefront and Link in Bio page
* product pages and the checkout
* subscription pages and the subscriber portal
* invoices and the refund policy page
* the footer of the receipt email your buyers get

The receipt still names Pocketsflow as the company that processed the payment.
That line is not the badge and always stays.

## Earn a free month for every store it brings in

The badge links to `https://www.pocketsflow.com/?ref=<your code>`. Your code
looks like `PF-k3x9q2m7v1` and is the same on every page.

<Steps>
  <Step title="A buyer clicks your badge">
    The click is counted, and the code is remembered for 30 days.
  </Step>

  <Step title="They open their own store">
    When they sign up, the store is attributed to you.
  </Step>

  <Step title="Their store makes its first payment">
    Either its first paid sale or its first paid plan payment.
  </Step>

  <Step title="After 14 days, you earn a free month">
    Once that payment has cleared 14 days without a refund, you earn one free
    month of your current plan.
  </Step>
</Steps>

How the free month is used:

| Your plan | What happens |
| - | - |
| Paid, monthly | Your next renewal is free. One free month per billing period; extra months wait for the next one. |
| Paid, yearly | The month is kept in your balance and applies once you are on a monthly plan. |
| Free | The month is kept in your balance. Your first month is free when you choose a monthly plan. |

You can earn **up to 12 free months a year**. See your clicks, signups and
free months in **Partner Program → Your badge earns**, or with the API.

<Note>
  Referrals never count when the two stores belong to the same person (same
  email, company email domain, network, device or payout details), or when
  either store is suspended, deleted or flagged for fraud. A store under
  review waits until the review is done.
</Note>

## Hide the badge

On the **Starter** plan or higher, go to **Settings → Pocketsflow badge** and
turn off **Show the Pocketsflow badge**. It disappears from every page and
from receipts right away.

* A hidden badge has no link, so it earns no free months. Paid plans can hide
  the badge or keep it to earn.
* If your paid plan ends, the badge shows again. Your choice is kept, so it
  hides again when you upgrade.

## With the API or an AI assistant

| Task | API | MCP tool |
| - | - | - |
| Read the setting and stats | `GET /powered-by/me` | `get_referral_badge_stats` |
| Show or hide the badge | `PUT /powered-by` | `update_store_badge` |

```bash theme={"system"}
curl -X PUT https://api.pocketsflow.com/powered-by \
  -H "Authorization: Bearer $POCKETSFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "showPoweredBy": false }'
```

On the Free plan, hiding answers `403` with `code: "FEATURE_LOCKED"` and
`details.requiredPlan: "tier1"`. See the [endpoint reference](/api-reference/endpoints#store-badge).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.