{displayImage ? (

) : (

📸

{isDragActive ? "Drop the image here..." : "Drag & drop an image here, or click to select"}

Supports JPG, PNG, GIF

)}

{image && (

{uploadProgress > 0 && uploadProgress < 100 && (

)}

); } ``` ### `` This component displays the experience prompt and image uploader. ```typescript app/components/experience-prompt.tsx [expandable] import type { AccessLevel } from "@whop/api"; import Link from "next/link"; import ImageUploader from "./image-uploader"; import { Button } from "./ui/button"; export default function ExperiencePrompt({ prompt, accessLevel, experienceId, }: { prompt: string; accessLevel: AccessLevel; experienceId: string; }) { return (

{prompt ? `"${prompt}"` : "Creator has not set a prompt yet."}

{accessLevel === "admin" && (

)} {prompt ? : null}

); } ``` ### `` This component allows admins to edit the experience prompt. ```typescript app/components/edit-experience-prompt.tsx [expandable] "use client"; import { useState } from "react"; import { useRouter } from "next/navigation"; import { Button } from "@/components/ui/button"; export default function EditExperiencePage({ experienceId, }: { experienceId: string; }) { const router = useRouter(); const [prompt, setPrompt] = useState(""); const [isLoading, setIsLoading] = useState(false); const handleSubmit = async (e: React.FormEvent) => { e.preventDefault(); setIsLoading(true); try { const response = await fetch(`/api/experiences/${experienceId}`, { method: "PUT", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ prompt }), }); if (!response.ok) { throw new Error("Failed to update experience"); } router.push(`/experiences/${experienceId}`); router.refresh(); } catch (error) { console.error("Error updating experience:", error); // You might want to show an error message to the user here } finally { setIsLoading(false); } }; return (

Edit Prompt

Prompt

setPrompt(e.target.value)}
            className="w-full min-h-[200px] p-3 border border-gray-300 rounded-md focus:outline-none focus:ring-2 focus:ring-blue-500"
            placeholder="Enter a new prompt here..."
            required
          />
        </div>

<div className="flex gap-4">
          <Button
            type="submit"
            disabled={isLoading}
            className="bg-blue-500 hover:bg-blue-600 text-white"
          >
            {isLoading ? "Saving..." : "Save Changes"}
          </Button>

<Button
            type="button"
            variant="outline"
            onClick={() => router.back()}
            disabled={isLoading}
          >
            Cancel
          </Button>
        </div>
      </form>
    </div>
  );
}
```

## 6. Create pages

### `app/experiences/[experienceId]/page.tsx`

This page displays the experience prompt and the image uploader. If the user is an admin, they can edit the prompt.

```typescript app/experiences/[experienceId]/page.tsx [expandable]
import ExperiencePrompt from "@/components/experience-prompt";
import { whopSdk } from "@/lib/whop-sdk";
import { PrismaClient } from "@prisma/client";
import { headers } from "next/headers";

const prisma = new PrismaClient();

async function findOrCreateExperience(experienceId: string) {
  let experience = await prisma.experience.findUnique({
    where: { id: experienceId },
  });

if (!experience) {
    experience = await prisma.experience.create({
      data: {
        id: experienceId,
        prompt: "",
      },
    });
  }

return experience;
}

export default async function ExperiencePage({
  params,
}: {
  params: Promise<{ experienceId: string }>;
}) {
  const headersList = await headers();
  const { userId } = await whopSdk.verifyUserToken(headersList);

const { experienceId } = await params;
  const experience = await findOrCreateExperience(experienceId);

const hasAccess = await whopSdk.access.checkIfUserHasAccessToExperience({
    userId,
    experienceId,
  });

return (
    <div className="flex flex-col gap-4 p-4 h-screen items-center justify-center">
      <ExperiencePrompt
        prompt={experience.prompt}
        accessLevel={hasAccess.accessLevel}
        experienceId={experienceId}
      />
    </div>
  );
}
```

### `app/experiences/[experienceId]/edit/page.tsx`

This page allows admins to edit the experience prompt.

```typescript app/experiences/[experienceId]/edit/page.tsx [expandable]
import EditExperiencePrompt from "@/components/edit-experience-prompt";

export default async function Page({
  params,
}: {
  params: Promise<{ experienceId: string }>;
}) {
  const { experienceId } = await params;
  return <EditExperiencePrompt experienceId={experienceId} />;
}
```

## 7. Create the API routes

### `app/api/experiences/[experienceId]/generate/route.ts`

This API route generates images using OpenAI's DALL-E API.

```typescript app/api/experiences/[experienceId]/generate/route.ts [expandable]
import { whopSdk } from "@/lib/whop-sdk";
import { PrismaClient } from "@prisma/client";
import { headers } from "next/headers";
import { NextResponse } from "next/server";
import OpenAI from "openai";
import sharp from "sharp";

const prisma = new PrismaClient();

const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
});

export async function POST(
  request: Request,
  { params }: { params: Promise<{ experienceId: string }> }
) {
  try {
    const { experienceId } = await params;

if (!experienceId) {
      return NextResponse.json(
        { error: "Missing experienceId" },
        { status: 400 }
      );
    }

const hasAccess = await whopSdk.access.checkIfUserHasAccessToExperience({
      userId: userToken.userId,
      experienceId,
    });

if (!hasAccess.hasAccess) {
      return NextResponse.json(
        { error: "Unauthorized, no access" },
        { status: 401 }
      );
    }

const [publicUser, experience] = await Promise.all([
      whopSdk.users.getUser({
        userId: userToken.userId,
      }),
      prisma.experience.findUnique({
        where: {
          id: experienceId,
        },
      }),
    ]);

if (!request.body || !experience?.prompt) {
      return NextResponse.json(
        { error: "Image and prompt are required" },
        { status: 400 }
      );
    }

const originalFile = new File(
      [
        await sharp(await request.clone().arrayBuffer())
          .png()
          .toBuffer(),
      ],
      `${Date.now()}-original.png`,
      {
        type: "image/png",
      }
    );

// Generate image using DALL-E with prompt
    const response = await openai.images.edit({
      model: "gpt-image-1",
      image: originalFile,
      prompt: experience.prompt,
      n: 1,
      size: "auto",
      quality: "low",
    });

console.log("Response:", response);

// Get the base64 image data from the response
    const base64Image = response.data?.[0]?.b64_json;
    if (!base64Image) {
      throw new Error("No image data returned from OpenAI");
    }
    const generatedImageBuffer = Buffer.from(base64Image, "base64");

const generationId = crypto.randomUUID();

const [originalFileUploadResponse, uploadResponse] = await Promise.all([
      whopSdk.attachments.uploadAttachment({
        file: originalFile,
        record: "forum_post",
      }),
      whopSdk.attachments.uploadAttachment({
        file: new File(
          [generatedImageBuffer],
          `${generationId}-generated.png`,
          {
            type: "image/png",
          }
        ),
        record: "forum_post",
      }),
    ]);

const whopExperience = await whopSdk.experiences.getExperience({
      experienceId,
    });
    const companyId = whopExperience.experience.company.id;

const generatedAttachmentId = uploadResponse.directUploadId;
    const originalAttachmentId = originalFileUploadResponse.directUploadId;

const forum = await whopSdk.forums.findOrCreateForum({
      experienceId: experience.id,
      name: "AI Uploads",
    });

const forumId = forum.createForum?.id;

const post = await whopSdk.forums.createForumPost({
      forumExperienceId: forumId,
      content: `@${publicUser.publicUser?.username} generated this image with the prompt: "${experience.prompt}"\n\nTry it yourself here: https://whop.com/hub/${companyId}/${experience.id}/app\n\nBefore vs After ⬇️`,
      attachments: [
        { directUploadId: originalAttachmentId },
        { directUploadId: generatedAttachmentId },
      ],
    });

return NextResponse.json({
      success: true,
      imageUrl: uploadResponse.attachment.source.url,
      postId: post?.id,
    });
  } catch (error) {
    console.error("Error generating image:", error);
    return NextResponse.json(
      { error: "Failed to generate image" },
      { status: 500 }
    );
  }
}
```

### `app/api/experiences/[experienceId]/route.ts`

This API route is a PUT operation to an experience in the database.

```typescript app/api/experiences/[experienceId]/route.ts [expandable]
import { whopSdk } from "@/lib/whop-sdk";
import { PrismaClient } from "@prisma/client";
import { headers } from "next/headers";
import { NextResponse } from "next/server";
import { prisma } from "@/lib/db";

export async function PUT(request: Request) {
  try {
    const { prompt } = await request.json();
    const headersList = await headers();
    const userToken = await whopSdk.verifyUserToken(headersList);
    if (!userToken) {
      return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
    }
    const url = new URL(request.url);
    const match = url.pathname.match(/experiences\/([^/]+)/);
    const experienceId = match ? match[1] : null;

if (!experienceId) {
      return NextResponse.json(
        { error: "Missing experienceId" },
        { status: 400 }
      );
    }

const hasAccess = await whopSdk.access.checkIfUserHasAccessToExperience({
      userId: userToken.userId,
      experienceId,
    });
    if (hasAccess.accessLevel !== "admin") {
      return NextResponse.json(
        { error: "Unauthorized, not admin" },
        { status: 401 }
      );
    }

const updatedExperience = await prisma.experience.update({
      where: {
        id: experienceId,
      },
      data: {
        prompt,
      },
    });

await whopSdk.notifications.sendNotification({
      content: prompt,
      experienceId,
      title: "Prompt updated ✨",
    });

return NextResponse.json(updatedExperience);
  } catch (error) {
    console.error("Error updating experience:", error);
    return NextResponse.json(
      { error: "Failed to update experience" },
      { status: 500 }
    );
  }
}
```

## 8. Deploy to Vercel

1. Add this script to the `scripts` section of your `package.json` to generate the Prisma client:

```json package.json
  "scripts": {
    "postinstall": "prisma generate"
  }
```

2. Push your code to GitHub
3. Create a new project on [Vercel](https://vercel.com)
4. Import your GitHub repository
5. Add all environment variables
6. Deploy and copy your Vercel URL
7. Update your Whop app settings with the new URL in the "Base URL" field

> Vercel functions automatically timeout after 60 seconds on a hobby account. Images might take longer than 60 seconds. This will cause errors. You can upgrade to a paid account to avoid this or swap out the image generator to a different API.

Your AI image generation app is now ready! Users can upload images, apply AI transformations based on prompts, and share their creations in the community forum.

## Need Help?

* Join the [Developer Whop](https://whop.com/developers)
* View the source code of this app [here](https://github.com/whopio/whop-sdk-ts/tree/main/examples/ai-image-generator)
* DM [@s on Whop](https://whop.com/@s)

***

# Chat bot
Source: https://docs.whop.com/apps/tutorials/chat-bot

Build a production-ready AI support bot that intelligently answers questions in whop communities.

<Tip>
  This tutorial was submitted by [@script](https://whop.com/@script), a member
  of the Whop Developers community. [Submit your own
  tutorial](https://whop.com/developers) and get paid real \$!
</Tip>

## Summary

This tutorial will guide you through building a chat bot that can answer questions in whop communities. View the final product
[here](https://whop.com/apps/app_3rqpGo1tsmPDHg/install/) by installing the app to your whop.

## 1. Set up your Next.js project

Clone the AI Support Bot repository:

```bash
git clone https://github.com/VortexxJS/whop-ai-support (not available yet)
cd whop-ai-bot
```

Install dependencies:

<CodeGroup>
  ```bash npm
   npm install
  ```

```bash pnpm
  pnpm install
  ```

```bash yarn
  yarn instal
  ```
</CodeGroup>

## 2. Get your Whop API credentials

<Steps>
  <Step title="Create a Whop App">
    1. Go to [https://whop.com/dashboard/developer](https://whop.com/dashboard/developer)
    2. Navigate to **Developer**
    3. Click the **Create App** button
    4. Give your app a name like "AI Support Bot"
    5. Click **Create**
  </Step>

<Step title="Get your API Key, Agent User ID, and App ID">
    After creating your app:

1. Copy the **App API Key** - you'll need this for `WHOP_API_KEY`
    2. Copy the **Agent User ID** - you'll need this for `NEXT_PUBLIC_WHOP_AGENT_USER_ID`
    3. Copy the **App ID** - you'll need this for `NEXT_PUBLIC_WHOP_APP_ID`

{" "}

<Note>
      The Agent User ID is what allows your bot to send messages on behalf of your
      app.
    </Note>
  </Step>
</Steps>

## 3. Set up Supabase Database

<Steps>
  <Step title="Create a Supabase Project">
    1. Go to [https://supabase.com](https://supabase.com)
    2. Click **Start your project**
    3. Sign in or create an account
    4. Click **New project**
    5. Choose your organization
    6. Enter a **Database Name** (e.g., "ai-support-bot")
    7. Enter a **Database Password** (save this!)
    8. Select a **Region** close to your users
    9. Click **Create new project**
  </Step>

<Step title="Get Database Connection Strings">
    Once your project is created:

1. Go to **Settings** → **Database**
    2. Scroll down to **Connection string**
    3. Copy the **URI** format for `DATABASE_URL`
    4. Copy the **Direct connection** for `DIRECT_URL`

{" "}

<Warning>
      Replace `[YOUR-PASSWORD]` in both URLs with the database password you created.
    </Warning>
  </Step>
</Steps>

## 4. Get OpenRouter AI API Key

<Steps>
  <Step title="Create OpenRouter Account">
    1. Go to [https://openrouter.ai](https://openrouter.ai)
    2. Click **Sign In** or **Sign Up**
    3. Complete the registration process
  </Step>

<Step title="Get API Key">
    1. Go to **Keys** in the dashboard
    2. Click **Create Key**
    3. Give it a name like "AI Support Bot"
    4. Copy the API key - you'll need this for `OPENROUTER_API_KEY`

{" "}

<Info>
      OpenRouter gives you \$1 free credit when you sign up, which is more than
      enough for testing with Gemini 2.0 Flash!
    </Info>
  </Step>
</Steps>

## 5. Configure Environment Variables

<Steps>
  <Step title="Copy Environment Template">
    ```bash
    cp env.example .env
    ```
  </Step>

<Step title="Fill in Required Variables">
    Open `.env` in your text editor and fill in these required fields:

```env
    # Database Configuration (Required)
    DATABASE_URL="postgresql://postgres:[YOUR-PASSWORD]@[HOST]:6543/postgres?pgbouncer=true"
    DIRECT_URL="postgresql://postgres:[YOUR-PASSWORD]@[HOST]:5432/postgres"

# AI Service Configuration (Required)
    OPENROUTER_API_KEY="your_openrouter_api_key_here"
    OPENROUTER_MODEL="google/gemini-2.0-flash-001"

# Whop Integration (Required)
    WHOP_API_KEY="your_whop_app_api_key_here"
    NEXT_PUBLIC_WHOP_AGENT_USER_ID="your_bot_user_id_here"
    NEXT_PUBLIC_WHOP_APP_ID="your_whop_app_id_here"
    ```

{" "}

<Info>All other variables are optional and have sensible defaults.</Info>
  </Step>
</Steps>

## 6. Set up the Database

Push the database schema to Supabase:

```bash
npm run db:push
```

This will create the necessary tables:

* `companies` - Store bot settings for each Whop company
* `experience_mappings` - Map Whop experiences to companies

## 7. Install Whop Dev Proxy

For Whop integration to work in development, you need to install the Whop dev proxy globally:

```bash
npm install @whop-apps/dev-proxy -g
```

<Note>
  The Whop dev proxy is required for the iframe integration to work properly
  during development.
</Note>

## 8. Run the Application

<Steps>
  <Step title="Start the Web Server with Whop Proxy">
    Run this command to start both the Whop proxy and Next.js development server:

```bash
    whop-proxy --command 'npx next dev --turbopack'
    ```

You should see output indicating both the proxy and Next.js are running. The web app will be available at [http://localhost:3000](http://localhost:3000)

<Warning>
      Do NOT use `npm run dev` alone - it won't include the Whop proxy and the iframe integration won't work!
    </Warning>
  </Step>

<Step title="Start the AI Bot (New Terminal)">
    In a new terminal window:

```bash
    npm run bot
    ```

You should see:

```
    🚀 Starting Whop AI Bot...

Features:
      • Smart AI question detection
      • Admin-only configuration
      • Real-time responses
      • Rate limiting & caching

✅ Bot connected to Whop
    🤖 Listening for messages and commands...
    ```
  </Step>
</Steps>

## 9. Configure App Settings in Whop

**Important**: You must configure these settings BEFORE installing the app to your community.

<Steps>
  <Step title="Set Base URL and App Path">
    1. Go to your Whop app dashboard → **Developer** → Your App
    2. In the **Hosting** section, configure:
       * **Base URL**: `http://localhost:3000/`
       * **App path**: `/company/[companyId]`
    3. Click **Save** to update the settings

<Warning>
      If you skip this step, the app installation and iframe integration won't work properly!
    </Warning>
  </Step>
</Steps>

## 10. Install to Your Whop Community

1. Go to your Whop company dashboard
2. Navigate to **Settings** → **API
   keys**
3. Click on your AI Support Bot app
4. Find and copy the **Installation Link**
5. Visit the installation link and grant the necessary
   permissions

## 11. Configure Your Bot

<Steps>
  <Step title="Access Bot Settings via Whop iframe">
    1. After installing the app, click **Open Whop** in the top right
    2. When redirected to Whop, click the **Settings** button
    3. Change the dropdown from **Production** to **Localhost**
    4. Choose your port (usually **3000**)
    5. You'll now see the bot configuration dashboard

<Note>
      Only company admins can access the bot settings page.
    </Note>
  </Step>

<Step title="Set Up Your Bot">
    Configure these settings:

* **Enable Bot**: Turn on the AI responses
    * **Knowledge Base**: Add information about your community
    * **Response Style**: Choose professional, friendly, casual, or technical
    * **Preset Q\&A**: Add common questions with instant answers
    * **Custom Instructions**: Fine-tune the AI's behavior
  </Step>
</Steps>

## 12. Test Your Bot

1. Go to your Whop community chat
2. Ask a question like "How do I join?"
3. The bot should respond within a few seconds

## Troubleshooting

<AccordionGroup>
  <Accordion title="Bot not responding to messages">
    1. Check that both the web server and bot are running
    2. Verify your environment variables are correct
    3. Look for errors in the bot console output
    4. Make sure the bot is enabled in the settings dashboard
  </Accordion>

<Accordion title="Database connection errors">
    1. Verify your Supabase database URLs are correct
    2. Make sure you replaced
       `[YOUR-PASSWORD]` with your actual password
    3. Check that your Supabase
       project is active
    4. Try running `npm run db:push` again
  </Accordion>

<Accordion title="AI responses not working">
    1. Verify your OpenRouter API key is correct
    2. Make sure the bot is enabled
    3. Verify the knowledge base is not empty
    4. Check the bot console for any
       AI-related errors
  </Accordion>

<Accordion title="Can't access bot settings">
    1. Make sure you're using the Whop iframe method
    2. Ensure you've set the environment to localhost with correct port
    3. Verify you're a company admin in Whop
    4. Check that your Whop App API key is correct
  </Accordion>
</AccordionGroup>

## What's Next?

Your AI Support Bot is now ready! Here are some next steps:

* **Customize responses**: Add more preset Q\&A pairs for instant answers
* **Train the AI**: Update the knowledge base with community-specific information
* **Monitor usage**: Check the bot console for statistics and performance
* **Scale up**: Deploy to production using Vercel, Railway, or your preferred platform

<Note>
  The bot saves 80-90% on AI costs through smart question detection and caching.
  Perfect for high-volume communities!
</Note>

## Need Help?

* Join the [Developer Whop](https://whop.com/developers)
* View the source code of this app [here](https://github.com/AbdullahZHD/car-modification-ai-whop)
* DM [@script on Whop](https://whop.com/@script)

***

# Fees
Source: https://docs.whop.com/fees

We want to be the cheapest, most resilient place to accept pure payments.

import { Button } from "@/components/ui/button";

<CardGroup cols={3}>
  <Card style={{ border: "none" }} title="Global access" icon="globe">
    195 countries, 135+ currencies, 100+ payment methods.
  </Card>

<Card style={{ border: "none" }} title="Fraud prevention" icon="shield-check">
    Powerful machine learning that adapts to new fraud patterns.
  </Card>

<Card title="Optimized checkout" icon="cart-shopping">
    Flexible UI components and accelerated checkout.
  </Card>

<Card title="Payment optimizations" icon="chart-line">
    Real-time retries & auto-updated cards to boost revenue.
  </Card>

<Card title="Financing options" icon="chart-line">
    Let your customers pay over time with Klarna, Afterpay, and more.
  </Card>

<Card title="Embedded payments" icon="building-columns">
    Instant onboarding and platform management tools.
  </Card>

<Card title="Fast, predictable payouts" icon="check">
    Flexible payout options with like-for-like settlement.
  </Card>

<Card title="24×7 support" icon="headset">
    Phone, chat, and email assistance whenever you need.
  </Card>

<Card title="Security & compliance" icon="shield">
    99.999% uptime and PCI-compliant infrastructure.
  </Card>
</CardGroup>

<div className="flex flex-col">
          <h2 className="p-0 mx-0 my-0">Payments</h2>
          <p className="m-0 p-0">An online payments platform engineered for growth.</p>
        </div>
      </div>

<div>
        [Start today →](/apps/docs/payments/taxes)
      </div>
    </div>

<div className="space-y-2">
      <div>
        <Icon icon="check" iconType="solid" /> Increase customer acquisition with 100+ payment methods.
      </div>

<div>
        <Icon icon="check" iconType="solid" /> Improve conversion with Whop's accelerated checkout.
      </div>

<div>
        <Icon icon="check" iconType="solid" /> Save engineering time with prebuilt UIs.
      </div>
    </div>

<div className="-mx-6 border-t mb-6 border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 md:grid-cols-2 gap-6 p-6">
        <div>
          <h3>Cards and wallets</h3>

<p className="mb-4">
            Accept widely used credit and debit cards, prepaid cards, and digital
            wallets for online payments.
          </p>

<div className="text-gray-700 dark:text-gray-300">
            per successful transaction for domestic cards<br /><br />
            <span className="text-gray-500">+ 1.5% for international cards</span><br />
            <span className="text-gray-500">+ 1% if </span><span className="text-[#6366f1]">currency conversion</span><span className="text-gray-500"> is required</span>
          </div>
        </div>
      </div>
    </div>

<br />

<div className="-mx-6 border-t mb-6 border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 md:grid-cols-2 gap-6 p-6">
        <div>
          <h3>Financing</h3>

<p className="mb-4">
            Give your customers the flexibility to split their purchases into monthly installments while you get paid upfront.
          </p>

<div className="text-gray-700 dark:text-gray-300">
            per successful transaction through our financing partners<br /><br />
          </div>
        </div>
      </div>
    </div>

<br />

<p className="mb-4">
            Accept ACH direct debit payments from US bank accounts.
          </p>

<div className="text-gray-700 dark:text-gray-300">
            per successful ACH debit transaction
          </div>
        </div>
      </div>
    </div>

<div className="flex flex-col mx-0 my-0">
          <h2 className="m-0 p-0 mx-0 my-0">Payouts</h2>
          <p className="m-0 p-0">Accept money and get paid out as fast as you want.</p>
        </div>
      </div>

<div>[Start today →](/apps/docs/payments/taxes)</div>
    </div>

<div className="space-y-2">
      <div>
        <Icon icon="check" iconType="solid" /> Get paid anywhere in the world with global payout options.
      </div>

<div>
        <Icon icon="check" iconType="solid" /> Flexible payout methods including crypto, Venmo, and wire transfers.
      </div>

<div>
        <Icon icon="check" iconType="solid" /> Same-day payouts available for immediate cash flow.
      </div>
    </div>

<p className="mb-4">
            Accelerated ACH transfer to U.S. bank accounts, delivered by the next business day (faster settlement speed).
          </p>
        </div>

<div className="text-gray-700 dark:text-gray-300">
            per successful payout
          </div>
        </div>
      </div>
    </div>

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Instant Bank Deposit (RTP)</h3>

<p className="mb-4">
            Real-time bank transfer to supported accounts with funds available instantly (where supported).
          </p>
        </div>

<div className="text-gray-700 dark:text-gray-300">
            per successful payout
          </div>
        </div>
      </div>
    </div>

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Crypto</h3>

<p className="mb-4">
            Cryptocurrency payout (e.g. Bitcoin, Ethereum) with global reach.
          </p>
        </div>

<div className="text-gray-700 dark:text-gray-300">
            per successful payout
          </div>
        </div>
      </div>
    </div>

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Venmo</h3>

<p className="mb-4">
            Instant payout to a recipient's Venmo wallet (available for U.S. recipients only).
          </p>
        </div>

<div className="text-gray-700 dark:text-gray-300">
            per successful payout
          </div>
        </div>
      </div>
    </div>

<p className="mb-4">
            Traditional bank wire transfer (will typically take 1–2 business days to process in the US).
          </p>
        </div>

<div className="text-gray-700 dark:text-gray-300">
            per successful payout
          </div>
        </div>
      </div>
    </div>

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>International local banks</h3>

<p className="mb-4">
            Local bank transfer in your country and currency (timing varies by country).
          </p>
        </div>

<div className="text-sm">
          <h3>Varies by country</h3>

<div className="text-gray-700 dark:text-gray-300">
            per successful payout
          </div>
        </div>
      </div>
    </div>
  </div>
</Update>

<div className="flex flex-col">
          <h2 className="m-0 p-0">Fraud and security</h2>
          <p className="m-0 p-0">Protect your business against fraud and disputes.</p>
        </div>
      </div>

<div>[Start today →](/apps/docs/payments/taxes)</div>
    </div>

<div className="space-y-2">
      <div>
        <Icon icon="check" iconType="solid" /> 0% of transaction amount.
      </div>

<div>
        <Icon icon="check" iconType="solid" /> Transparent flat-rate pricing per event.
      </div>

<div>
        <Icon icon="check" iconType="solid" /> No hidden fees. No guessing.
      </div>
    </div>

<p className="mb-4">
            Fee for authenticating cards using 3D Secure to reduce fraud.
          </p>
        </div>

<div className="text-gray-700 dark:text-gray-300">
            per transaction
          </div>
        </div>
      </div>
    </div>

<div className="-mx-6 mb-4 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Radar</h3>

<p className="mb-4">
            ML-based fraud detection fee.
          </p>
        </div>

<div className="text-gray-700 dark:text-gray-300">
            per transaction
          </div>
        </div>
      </div>
    </div>

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Dispute</h3>

<p className="mb-4">
            Flat fee applied when a chargeback or dispute occurs.
          </p>
        </div>

<div className="text-gray-700 dark:text-gray-300">
            per dispute
          </div>
        </div>
      </div>
    </div>

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Early dispute alert (RDR)</h3>

<p className="mb-4">
            Proactive chargeback notification fee.
          </p>
        </div>

<div className="text-gray-700 dark:text-gray-300">
            per alert
          </div>
        </div>
      </div>
    </div>

<br />

<div className="flex flex-col">
          <h2 className="m-0 p-0">Revenue optimization and automation</h2>
          <p className="m-0 p-0">Tools to reduce payment failures and increase revenue.</p>
        </div>
      </div>

<div>[Start today →](/apps/docs/payments/taxes)</div>
    </div>

<div className="space-y-2">
      <div>
        <Icon icon="check" iconType="solid" /> Automated systems that boost revenue and reduce churn.
      </div>

<div>
        <Icon icon="check" iconType="solid" /> Pricing optimized to reflect real cost of global scale infra.
      </div>

<div>
        <Icon icon="check" iconType="solid" /> Transparent and minimal fees per event.
      </div>
    </div>

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Orchestration</h3>

<p className="mb-4">
            Route payments through multiple payment service providers to boost revenue by \~6%.
          </p>
        </div>

<div className="text-sm">
          <h3>0.8%</h3>
          <div className="text-gray-700 dark:text-gray-300">per transaction (when enabled)</div>
        </div>
      </div>
    </div>

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Billing</h3>

<p className="mb-4">
            Automated invoice generation, retries, and lifecycle handling.
          </p>
        </div>

<div className="text-sm">
          <h3>0.5%</h3>
          <div className="text-gray-700 dark:text-gray-300">per transaction</div>
        </div>
      </div>
    </div>

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Tax and remittance</h3>

<p className="mb-4">
            Handle global tax calculation, collection, and compliance.
          </p>
        </div>

<div className="text-sm">
          <h3>0.5%</h3>
          <div className="text-gray-700 dark:text-gray-300">per transaction (when enabled)</div>
        </div>
      </div>
    </div>

<br />

<div className="flex flex-col">
          <h2 className="m-0 p-0">Service fees</h2>
          <p className="m-0 p-0">Transparent service fees with no hidden costs or surprises.</p>
        </div>
      </div>

<div>[Start today →](/apps/docs/payments/taxes)</div>
    </div>

<div />

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Whop platform fee</h3>

<p className="mb-4">
            Applied only to purchases with automations like Discord, Telegram, and Trading View.
          </p>
        </div>

<div className="text-sm">
          <h3>3%</h3>
          <div className="text-gray-700 dark:text-gray-300">per transaction</div>
        </div>
      </div>
    </div>

<div className="-mx-6 mb-6 border-t border-gray-200 dark:border-gray-800">
      <div className="grid grid-cols-1 gap-6 md:grid-cols-2 p-6">
        <div>
          <h3>Service Fee</h3>

<p className="mb-4">
            General platform and infrastructure fee to support core functionality (charged to buyers).
          </p>
        </div>

<div className="text-sm">
          <h3>0%</h3>
          <div className="text-gray-700 dark:text-gray-300">per transaction</div>
        </div>
      </div>
    </div>
  </div>
</Update>

Interested in what other platforms charge? Pricing above is applicable to new merchants that sign up today. For enterprise customers, please book a call with our sales team [here](https://calendly.com/d/cv3h-5mq-vc2/whop-payments-enterprise-call).

| Platform  | Pricing                                                                    |
| --------- | -------------------------------------------------------------------------- |
| Stripe    | [stripe.com/pricing](https://stripe.com/pricing)                           |
| Square    | [squareup.com/pricing](https://squareup.com/us/en/pricing)                 |
| Shopify   | [shopify.com/pricing](https://www.shopify.com/pricing)                     |
| Braintree | [braintreepayments.com/pricing](https://www.braintreepayments.com/pricing) |
| Adyen     | [adyen.com/pricing](https://www.adyen.com/pricing)                         |

# What is Whop?
Source: https://docs.whop.com/get-started

Whop is a platform to launch and scale internet businesses.

Whop is on a mission to deliver everyone a sustainable income. That means that we help people choose what to sell, build their product, and get them customers. Businesses use Whop to sell information, software, and services.

<Check>Businesses on Whop earn over \$1 billion every year.</Check>

## Get started

<CardGroup cols={1}>
  <Card title="Launch your business" icon="sparkles" href="/launch-your-business">
    Start an online business with a few clicks.
  </Card>
</CardGroup>

## Using Whop to accept payments

This works well if you've already built your business on other tools but want better payment processing.

<CardGroup cols={1}>
  <Card title="Start with payment processing" icon="credit-card" href="/payments/overview">
    Use Whop to process payments and create checkout links.
  </Card>
</CardGroup>

## Common business models

Learn how to set up popular business models on Whop:

<CardGroup cols={3}>
  <Card title="Educational programs" icon="people-group" href="/supported-business-models/educational-programs">
    Sell courses, workshops, and other educational programs.
  </Card>

<Card title="Agency services" icon="gear" href="/supported-business-models/agency-services">
    Send invoices, chat with clients, and get paid.
  </Card>

<Card title="Coaching" icon="graduation-cap" href="/supported-business-models/coaches">
    Charge for your services and organize your clients in one spot.
  </Card>
</CardGroup>

<CardGroup cols={3}>
  <Card title="Newsletters" icon="chart-line" href="/supported-business-models/newsletters">
    Publish long form writing and charge subscribers for exclusive content.
  </Card>

<Card title="Paid groups" icon="people-group" href="/supported-business-models/paid-groups">
    Build a paid community where members connect and share alpha.
  </Card>

<Card title="SaaS" icon="laptop" href="/supported-business-models/saas">
    Launch your app with built-in payments and user management.
  </Card>
</CardGroup>

<CardGroup cols={3}>
  <Card title="Events" icon="calendar" href="/supported-business-models/events">
    Run paid masterminds, events, and give attendees a unified place to chat.
  </Card>

<Card title="DTC Ecommerce" icon="gear" href="/supported-business-models/dtc-ecommerce">
    Sell physical products online with an out of the box social layer.
  </Card>

<Card title="Brick and Mortar" icon="store" href="/supported-business-models/brick-and-mortar">
    Accept in-store payments and manage memberships for your physical location.
  </Card>
</CardGroup>

# Launch your business
Source: https://docs.whop.com/launch-your-business

Create an account on Whop and launch your business.

To launch your online business on Whop, you first need to make an account.

<Steps>
  <Step title="Go to whop.com/sell" titleSize="h3">
    * Head over to [**whop.com/sell**](https://whop.com/sell)
    * Click **Start selling**
  </Step>

<Step title="Choose how you plan to use Whop" titleSize="h3">
    Select the option that matches how you plan to use Whop

1. **Build & sell digital products on Whop:** Choose this option if you plan to use Whop for building, hosting, and selling your digital products as well as accepting payments.
    2. **Use Whop for payment processing only:** Choose this option if you want to use Whop to process payments and create checkout links only - but host and deliver your product elsewhere.

Select the option that best fits how you plan to use Whop, then click **Next**.
  </Step>

<Step title="Name your business" titleSize="h3">
    Choose a name for your business.

<Tip>
      You can always change this later.
    </Tip>
  </Step>
</Steps>

## Next steps

To launch your internet business, make sure you’ve completed the rest of the setup steps:

<CardGroup cols={3}>
  <Card title="Add apps to your whop" icon="block-brick" href="/add-apps">
    Choose from dozens of apps to create exactly what you need.
  </Card>

<Card title="Set up pricing" icon="dollar-sign" href="/set-up-products-pricing">
    Choose your pricing model and what members get when they join.
  </Card>

<Card title="Set up your store page" icon="store" href="/set-up-store-page">
    Your store page is where visitors come to learn about your offer.
  </Card>
</CardGroup>

# Affiliate program
Source: https://docs.whop.com/manage-your-business/growth-marketing/affiliate-program

Learn how to set up an affiliate program for your whop

Set up your affiliate program to automatically pay commissions when someone refers a new paying member to your whop.

## How the affiliate program works

When someone uses a referral link to join your whop and makes a purchase, the person who referred them earns a commission.

Here's how it works:

* You turn on the affiliate program
* Users get access to their unique affiliate link for your whop
* They share their link anywhere they want
* When someone joins through their link, Whop automatically tracks the referral and pays the commission
* You can customize commission rates anytime to fit your business model

## How to set up your affiliate program

<Steps>
  <Step title="Go to your affiliate settings" titleSize="h3">
    To find your affiliate program:

1. Go to your **Dashboard**
    2. Make sure you're viewing the correct whop using the selection modal at the top left
    3. Click the **Marketing** dropdown
    4. Select **Affiliates**
  </Step>

<Step title=" Set commission rates for your whop" titleSize="h3">
    1. Click **Set the affiliate commission for a specific whop**
    2. You'll see all your whops with two key settings:
       * **Global affiliate rate:** This is the commission rate offered to any user who refers others to your whop. The default is 30%, but you can adjust it to any percentage you prefer
       * **Member affiliate rate:** This is the commission rate specifically for your existing members who refer others. This allows you to reward your community differently than general affiliates (e.g. members get 50% commission while the global rate is 30%)

<Tip>
      If you set the 'Member affiliate rate' to 0%, members will earn the global affiliate rate instead.
    </Tip>
  </Step>

<Step title="Activate your affiliate program" titleSize="h3">
    After making changes, click the blue tick button to confirm your new rates.
  </Step>
</Steps>

### How to create custom rates for partnerships

For special partnerships or top performers, you can create custom commission structures:

1. Click **Set an affiliate commission for a specific user**
2. Enter the user's Whop account email address
3. Configure their reward:
   * Choose between **Percent** and **Fixed amount**
   * Select **Recurring payments** (ongoing commissions) or **First payment** (one-time commission)
   * Select which whops this rate applies to
4. Click **Invite** to send them an invitation

## Payment timing

Whop automatically handles all affiliate payments for you. There is a 30-day waiting period between when a referred customer makes their purchase and when the affiliate receives their commission.

# Automated messages
Source: https://docs.whop.com/manage-your-business/growth-marketing/automated-messaging

Learn how to send automated marketing messages on Whop

You can set up automated messages on Whop to send personalized DMs and emails when:

1. Someone joins your whop;
2. Someone leaves your whop; and
3. Someone checks out your store page but doesn't buy.

## How to find the automated messages settings

1. **Open your Dashboard**: From your Whop account, click **Dashboard** on the left side of your screen to access your whop's advanced settings.
2. **Find Automated messages**: Under the **Marketing** section in your sidebar, click **Automated messages**.

Here, you'll see three automated message options: User joined, User left, and New lead.

## How to set up 'User joined' messages

Send welcome messages automatically when new members join your whop. Use this feature to greet new members, let them know what their next steps should be, or upsell your higher ticket offers (potentially even offering a discount code).

<Steps>
  <Step title="Enable the automation" titleSize="h3">
    Click **Enable automation** on the **User joined** card to activate this automated message.
  </Step>

<Step title="Set up your automated message" titleSize="h3">
    After enabling, you'll see several customization options:

* **Toggle button**: Turn this on or off anytime (top right)
    * **Message field**: Write the message that's sent to new members
    * **Variables**: Add these variables to personalize the message:
      * recipient\_name - Shows their actual name
      * whop\_name - Shows your whop's name
    * **Add media**: Upload images or videos to your message
    * **Send email option**: Check this box if you want users to also receive an email notification (in addition to the DM on Whop)
    * **Send message as**: Select which team member the message should appear to come from
  </Step>

<Step title="Save your settings" titleSize="h3">
    Click **Save** to activate your User joined automation.
  </Step>
</Steps>

## How to set up 'User left' messages

Send a message when someone leaves your whop and decides they don't want to be a member anymore. Use this feature to gather feedback (to learn why they left), or even try entice them back with a discount.

<Steps>
  <Step title="Enable the automation" titleSize="h3">
    Click **Enable automation** on the **User left** card to activate this automated message.
  </Step>

<Step title="Set up your automated message" titleSize="h3">
    After enabling, you'll see several customization options:

* **Toggle button**: Turn this on or off anytime (top right)
    * **Message field**: Write the message that will be sent to churned members
    * **Variables**: Add these variables to personalize the message:
      * recipient\_name - Shows their actual name
      * whop\_name - Shows your whop's name
    * **Add media**: Upload images or videos to your message
    * **Send email option**: Check this box if you want users to also receive an email notification (in addition to the DM on Whop)
    * **Send message as**: Select which team member the message should appear to come from
  </Step>

<Step title="Save your settings" titleSize="h3">
    Click **Save** to activate your User left automation.
  </Step>
</Steps>

## How to set up 'New lead' messages

Send messages to people who click on your popup promotions.

<Tip>
  For the 'New lead' messages to work properly, you first need to enable popup promotions.
</Tip>

<Steps>
  <Step title="Enable popup promotions on Whop" titleSize="h3">
    Before setting up New lead messages, enable popup promotions on your store page.

<Card title="Set up popup promotions" icon="hand-wave" href="/manage-your-whop/popup-promotions">
      Learn how to set up popup promotions on your store page.
    </Card>
  </Step>

<Step title="Enable the automation" titleSize="h3">
    Click **Enable automation** on the **New lead** card to activate this automated message.
  </Step>

<Step title="Set up your automated message" titleSize="h3">
    * **Toggle button**: Turn this on or off anytime (top right)
    * **Message field**: Write the message that will be sent to new leads
    * **Variables**: Add these variables to personalize the message:
      * recipient\_name - Shows their actual name
      * whop\_name - Shows your whop's name
      * store\_page\_url - Direct link to your store page
      * discount\_percentage - The discount percentage from your popup promotion
    * **Add media**: Upload images or videos to your message
    * **Send email option**: Check this box if you want users to also receive an email notification (in addition to the DM on Whop)
    * **Send message as**: Select which team member the message should appear to come from
  </Step>

<Step title="Save your settings" titleSize="h3">
    Click **Save** to activate your New lead automation.
  </Step>
</Steps>

You can return to these settings anytime to change your messages or turn automations on and off.

# Content Rewards
Source: https://docs.whop.com/manage-your-business/growth-marketing/content-rewards

Learn how to use Content Rewards to grow your social presence

Content Rewards is a marketing tool that connects your brand with content creators - they make content about your brand and you pay them for the number of views they get.

## What are Content Rewards?

Content Rewards is a tool to incentivize your customers to talk about your brand. They create content, post it to their social media, and you pay them based on views - but only after you approve their post.

**There are two types of campaigns you can run with Content Rewards:**

* **Content clipping:** Creators turn your existing long-form content (podcasts, livestreams, webinars) into short clips for TikTok, YouTube Shorts, X and Instagram Reels. Perfect when you have:
  * Podcasts or livestreams with great moments
  * Webinars with key talking points
  * Educational videos with quotable segments
  * Any long-form content that could work as short clips
* **User-generated content (UGC):** Creators produce original content featuring your brand based on guidelines you provide. Great for:
  * Customer testimonials and success stories
  * Brand awareness campaigns
  * Showing your services in action

You tell them what you want, and creators make original content that hits your requirements.

## How do Content Rewards work?

Content Rewards is an automated system that manages creator relationships and payments:

1. **Set up your campaign:** Choose your campaign type (clipping or UGC) and provide details about your brand and campaign goals
2. **Configure payment settings**: Set how much you will pay per 1,000 views and your budget for the campaign
3. **Creators make and distribute content**: Creators post content to their social media accounts, following your guidelines and requirements
4. **Review submissions:** Check submissions to see whether creators have followed your requirements, approving the ones that do and rejecting the ones that don’t
5. **Performance tracking and payments**: After approving a submission, Whop automatically pays the content creator based on the number of views they got

## Set up your first campaign

### Step 1: Add the Content Rewards app to your whop

* Go to your whop and click **Add app** to go to the Whop App Store
* Select **Content Rewards** from the available apps
* Click **Add** to include it in your whop

<Card title="Create your whop" icon="sparkles" href="/create-account">
  If you don't have a whop yet, click on this card to learn how to set up your
  account.
</Card>

### Step 2: Create your first campaign

When you add the Content Rewards app, you'll see a form with all the settings you need to configure. Here's what each field means and how to set it up:

<Steps>
  <Step title="Campaign name">
    Your campaign name will be seen publicly by creators, so make it clear and appealing.

* Enter a descriptive name that represents your brand or specific campaign (e.g. Laptop Lunch Prep UGC Campaign)
    * You can also include your reward rate in your title (Fanatics UGC - \$3 per 1,000 views) to entice content creators
  </Step>

<Step title="Campaign type">
    Select the type of content you want creators to make:

* **Clipping**: Creators take your existing videos or podcasts and turn them into short-form content
    * **UGC (User-Generated Content)**: Creators make original content featuring your brand
  </Step>

<Step title="Brand category">
    Pick the category that best represents your brand. This helps creators understand your niche and create better targeted content.
  </Step>

<Step title="Campaign budget">
    Enter the total amount you're willing to spend on this campaign. Think of this like ad spend, but instead of paying a platform directly, you're investing in creators who will promote your brand. You can select your preferred currency from the dropdown menu.

<Tip>
      Note: You will not be charged until you set up your payments on Whop and deposit funds.
    </Tip>
  </Step>

<Step title="Reward rate">
    Set how much creators earn per 1,000 views on their videos.

<Tip>
      * UGC content typically pays higher rates than clipping
      * Higher rates attract better creators
    </Tip>
  </Step>

<Step title="Minimum payout">
    Set the minimum amount a creator can earn from their video before it gets submitted for your review. If you set this to \$0, every single video submission (even with just a few views) will need to be reviewed. To focus on quality content that's actually performing, set a minimum payout amount.

* **Example**: With a \$3 reward rate and \$6 minimum payout, only videos with at least 2,000 views will be submitted for review (\$3 × 2 = \$6 earned).
  </Step>

<Step title="Maximum payout">
    Cap how much a single creator can earn from one video to protect your campaign budget. Without a cap, one video with hundreds of millions of views could consume your entire budget, leaving nothing for other creators. The maximum payout ensures your budget gets distributed across multiple creators and videos.

* **Example**: With a \$3,000 max payout and \$3 reward rate, a creator stops earning once their video hits 1 million views, even if it continues growing.
  </Step>

<Step title="Flat fee bonus (optional)">
    When you set a flat fee bonus, every approved submission earns both the view-based reward AND the flat fee amount. This can help attract more creators, especially when you're launching a new campaign.

* **Example**: With a \$3 reward rate, \$10 flat fee, and 2,000 views, a creator earns \$16 total (\$6 from views + \$10 flat fee).
  </Step>

<Step title="Platform selection">
    Choose which social media platforms you'll accept submissions from.
  </Step>

<Step title="Available content">
    This is where you communicate what you want and give creators everything they need to make great content for your brand. Here's what to include:

* Brand guidelines and details about your brand
    * Your campaign goals and messaging
    * Examples of content that's worked for your brand (case studies, successful hooks, etc.)
    * For clipping campaigns: Access to your video footage and any assets they can use

<Tip>
      Pro tip: Upload a comprehensive Google Doc with all your guidelines and examples, then paste the shareable link here. You can always update the document later without changing your campaign settings.
    </Tip>
  </Step>

<Step title="Requirements">
    Clearly outline the rules creators must follow for their submissions to be approved and paid:

* Content quality standards
    * Brand mention requirements
    * Prohibited content guidelines
    * Video length or format specifications
    * Any specific messaging that must be included

This protects your brand and ensures you only pay for content that meets your standards.
  </Step>
</Steps>

### Step 3: Fund and launch your campaign

After creating your campaign, you'll see the Add budget popup automatically.

To add funds:

1. Pick how you want to pay (whop balance, card, Cash App, etc.)
2. Enter the amount
3. Click **Send**

The payment takes about a minute to process. Your Content Reward will automatically move from **Pending budget** to the **Active** tab once it is complete.

### **Top up your balance**

You can add more money anytime by:

1. Clicking the 3 dots (···) on your campaign
2. Selecting **Add budget**
3. Entering the amount and clicking **Send**

# Popup promotions
Source: https://docs.whop.com/manage-your-business/growth-marketing/popup-promotions

Learn how to set up popup promotions on your store page

Popup promotions show a discount offer to people who've been browsing your store page for 45+ seconds or are about to click away. Even if they don't purchase immediately, you capture their contact info so you can follow up later.

## Enable popup promotions

<Steps>
  <Step title="Access your store settings" titleSize="h3">
    Go to your **Dashboard** and click **Edit store page** under the Admin area of your whop, then click the **Edit details** button on the store page.
  </Step>

<Step title="Turn on popup promotions" titleSize="h3">
    In the Edit details popup, scroll down to find the **Enable popup promotion** setting and toggle it on.
  </Step>
</Steps>

## Set up your popup promotion

When you enable popup promotions, you'll need to configure the settings:

* **Set your discount percentage**: Use the **Discount percentage** field to decide how much of a deal you want to offer. This is what visitors will see when they've been browsing for 45+ seconds or are trying to leave your store page (showing exit intent).

## View and contact your leads

When popup promotions are running, you can view your leads and follow up with them directly.

<Tip>
  Your list of leads includes everyone who has clicked the 'Claim' button on your popup promotion
</Tip>

<Steps>
  <Step title="Check your leads" titleSize="h3">
    Go to **Dashboard** > **Leads** to see everyone who has interacted with your popup promotions.
  </Step>

<Step title="Review lead details" titleSize="h3">
    For each lead, you'll find:

* Username
    * Which whop they visited
    * Email address
    * Visit date
  </Step>

<Step title="Reach out to your leads" titleSize="h3">
    Click the **Send message** button next to any lead to contact them directly and encourage them to complete their purchase.
  </Step>

<Step title="Export your data (optional)" titleSize="h3">
    Click **Export** in the top right to download your list of leads.
  </Step>
</Steps>

# Promo codes
Source: https://docs.whop.com/manage-your-business/growth-marketing/promo-codes

Learn how to create and manage promo codes

Use promo codes to offer percentage discounts (like 10% off) or fixed amounts (like \$10 off) that people can apply at checkout to join your whop.

## How to create a promo code

<Steps>
  <Step title="Access your dashboard" titleSize="h3">
    Head over to your **Dashboard.**

<Tip>
      Make sure you're viewing the whop you want to create a discount for (using the whop selection modal at the top left).
    </Tip>
  </Step>

<Step title="Navigate to Promo codes" titleSize="h3">
    Click the **Marketing** dropdown and select **Promo codes**. You'll see any existing promo codes you've already created for your whop here.
  </Step>

<Step title="Create a new code" titleSize="h3">
    If this is your first promo code, click **+ Create Promo Code** in the center of your page. If you've already created a promo code (and you want to create a new one) click **+ Create promo code** at the top right of your screen. A popup will appear where you'll set up your code.
  </Step>

<Step title="Set up your promo code" titleSize="h3">
    Configure the settings for your promo code:

1. **Code**: This is the actual promo code name, like "SAVE20" or "WELCOME10." Type what you want your code to be called.
    2. **Discount**: Decide how much your discount will be
       * Use the dropdown to pick either a **Percentage** (like 10% off) or a **Fixed amount** (like \$10 off).
       * Then, enter the discount value in the field above the dropdown.
    3. **Discount duration:** Decide how long the discount applies
       * **One-time (default)**: The discount is applied only once.
       * **Forever**: The discount applies to all future payments.
       * **Multiple months**: The discount applies for a specific number of months (a field will pop up for you to enter the number).
    4. **Eligible users**: Who can use this code?
       * **Everyone (default)**: Anyone can use it.
       * **Only new**: Only new customers can use this code.
       * **Only churned**: Only previous customers who have left can use it.
    5. **Expires**: Set when the promo code expires using the date and time selector. This is enabled by default and set to one month from creation.
    6. **Usage limit section**: Enter the maximum number of times this code can be used. Default is set to 100 uses.
    7. **One per customer**: If you enable this, each customer can only use the promo code once. This is enabled by default.
    8. **Apply to specific whops**: This is off by default. If you turn it on, you can limit the promo code to certain checkout links within your organization.
  </Step>

<Step title="Activate your code" titleSize="h3">
    Click **Create** at the bottom of the popup to make your promo code live.
  </Step>
</Steps>

## Manually expire a promo code

If you need to deactivate a promo code before its set expiration date, you can manually expire it.

1. **Access the promo code options**: Click the three dots (︙) next to the promo code you want to expire.
2. **Click Expire**: Select **Expire** from the dropdown menu that appears.
3. **Confirm expiration**: A confirmation message will pop up. Click **Expire** to permanently deactivate the promo code.

<Warning>
  When a promo code is expired, you can't reactivate it. If you want to offer that same discount again, you'll need to create a brand new promo code.
</Warning>

# Tracking links
Source: https://docs.whop.com/manage-your-business/growth-marketing/tracking-links

Set up tracking links to see where your users are coming from

Create custom tracking links to see exactly where traffic is coming from and which marketing efforts are working.

<Tip>
  Use different links for your emails, Twitter posts, Instagram bio, YouTube descriptions - then compare which channels convert best.
</Tip>

### How to set up tracking links

1. Go to **Dashboard** > **Marketing** > **Tracking links**
2. Click **+ Create tracking link**
3. Fill out these details:
   * **Name**: A name only you can see
   * **Whop**: Choose which whop it links to
   * **Destination**: This is where the user will be sent after they click the link
     * Select **Checkout** if you want the link to send them straight to a checkout page
     * Select **Store** if you want the link to send them to your store page
   * **Plan**: Pick the pricing plan you want to link to
4. Create a custom URL for each link
5. Click **Create**
6. Copy your link by clicking the 3 dots (︙) > **Copy link**

### What you can measure with tracking links

When your tracking links are live, you'll see exactly how each link performs with detailed analytics.

Here's what you can track:

* **Clicks**: Total number of people who clicked your link
* **Revenue generated**: Actual dollars earned from each link
* **Conversion rate**: Percentage of clicks that turn into paying customers
* **Converted users**: Number of people who actually bought after clicking

<Card title="Set up external tracking integrations" icon="magnifying-glass" href="/manage-your-whop/integrations">
  Whop integrates with major analytics platforms to help you get the full picture of your marketing and monitor your traffic
</Card>

# Analytics
Source: https://docs.whop.com/manage-your-business/manage-business/analytics

Understand Whop's built-in analytics

Whop’s built-in analytics help you understand how your business is growing, your financial performance, and who your customers are.

## How to view your analytics

To view your analytics:

1. Go to your **Dashboard**
2. Click **Home**

### How to add analytics widgets to your Dashboard

Widgets are metric cards that show your most important business stats at a glance. Choose which metrics you want to track and customize your dashboard layout.

Here's how:

1. Go to **Dashboard** > **Home**
2. Click **+ Add** on the right side under **Stats**
3. Click **+** on the widgets you want
4. Click **Apply** when you're done
5. Drag them around to organize them how you want
6. Click **Done** (next to **+ Add**) to save your new widget layout

<Tip>
  The dashboard widgets are organized into three main categories: Users,
  Payments, and Resolution Center. Each category provides specific stats to help
  you understand different aspects of your business performance.
</Tip>

## Understanding your analytics data

### 1. User analytics

The Users category helps you understand who your customers are and how they interact with your business.

**Customer engagement metrics**

* **Top users**: The members that have spent the most amount (excluding refunds and disputes)
* **New users**: Total number of new users in the time period specified. This does not include existing users who renew their memberships or add additional subscriptions
* **Time spent** : The amount of time spent by users in your whop
* **Page visits**: Estimated number of visits to your store pages in the specified period of time
* **Users breakdown**: Total number of users per status (e.g. Joined, Renewing, Trialing, Paused)

**User status breakdown**

* **Paid active users**: Total number of paid active users in your whop in the specified time period
* **Users with app installed**: The number of users with an active membership who have the mobile app installed

**Conversion & Revenue metrics**

* **Spend per paying user**: Estimated revenue for all payments made by customers, divided by the total number of customers who have made a payment
* **Trial conversion rate**: The percentage of users that converted from a trial to an active subscription in the specified period of time
* **Top affiliates**: The affiliates who have generated the most revenue for your whop

### 2. Payments analytics

The Payments category tracks your financial performance with detailed payment and revenue metrics.

**Core revenue metrics:**

* **Gross revenue**: Revenue from payments are had been made to your Whop account
* **MRR (Monthly Recurring Revenue)**: Estimated monthly revenue from all active and past-due subscriptions
* **ARR (Annual Recurring Revenue)**: Estimated annual revenue from all active and past-due subscriptions
* **Revenue (after Whop fees)**: Estimated revenue after Whop fees in the specified time period

**Payment transaction data:**

* **Payments breakdown**: All payment volume in the specified time period per status (Paid, Failed, Past due, Canceled, Refunded, Pending)
* **Successful payments**: Total number of successful payments in the specified time period
* **Payment processing fees**: Total transaction fees charged by payment processors
* **Spend per subscription**: Estimated revenue for subscription payments, divided by the total number of subscribers

**Business health indicators:**

* **Churn rate**: Churned users in the past 30 days divided by active users 30 days ago plus new users in that period
* **Churned revenue**: The total MRR lost in the specific time period due to churn

**Tax and Fee management:**

* **Sales Tax Withheld**: Estimated sales tax withheld in the specified time period
* **Affiliate Fees**: Estimated total fees paid to affiliate referrals in the specified time period

**Disputes:**

* **Disputes Count**: Total number of disputes received in the specified time period
* **Dispute Alerts Count**: Total number of alerts received in the specified time period

<Tip>
  Payment stats help you spot trends, catch problems early, and make smart
  pricing decisions.
</Tip>

### 3. Resolution Center analytics

The Resolution Center category shows you:

* **Total Refunded**: Total amount refunded to customers in the specified time period

# Integrations
Source: https://docs.whop.com/manage-your-business/manage-business/integrations

Set up external tracking integrations

Whop integrates with major analytics platforms to help you get the full picture of your marketing and monitor your whop's traffic.

### Supported platforms

* Google Analytics
* Hyros
* Meta
* TikTok
* X (formerly Twitter)
* Reddit
* Pinterest
* HubSpot

### What these integrations track

When someone visits your whop, data gets sent to these platforms so you can:

* See traffic from all your marketing
* Know where visitors come from
* Track how well your ads work
* Connect page views to specific campaigns

### How to add platform IDs

To connect any analytics platform:

1. Go to your **Dashboard > Settings**
2. Under **Analytics**, click the platform you want to integrate with your whop
3. Enter your tracking ID(s) and API keys
4. Click the blue checkmark to activate the integration

<Tip>
  There are tutorials under each platform to help you find Pixel ID(s) and API keys.
</Tip>

# Upload legal documents
Source: https://docs.whop.com/manage-your-business/manage-business/legal-documents

Learn how to upload legal documents and policies to your whop

Adding legal documents to your Whop helps cut down on fake disputes and chargebacks, and your customers will know exactly what to expect when they buy from you.

When someone buys access to your Whop, they automatically agree to Whop's terms. But you can add your own legal documents for more protection.

## Which legal documents you can upload

You can upload 4 different legal documents to your Whop:

* **Terms of Service**: Your business terms and conditions
* **Privacy Policy**: How you handle customer data
* **Return Policy**: Your refund and return procedures
* **EULA (End User License Agreement)**: Software or digital product usage terms

<Tip>
  Set up your legal documents before you sell anything. This way, you're protected from day one, and your customers know what they're signing up for.
</Tip>

## How to upload your legal documents

To add your legal documents:

1. Go to **Dashboard** > **Settings** > **Legal** (3rd option under Settings)
2. Click **Upload file** to the right of the document type you want to add
3. Either drag and drop your file or click **Browse files** to find it on your computer
4. Once you pick your file, click **Upload file** at the bottom left
5. Repeat steps 2 to 4 for any other documents you want to upload

<Tip>
  You can check your uploaded files by clicking View file next to each document or remove one by clicking Delete.
</Tip>

## How to require customers to agree to your terms before checkout

To have customers agree to your terms before purchasing:

1. Go to **Dashboard** > **Settings** > **Legal** (3rd option under Settings)
2. Under **Options**, toggle **Require terms and conditions acceptance**

<Tip>
  When you turn this on, customers have to check a box saying they agree to your terms before they can buy anything.
</Tip>

# Create a waitlist
Source: https://docs.whop.com/manage-your-business/products/create-waitlist

Have people join a waitlist before they can access your whop

A waitlist allows you to control who joins your whop. People apply to join, you review them, then approve the ones you want.

<Tip>
  You can view and manage all your waitlist entries by going to your Dashboard > Waitlists.
</Tip>

## How to create a waitlist checkout option

**To set up a waitlist for your whop:**

1. Go to your **Dashboard** > **Checkout links**
2. Click **+ Create checkout link**
3. Toggle **Advanced options** and click **Add a waitlist**
4. Click **Create**

Anyone who joins through your checkout link will now be added to the waitlist instead of getting immediate access.

## How to add questions to your waitlist

Pro tip: Add required questions for customers to answer before joining your waitlist. This will help qualify potential members and assess if they’re a good fit for your whop.

To add questions to your waitlist:

* Go to **Dashboard** > **Checkout links**
* Find your waitlist link and click the 3 dots (⋮)
* Click **Edit**
* Under **Advanced options**, click **Ask questions before checkout**
* Add your question titles and placeholder text
* Click **Update checkout link**

## How to approve/deny waitlist entries

Go to **Dashboard > Waitlists** to manage your waitlist. From here, you can:

* **Approve** (thumbs up button) or **deny** (thumbs down button) individual users
* **Admit all entries** at once by clicking the **+ Admit all entries** button
* **Export entries** by clicking the **Export** button in the top right
* **Contact users** on your waitlist via DM or email

When you approve someone, they'll automatically get access to your whop and receive a notification.

## When to use a waitlist

Waitlists work great when you want to:

* **Build anticipation while you're still creating**: Collect emails, build an audience, and validate demand without opening access right away.
* **Qualify potential customers**: Add custom questions to qualify leads before giving them access.
* **Create exclusivity for your community**: When people have to apply and wait for approval, it makes your whop feel more valuable and desirable.
* **Launch a limited beta** — Control who gets early access by reviewing applicants before letting them in. Perfect for testing with a smaller, high-quality group.

# Free trials
Source: https://docs.whop.com/manage-your-business/products/free-trials

Learn how to set up a free trial for your whop

Free trials give people access to your whop for a limited time. Once the trial ends, they are automatically charged the standard price for access.

## How to set up a free trial for your whop

There are two ways to set up a free trial:

<Note>
  You can only add a free trial to 'Recurring' checkout links.
</Note>

### 1. Through your Dashboard

To set up a free trial from your Dashboard:

1. Go to **Dashboard** > **Checkout links**
2. Pick an existing link and click the 3 dots (⋮) > **Edit**, or make a new one by clicking **+ Create checkout link**
3. Check **Free trial**
4. Pick how many free days you want to offer (like 1 day, 7 days, or 30 days)
5. Click **Update checkout link** to activate your free trial

### 2. Through your whop's Pricing page

To set up a free trial from your whop's **Pricing** page:

1. Go to **whop** > **Manage pricing**
2. Pick an existing pricing option and click the 3 dots (…) > **Edit**, or make a new one by clicking **+ Create pricing option**
3. Check **Free trial**
4. Pick how many free days you want to offer
5. Click **Update checkout link** to activate your free trial

<Warning>
  After the trial ends, people automatically get charged the full price unless they cancel first. This helps you make more money without doing any extra work.
</Warning>

## Understanding trial abuse and prevention

* **What is trial abuse?** This happens when someone keeps signing up for free trials but cancels before they have to pay. They might use different emails or make new accounts to avoid paying.
* **How Whop stops this:** Whop automatically catches when the same person tries to sign up for multiple free trials. If someone cancels and then tries to rejoin with another trial, the system will charge them full price instead of giving them another free period.

<Tip>
  Don't worry too much about trial abuse: 99% of people use trials honestly, and Whop handles the bad actors automatically.
</Tip>

# Locked content and upsells
Source: https://docs.whop.com/manage-your-business/products/locked-premium-content

Learn how to set up locked content in your whop and use it to upsell members

Locked content on Whop allows you to restrict access to specific apps. People can only access Locked apps by paying a fee or getting permission from you. You can use this feature to set up:

* **Premium features**: Lock specific apps behind a paywall
  * Example: Give everyone your daily picks, but charge extra for a bankroll management guide
* **Exclusive content**: Permit access to some apps for certain members only
  * Example: Create an exclusive chat reserved only for the members who hit a specific milestone
* **Upselling**: Upsell additional products during or after checkout
  * Example: After someone buys your trading course, ask if they also want to buy your trading indicators

## Create locked content

To set up locked content in your whop, you need to choose the specific app you would like to lock:

1. Click the 3 dots (⋮) next to the app you want to lock and click **App settings**
2. Under **Visibility**, choose **Locked**
3. Pick either **Free** or **Paid (one-time)** access

## Set pricing and access options

### Free locked content

* Choose **Free** and **Add a waitlist** to control who gets access to your locked app

<Card title="Create a waitlist" icon="list" href="/manage-your-whop/create-waitlist">
  Learn more about managing your waitlists (and how to add questions to your waitlists)
</Card>

### Paid locked content

* Choose **Paid (one-time)** to charge people to access your locked app
* Set the price
* Choose the currency
* The upsell method ([see more details below](#choose-your-upsell-method))

### Additional settings

* **Expiration:** Set when access runs out
* **iOS screenshot protection:** Stop people from taking screenshots to prevent leaks
* **Add to other whops:** Use the same locked app in multiple whops you own

## Choose your upsell method

When creating paid locked content, you need to decide when and where members will see your offer. You have three upsell methods to choose from:

### 1. Before checkout

Shows up as an add-on on the checkout page of your whop (i.e. an order bump). Your prospective customer will have the option to add it to their cart and pay extra to access the locked content.

In the image below, you can see what a pre-checkout order bump looks like for your customers. In this example, customers have the option to add the additional 'Chat' for \$100.

### 2. After checkout

A popup appears right after someone joins your whop (i.e. an upsell). This is great for showing premium content to people who have just joined your whop (when they already have their wallet out and are in the buying mood).

You have two options to set up your custom upsell page:

<Tabs>
  <Tab title="Option 1">
    * Find the Locked app and click the **3 dots (⋮)** next to the app
    * Click **App settings**
    * Click the edit link under **After checkout**
  </Tab>

<Tab title="Option 2">
    1. Click **Edit store page** > **Edit details**
    2. Scroll and click **Upsells**
  </Tab>
</Tabs>

From there, you can add:

* **Upsell title**: Write something that grabs attention
* **Upsell description**: Explain why it's worth it (180 characters max)
* **Upload video**: Add a video explaining your offer (16:9 works best)
* Click **Save** when you're done.

<Tip>
  Pro tip: Adding a short video / VSL improves conversions.
</Tip>

Below, you can see what the post-checkout upsell popup looks like for your customers.

### 3. Only display in this whop

Locked content will show as Locked inside your whop. Members can find and buy it while organically browsing inside your whop.

# Manage products
Source: https://docs.whop.com/manage-your-business/products/manage-products

Learn how to manage and update products in your whop

Update your product pricing, change which apps your customers get access to, and create new products or billing options.

## Update an existing product

<Steps>
  <Step title="Select the product you want to change" titleSize="h3">
    1. Go to your Dashboard
    2. Click **Products**
    3. Click on the product you want to update
  </Step>

<Step title="Update the title and description" titleSize="h3">
    1. Update the **title** and **description** directly in the main fields
    2. Click **Save Changes** when done
  </Step>

<Step title="Change pricing" titleSize="h3">
    1. Click on the current **price** – a dropdown menu will appear
    2. Enter the new amount your product should cost
    3. Click **Save Changes**

<Tip>
      You can only update the price amount here, not the pricing model (i.e. free, one-time payment, or recurring). To offer a different pricing model, you need to add a new billing period (see 'Add a new pricing model' below).
    </Tip>
  </Step>

<Step title="Add a new pricing model" titleSize="h3">
    You can have multiple pricing models for the same product (e.g. a monthly subscription AND a yearly subscription AND a one-time fee for lifetime access).

To add a new pricing model:

1. Click **Add another visible billing period**
    2. Select the pricing type (free, one-time, or recurring)
    3. Choose currency and set the price
    4. Configure billing cycle (for recurring plans)
    5. Click **Save Changes**
  </Step>

<Step title="Update advanced settings" titleSize="h3">
    Click **Advanced options** to modify:

* **Stock**: Limit how many people can purchase this product
    * **Show on store page**: Make this product visible on your public store page
    * **Add a waitlist**: Users enter payment details but aren’t charged until you approve them
    * **Ask questions before checkout**: Collect information from customers before they purchase
    * **Auto-expire access**: Automatically remove access after a set time period
    * **Redirect after checkout**: Send customers to a specific page after they complete checkout
    * **Add internal name**: A name only you can see on your dashboard
  </Step>

<Step title="Update payment methods" titleSize="h3">
    1. Click **Payment methods**
    2. Select or deselect the options you want to offer:
       * Credit/debit card
       * Bank transfer (ACH)
       * PayPal
       * Cryptocurrency
       * Buy now, pay later (Financing)
    3. Click **Save Changes**
  </Step>
</Steps>

## Select which apps are included in a product

Control what customers get access to when they purchase each product by selecting (and deselecting) which apps to include.

**To update app access:**

1. Go to **Dashboard** > **Products**
2. Click on the product you want to change
3. In the right-hand column, you'll see all your available apps
4. **Toggle on** apps you want included in this product
5. **Toggle off** apps you want to exclude
6. Changes save automatically

<Info>
  **Example scenario:**

* **Free product**: Includes only a free chat app and a beginners course (excluding all premium apps)
  * **Premium product**: Also includes premium apps (e.g. advanced learning materials and templates)
  * **VIP product**: Includes an extra app that gives VIP members the ability to book 1-on-1 calls with you
</Info>

## Create a new product

You can create multiple membership tiers (e.g. free and premium) by creating multiple products.

To create a new product:

1. Go to your whop
2. Click **Products**
3. Click **Create product**

<Card title="Set up your product pricing and details" icon="dollar-sign" href="/set-up-products-pricing">
  Learn more about how to configure the settings of your product here.
</Card>

## Preview what members see in each product

Members will only see apps they have access to based on the products they have joined and purchased.

**To see what your product looks like for your members:**

1. Go to your whop's main page
2. Click the **Preview as** dropdown menu
3. Select the product you want to preview

## Organize your apps and categories in each product

You can create categories to group your apps and drag and drop both categories and apps to keep your whop looking clean and organized.

**To create categories:**

1. Right-click in the left-hand app column (where you can see the list of all your apps)
2. Select **Create category**
3. Name your category
4. Click **Create**

**To rename categories:**

1. Right-click on the category
2. Select **Edit category**
3. Update the name
4. Click **Save**

**To rename apps:**

1. Right-click on the app you want to update
2. Click **App settings**
3. Update the name
4. Click **Save**

<Tip>
  There are 2 ways to organize your apps when managing multiple products:

1. Organize by product tier: Create categories like "Free Members" and "Premium Members" and group relevant apps under each category
  2. Organize by content theme: Create categories like "Community", "Learning", "Events" and rename apps to show access level (e.g., "Free Chat", "Premium Chat")
</Tip>

# Roles and permissions
Source: https://docs.whop.com/manage-your-business/team-management/manage-team-roles

Learn how to manage your team, roles and permissions

Your Team tab is where you decide who gets access to your whop and what permissions they have.

## How to add team members to your whop

1. Go to **Dashboard** > **Team**
2. **(Recommended):** Toggle on **Require 2FA** to make sure all team members use secure login
3. Click **Invite team member** in the top right corner
4. Enter the person's email address in the **Email** field
5. Select their role from the **Role** dropdown menu
6. Click **Invite**

Your team member will automatically be sent an invitation email. When they accept, they'll show up in your team table with their new permissions.

You can see all your pending invites on the **Invites** tab next to **Members**.

<Warning>
  Start small. Always give someone the lowest role that lets them do their job. You can always give them more access later if needed.
</Warning>

## Roles and permissions overview

There are four different roles you can assign to your team members:

* **Moderator**
* **Sales Manager**
* **Admin**
* **Owner**

Each of these roles has a different level of permissions - Moderator has the least access, and Owner has the most.

### **Moderator**

* Delete messages and mute or ban members in the Chat app
* Delete comments in Forums
* Keep your community chat friendly and spam-free

<Tip>
  The Moderator role is best for community managers, support agents, or anyone helping manage your community.
</Tip>

### **Sales Manager**

All Moderator permissions, plus:

* View the Users table (but can't export it)
* View and create checkout links

<Tip>
  The Sales Manager role is best for marketing team members, affiliate managers, or sales reps who need to create and track custom checkout links.
</Tip>

### **Admin**

All Moderator and Sales Manager permissions, plus:

* View waitlists and cancellation reasons
* Access Finances section (except Payouts)
* View and manage products, apps, and the store page
* Give refunds to customers
* View and manage the Marketing section of the dashboard
* Invite other team members (Moderators and Sales Managers only)
* View general settings (but can't edit them)

<Tip>
  The Admin role is best for operations managers, team leads, heads of marketing/community, or anyone needing broader dashboard access.
</Tip>

### **Owner**

All permissions from other roles, plus:

* Access to Payouts
* View and manage API keys, OAuth, and Webhooks settings
* Invite Admins and Owners
* View **analytics**
* Transfer ownership

<Tip>
  The Owner role is best for founders, co-founders, CTOs, or finance/legal leads who need complete control.
</Tip>

### **Complete permissions breakdown**

| Permission                                   | Moderator | Sales Manager | Admin | Owner |
| :------------------------------------------- | :-------- | :------------ | :---- | :---- |
| Delete messages in the Chat app              | ✔️        | ✔️            | ✔️    | ✔️    |
| Mute users in Chat app                       | ✔️        | ✔️            | ✔️    | ✔️    |
| Ban users in Chat app                        | ✔️        | ✔️            | ✔️    | ✔️    |
| Delete comments in Forums app                | ✔️        | ✔️            | ✔️    | ✔️    |
| View Checkout links section on dashboard     | ✔️        | ✔️            | ✔️    | ✔️    |
| Create new checkout links                    | ❌         | ✔️            | ✔️    | ✔️    |
| View Users table on dashboard                | ✔️        | ✔️            | ✔️    | ✔️    |
| Edit store page                              | ❌         | ❌             | ✔️    | ✔️    |
| Add & configure apps                         | ❌         | ❌             | ✔️    | ✔️    |
| Create products                              | ❌         | ❌             | ✔️    | ✔️    |
| Give refunds to customers                    | ❌         | ❌             | ✔️    | ✔️    |
| Export Users table on dashboard              | ❌         | ❌             | ✔️    | ✔️    |
| View waitlists                               | ❌         | ❌             | ✔️    | ✔️    |
| View cancellation reasons                    | ❌         | ❌             | ✔️    | ✔️    |
| View Finances section                        | ❌         | ❌             | ✔️    | ✔️    |
| Access Payouts section                       | ❌         | ❌             | ❌     | ✔️    |
| View Marketing section                       | ❌         | ❌             | ✔️    | ✔️    |
| Manage Marketing section                     | ❌         | ❌             | ✔️    | ✔️    |
| View general settings                        | ❌         | ❌             | ✔️    | ✔️    |
| Edit general settings                        | ❌         | ❌             | ❌     | ✔️    |
| View team settings                           | ❌         | ❌             | ✔️    | ✔️    |
| Invite Moderators                            | ❌         | ❌             | ✔️    | ✔️    |
| Invite Sales Managers                        | ❌         | ❌             | ✔️    | ✔️    |
| Invite Admins                                | ❌         | ❌             | ❌     | ✔️    |
| Invite Owners                                | ❌         | ❌             | ❌     | ✔️    |
| View analytics on Home page of the dashboard | ❌         | ❌             | ❌     | ✔️    |
| View API keys settings                       | ❌         | ❌             | ❌     | ✔️    |
| Manage API keys settings                     | ❌         | ❌             | ❌     | ✔️    |
| View OAuth settings                          | ❌         | ❌             | ❌     | ✔️    |
| Manage OAuth settings                        | ❌         | ❌             | ❌     | ✔️    |
| View Webhooks settings                       | ❌         | ❌             | ❌     | ✔️    |
| Manage Webhooks settings                     | ❌         | ❌             | ❌     | ✔️    |
| Transfer ownership                           | ❌         | ❌             | ❌     | ✔️    |

<Warning>
  Important: Some things your team can do (like deleting messages or checkout links) can't be undone.
</Warning>

## How to change team member roles

You can update anyone's role at any time to give them more or less access.

To change someone's role:

1. Go to **Dashboard > Team**
2. Find the team member in the members table
3. Click the dropdown menu in their **Role** column
4. Select their new role
5. Click **Save**

The change happens right away, and they'll have their new permissions immediately.

## How to remove team members

To remove a team member:

1. Go to **Dashboard > Team**
2. Find the team member you want to remove
3. Click the three dots (︙) on the right side of their row
4. Select **Remove user**
5. Click the red **Remove user** button in the confirmation pop-up

They'll immediately lose access to your whop and will need to be reinvited if you want to add them back to the team.

# Pay your team
Source: https://docs.whop.com/manage-your-business/team-management/pay-your-team

Learn how to pay your team members through Whop

Pay your team directly from your Whop balance. Payments are instant and your team can cash out to their bank.

<Warning>
  There's a 1% fee for all team payments
</Warning>

### Pay your team through your Dashboard

1. Go to **Dashboard** > **Team**
2. Click the **Pay** button next to the person you want to pay
3. Enter the amount you want to send
4. Select the **Balance** you'll send the payment from
5. Add a note (optional)
6. Click **Send** to send it

<Info>
  Note: The total amount you send includes the 1% fee.
</Info>

When you send it, your team member gets an email and a DM notification. They can then go to **Profile** > **Balance** to cash out.

### Pay your team through their profile

You can also send money to any Whop user through their profile - even if they're not officially on your team.

1. Click the user's profile picture
   * If you know their username, go straight to their profile by entering **whop.com/@\[username]** in your browser’s address bar (e.g., **whop.com/@George**).

2. On their profile, click the **Pay** button next to **Message**.
3. Fill out the payment details:
   * **Enter amount:** Type how much you want to send
   * Select the **Balance** you'll send the payment from
   * **Write a note:** Add a note (optional)
4. Click **Send** to send the money

They'll receive an email and message notification, and can cash out through **Profile** > **Balance**.

# Embed checkout
Source: https://docs.whop.com/payments/checkout-embed

Learn how to embed Whop's checkout flow on your website

Embedded checkout allows you to embed Whop's checkout flow on your own website. This allows you to offer your customers a seamless checkout experience without leaving your website.

## React setup

### Step 1: Install the package

```bash
npm install @whop/checkout
```

### Step 2: Add the checkout element

```tsx
import { WhopCheckoutEmbed } from "@whop/checkout/react";

export default function Home() {
  return <WhopCheckoutEmbed planId="plan_XXXXXXXXX" />;
}
```

This component will now mount an iframe with the Whop checkout embed. Once the checkout is complete, the user will be redirected to the redirect url you specified in the settings on Whop.

You can configure the redirect url in your [whop's settings](https://whop.com/dashboard/whops/) or in your [company's settings](https://whop.com/dashboard/settings/checkout/) on the dashboard. If both are specified, the redirect url specified in the whop's settings will take precedence.

<Tip>
  Keep that Plan ID handy. You'll need to paste it into your website code, so
  save it somewhere you can find it.
</Tip>

### Step 3: **(optional)** Configure - Programmatic controls

To get access to the controls of the checkout embed, you can use the `ref` prop.

```tsx
const ref = useCheckoutEmbedControls();

return <WhopCheckoutEmbed ref={ref} planId="plan_XXXXXXXXX" />;
```

#### **`submit`**

To submit checkout programmatically, you can use the `submit` method on the checkout element.

```tsx
ref.current?.submit();
```

#### **`getEmail`**

To get the email of the user who is checking out, you can use the `getEmail` method on the checkout element.

```tsx
const email = await ref.current?.getEmail();
console.log(email);
```

#### **`setEmail`**

To set the email of the user who is checking out, you can use the `setEmail` method on the checkout element.

```tsx
try {
  await ref.current?.setEmail("example@domain.com");
} catch (error) {
  console.error(error);
}
```

#### **`getAddress`**

To get the address of the user who is checking out, you can use the `getAddress` method on the checkout element.

```tsx
const address = await ref.current?.getAddress();
console.log(address);
```

#### **`setAddress`**

To set the address of the user who is checking out, you can use the `setAddress` method on the checkout element.

<Note>
  This method will only work if the address form is hidden. You can hide the
  address form by setting the `hideAddressForm` prop to `true`.
</Note>

```tsx
try {
  await ref.current?.setAddress({
    name: "John Doe",
    country: "US",
    line1: "123 Main St",
    city: "Any Town",
    state: "CA",
    postalCode: "12345",
  });
} catch (error) {
  console.error(error);
}
```

### Step 4: **(optional)** Configure - Available properties

#### **`planId`**

**Required** - The plan id you want to checkout.

#### **`theme`**

**Optional** - The theme you want to use for the checkout.

Possible values are `light`, `dark` or `system`.

#### **`sessionId`**

**Optional** - The session id to use for the checkout.

This can be used to attach metadata to a checkout by first creating a session through the API and then passing the session id to the checkout element.

#### **`affiliateCode`**

**Optional** - The affiliate code to use for the checkout.

```tsx
<WhopCheckoutEmbed affiliateCode="tristan" planId="plan_XXXXXXXXX" />
```

#### **`hidePrice`**

**Optional** - Turn on to hide the price in the embedded checkout form.

Defaults to `false`

#### **`hideTermsAndConditions`**

**Optional** - Set to `true` to hide the terms and conditions in the embedded checkout form.

Defaults to `false`

#### **`skipRedirect`**

**Optional** - Set to `true` to skip the final redirect and keep the top frame loaded.

Defaults to `false`

#### **`onComplete`**

**Optional** - A callback function that will be called when the checkout is complete.

<Note>This option will set `skipRedirect` to `true`</Note>

```tsx
<WhopCheckoutEmbed
  onComplete={(planId, receiptId) => {
    console.log(planId, receiptId);
  }}
  planId="plan_XXXXXXXXX"
/>
```

#### **`utm`**

**Optional** - The UTM parameters to add to the checkout URL.

**Note** - The keys must start with `utm_`

```tsx
<WhopCheckoutEmbed
  planId="plan_XXXXXXXXX"
  utm={{ utm_campaign: "ad_XXXXXXX" }}
/>
```

#### **`fallback`**

**Optional** - The fallback content to show while the checkout is loading.

```tsx
<WhopCheckoutEmbed fallback={<>loading...</>} planId="plan_XXXXXXXXX" />
```

#### **`prefill`**

**Optional** - The prefill options to apply to the checkout embed.

Used to prefill the email or address in the embedded checkout form.
This setting can be helpful when integrating the embed into a funnel that collects the email prior to payment already.

```tsx
<WhopCheckoutEmbed
  prefill={{ email: "example@domain.com" }}
  planId="plan_XXXXXXXXX"
/>
<WhopCheckoutEmbed
  prefill={{ address: {
    name: "John Doe",
    country: "US",
    line1: "123 Main St",
    city: "Any Town",
    state: "CA",
    postalCode: "12345",
  } }}
  planId="plan_XXXXXXXXX"
/>
```

#### **`hideEmail`**

**Optional** - Set to `true` to hide the email input in the embedded checkout form. Make sure to display the users email in the parent page when setting this attribute.

Defaults to `false`

<Note>
  Use this in conjunction with the `prefill` attribute or the `setEmail` method
  to control the email input.
</Note>

```tsx
<WhopCheckoutEmbed hideEmail planId="plan_XXXXXXXXX" />
```

#### **`disableEmail`**

**Optional** - Set to `true` to disable the email input in the embedded checkout form.

Defaults to `false`

<Note>
  Use this in conjunction with the `prefill` attribute or the `setEmail` method
  to control the email input.
</Note>

```tsx
<WhopCheckoutEmbed disableEmail planId="plan_XXXXXXXXX" />
```

#### **`hideAddressForm`**

**Optional** - Set to `true` to hide the address form in the embedded checkout form.

Defaults to `false`

<Note>
  Use this in conjunction with the `setAddress` method to control the address
  input.
</Note>

```tsx
<WhopCheckoutEmbed hideAddressForm planId="plan_XXXXXXXXX" />
```

#### **`onAddressValidationError`**

**Optional** - A callback function that will be called when the address validation error occurs.

<Note>
  This method will only work if the address form is hidden. You can hide the
  address form by setting the `hideAddressForm` prop to `true`.
</Note>

```tsx
<WhopCheckoutEmbed
  hideAddressForm
  onAddressValidationError={(error) => {
    console.log(error);
  }}
  planId="plan_XXXXXXXXX"
/>
```

### Full example

```tsx
import { WhopCheckoutEmbed } from "@whop/checkout/react";

export default function Home() {
  return (
    <WhopCheckoutEmbed
      fallback={<>loading...</>}
      planId="plan_XXXXXXXXX"
      theme="light"
      hidePrice={false}
      sessionId="ch_XXXXXXXXX"
    />
  );
}
```

## Other websites

### Step 1: Add the script tag

To embed checkout, you need to add the following script tag into the `<head>` of your page:

```md
<script
  async
  defer
  src="https://js.whop.com/static/checkout/loader.js"
></script>
```

### Step 2: Add the checkout element

To create a checkout element, you need to include the following attribute on an element in your page:

```md
<div data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

This will now mount an iframe inside of the element with the plan id you provided. Once the checkout is complete, the user will be redirected to the redirect url you specified in the settings on Whop.

### Step 3: **(optional)** Configure - Programmatic controls

First, attach an `id` to the checkout container:

```md
<div id="whop-embedded-checkout" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`submit`**

To submit checkout programmatically, you can use the `submit` method on the checkout element.

```js
wco.submit("whop-embedded-checkout");
```

#### **`getEmail`**

To get the email of the user who is checking out, you can use the `getEmail` method on the checkout element.

```js
const email = await wco.getEmail("whop-embedded-checkout");
console.log(email);
```

#### **`setEmail`**

To set the email of the user who is checking out, you can use the `setEmail` method on the checkout element.

```js
wco.setEmail("whop-embedded-checkout", "example@domain.com");
```

#### **`getAddress`**

To get the address of the user who is checking out, you can use the `getAddress` method on the checkout element.

```js
const address = await wco.getAddress("whop-embedded-checkout");
console.log(address);
```

#### **`setAddress`**

To set the address of the user who is checking out, you can use the `setAddress` method on the checkout element.

<Note>
  This method will only work if the address form is hidden. You can hide the
  address form by setting the `data-whop-checkout-hide-address` prop to `true`.
</Note>

```js
try {
  await wco.setAddress("whop-embedded-checkout", {
    name: "John Doe",
    country: "US",
    line1: "123 Main St",
    city: "Any Town",
    state: "CA",
    postalCode: "12345",
  });
} catch (error) {
  console.error(error);
}
```

### Step 4: **(optional)** Configure - Available attributes

#### **`data-whop-checkout-plan-id`**

**Required** - The plan id you want to checkout.

> To get your plan id, you need to first create a plan in the **Manage Pricing** section on your whop page.

#### **`data-whop-checkout-theme`**

**Optional** - The theme you want to use for the checkout.

Possible values are `light`, `dark` or `system`.

```md
<div data-whop-checkout-theme="light" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-theme-accent-color`**

**Optional** - The accent color to apply to the checkout embed

Possible values are

* `tomato`
* `red`
* `ruby`
* `crimson`
* `pink`
* `plum`
* `purple`
* `violet`
* `iris`
* `cyan`
* `teal`
* `jade`
* `green`
* `grass`
* `brown`
* `blue`
* `orange`
* `indigo`
* `sky`
* `mint`
* `yellow`
* `amber`
* `lime`
* `lemon`
* `magenta`
* `gold`
* `bronze`
* `gray`

```md
<div data-whop-checkout-theme-accent-color="green" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-session`**

**Optional** - The session id to use for the checkout.

This can be used to attach metadata to a checkout by first creating a session through the API and then passing the session id to the checkout element.

```md
<div data-whop-checkout-session="ch_XXXXXXXXX" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-affiliate-code`**

**Optional** - The affiliate code to use for the checkout.

```md
<div data-whop-checkout-affiliate-code="tristan" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-hide-price`**

**Optional** - Set to `true` to hide the price in the embedded checkout form.

Defaults to `false`

```md
<div data-whop-checkout-hide-price="true" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-hide-submit-button`**

**Optional** - Set to `true` to hide the submit button in the embedded checkout form.

Defaults to `false`

<Note>
  When using this Option, you will need to [programmatically submit](#submit)
  the checkout form.
</Note>

```md
<div data-whop-checkout-hide-submit-button="true" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-hide-tos`**

**Optional** - Set to `true` to hide the terms and conditions in the embedded checkout form.

Defaults to `false`

```md
<div data-whop-checkout-hide-tos="true" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-skip-redirect`**

**Optional** - Set to `true` to skip the final redirect and keep the top frame loaded.

Defaults to `false`

```md
<div data-whop-checkout-skip-redirect="true" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-on-complete`**

**Optional** - The callback to call when the checkout succeeds

<Note>This option will set `data-whop-checkout-skip-redirect` to `true`</Note>

```html
<script>
  window.onCheckoutComplete = (planId, receiptId) => {
    console.log(planId, receiptId);
  };
</script>

<div
  data-whop-checkout-on-complete="onCheckoutComplete"
  data-whop-checkout-plan-id="plan_XXXXXXXXX"
></div>
```

#### **`data-whop-checkout-on-state-change`**

**Optional** - The callback to call when state of the checkout changes

This can be used when programmatically controlling the submit of the checkout embed.

```html
<script>
  window.onCheckoutStateChange = (state) => {
    console.log(state);
  };
</script>

<div
  data-whop-checkout-on-state-change="onCheckoutStateChange"
  data-whop-checkout-plan-id="plan_XXXXXXXXX"
></div>
```

#### **`data-whop-checkout-skip-utm`**

By default any utm params from the main page will be forwarded to the checkout embed.

**Optional** - Set to `true` to prevent the automatic forwarding of utm parameters

Defaults to `false`

#### **`data-whop-checkout-prefill-*`**

Used to prefill the email or address in the embedded checkout form. This setting can be helpful when integrating the embed into a funnel that collects the email prior to payment already.

```md
<div data-whop-checkout-prefill-email="example@domain.com" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>

<div data-whop-checkout-prefill-address-name="John Doe" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-hide-email`**

**Optional** - Set to `true` to hide the email input in the embedded checkout form. Make sure to display the users email in the parent page when setting this attribute.

Defaults to `false`

<Note>
  Use this in conjunction with the `data-whop-checkout-prefill-email` attribute
  or the `setEmail` method to control the email input.
</Note>

```md
<div data-whop-checkout-hide-email="true" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-disable-email`**

**Optional** - Set to `true` to disable the email input in the embedded checkout form.

Defaults to `false`

<Note>
  Use this in conjunction with the `data-whop-checkout-prefill-email` attribute
  or the `setEmail` method to control the email input.
</Note>

```md
<div data-whop-checkout-disable-email="true" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-hide-address`**

**Optional** - Set to `true` to hide the address form in the embedded checkout form.

Defaults to `false`

<Note>
  This method will only work if the address form is hidden. You can hide the
  address form by setting the `data-whop-checkout-hide-address` prop to `true`.
</Note>

```md
<div data-whop-checkout-hide-address="true" data-whop-checkout-plan-id="plan_XXXXXXXXX"></div>
```

#### **`data-whop-checkout-on-address-validation-error`**

**Optional** - The callback to call when the address validation error occurs.

<Note>
  This method will only work if the address form is hidden. You can hide the
  address form by setting the `data-whop-checkout-hide-address` prop to `true`.
</Note>

```html
<script>
  window.onAddressValidationError = (error) => {
    console.log(error);
  };
</script>

<div
  data-whop-checkout-on-address-validation-error="onAddressValidationError"
  data-whop-checkout-plan-id="plan_XXXXXXXXX"
></div>
```

### Full example

```md
<!DOCTYPE html>
<html>
	<head>
		<meta charset="utf-8">
		<meta name="viewport" content="width=device-width">
		<script
			async
			defer
  			src="https://js.whop.com/static/checkout/loader.js"
		></script>
		<title>Whop embedded checkout example</title>
		<style>
			div {
				box-sizing: border-box;
			}
			body {
				margin: 0
			}
		</style>
	</head>
	<body>
		<div
			data-whop-checkout-plan-id="plan_XXXXXXXXX"
			data-whop-checkout-session="ch_XXXXXXXXX"
			data-whop-checkout-theme="light"
			data-whop-checkout-hide-price="false"
			style="height: fit-content; overflow: hidden; max-width: 50%;"
		></div>
	</body>
</html>
```

## FAQs

<AccordionGroup>
  <Accordion title="Why is my checkout not loading?">
    Make sure you've correctly replaced `plan_XXXXXXXXX` or `PLAN_ID_HERE` in the code snippets with your actual Plan ID from the Whop dashboard. Also verify that the script tag is properly loaded in the `<head>` section if using HTML/JS.
  </Accordion>

<Accordion title="Where do I find my Plan ID?">
    Go to your **Dashboard** > **Checkout links** > Click the **three dots (⋮)** on your pricing option > Hover over **Details** > Click the ID (starts with `plan_`) to copy it.
  </Accordion>

<Accordion title="Can I embed multiple checkouts on the same page?">
    Yes, you can add multiple checkout embeds with different Plan IDs. Each embed operates independently.
  </Accordion>

<Accordion title="How do I change the checkout theme?">
    For React: add `theme="dark"` or `theme="light"` as a property. For HTML: add `data-whop-checkout-theme="dark"` to your div element.
  </Accordion>

<Accordion title="Can I hide the price in the embedded checkout?">
    Yes, add `hidePrice={true}` in React or `data-whop-checkout-hide-price="true"` in HTML to hide the price display.
  </Accordion>

<Accordion title="What happens after a customer completes checkout?">
    By default, customers are redirected to your whop. You can customize this by setting a custom redirect URL or skipping the redirect entirely.
  </Accordion>

<Accordion title="How do I prevent the redirect after checkout?">
    Use `skipRedirect={true}` in React or `data-whop-checkout-skip-redirect="true"` in HTML to keep users on the same page.
  </Accordion>

<Accordion title="Is the embedded checkout mobile-responsive?">
    Yes, the checkout automatically adapts to different screen sizes and devices.
  </Accordion>

<Accordion title="Can I customize the checkout's appearance with CSS?">
    You can style the wrapper using the `.whop-checkout-wrapper iframe` CSS class, but the checkout content itself cannot be modified for security reasons.
  </Accordion>

<Accordion title="Can I pre-fill customer information?">
    Yes, use `prefill={{ email: "customer@example.com" }}` in React or `data-whop-checkout-prefill-email="customer@example.com"` in HTML.
  </Accordion>
</AccordionGroup>

# Create a product
Source: https://docs.whop.com/payments/create-a-product

Learn how to set up products and pricing on Whop

Products are how you package and price your offer on Whop. You can set up free access, one-time payments, or recurring subscriptions for people to access your whop.

## How to create a product

<Steps>
  <Step title="Add a product" titleSize="h3">
    * Go to your **Dashboard**
    * Go to **Products**
    * Click **Add Product**
  </Step>

<Step title="Set up your product details" titleSize="h3">
    Configure the core details of your product:

* **Choose a title**: Keep it clear and descriptive (e.g., “Premium Membership”, “Full Course Access”)
    * Select your pricing option:
      * **Free**: Give customers free access to your product
      * **One-time**: Charge customers once for lifetime access
      * **Recurring**: Set up monthly or yearly subscriptions
    * **Choose currency**: Select the currency you want to charge in
    * **Set your price**: Enter how much customers will pay
      * If you chose recurring, also choose your billing cycle length (weekly, monthly, yearly)
    * **Configure advanced options** (optional):
      * **Stock**: Limit how many people can purchase this product
      * **Add a waitlist**: Users enter payment details but aren’t charged until you approve them
      * **Ask questions before checkout**: Collect information from customers before they purchase
      * **Auto-expire access**: Automatically remove access after a set time period
      * **Redirect after checkout**: Send customers to a specific page after they complete checkout
      * **Add internal name**: A name only you can see on your dashboard
      * **Visibility**: Make this product visible on your public whop store page
    * **Choose payment methods**: Select what customers can pay with
      * Credit/debit card
      * Bank transfer (ACH)
      * PayPal
      * Cryptocurrency
      * Buy now, pay later (Financing)

<Tip>
      If you want to offer multiple pricing options (like both monthly and yearly plans), click Add another billing period.
    </Tip>

When you’re happy with everything, click **Add Product**.
  </Step>
</Steps>

## Next steps

To start accepting payments on Whop, complete the final setup step:

<Card title="Copy checkout link" icon="link" href="/payments/create-checkout-link">
  Checkout links let you send customers straight to a payment page.
</Card>

# Create a whop
Source: https://docs.whop.com/payments/create-a-whop

Learn how to create a whop for payment processing

To start accepting payments, create your account on Whop.

<Steps>
  <Step title="Go to whop.com/sell" titleSize="h3">
    * Head over to [**whop.com/sell**](https://whop.com/sell)
    * Click **Start selling**
  </Step>

<Step title="Choose how you plan to use Whop" titleSize="h3">
    When asked how you plan to to use Whop, you will see two options:

1. **Build & sell digital products on Whop:** Choose this option if you plan to use Whop for building, hosting, and selling your digital products as well as accepting payments
    2. **Use Whop for payment processing only:** Choose this option if you want to use Whop to process payments and create checkout links only - but host and deliver your product elsewhere

If you want to use Whop for payment processing only and host your digital product elsewhere, click **Use Whop for payment processing only**. Then click **Next**.
  </Step>

<Step title="Name your business" titleSize="h3">
    * Choose a name for your business
    * Click **Create my business**
  </Step>
</Steps>

## Next steps

To start accepting payments through Whop, make sure you've completed the rest of the setup steps:

<CardGroup cols={2}>
  <Card title="Create a product" icon="tag" href="/payments/create-a-product">
    Products are how you package and price your various offers.
  </Card>

<Card title="Copy checkout link" icon="link" href="/payments/create-checkout-link">
    Checkout links let you send customers straight to a payment page.
  </Card>
</CardGroup>

# Create a checkout link
Source: https://docs.whop.com/payments/create-checkout-link

Checkout links are the fastest way to accept payment.

Checkout links let you send customers straight to a payment page to buy your products or services. You can offer free access, one-time payments, or monthly subscriptions.

Checkout links are the fastest way to get paid for your products and services. Here's how different businesses use them:

* **Sales teams** — Create custom links for each deal
* **Event hosts** — Send direct links to webinar or workshop checkout pages
* **Freelancers** — Use checkout links as digital invoices for completed work

## Where can I find and create my checkout links?

* Go to your **Dashboard** > **Checkout links** to see all your links
* Click **+ Create checkout link** to create a new one

<Tip>
  Every pricing option you create on your whop can be found at Dashboard > Checkout links.

And every checkout link you create on your dashboard can be found at whop > Manage pricing.
</Tip>

## How to create a checkout link

You can create three types of checkout links:

* **Free links** - Give customers free access to your whop
* **One-time payment links** - Charge customers once
* **Recurring payment links** - Set up monthly or yearly subscriptions

<Tip>
  Each checkout link is connected to one of your whops. When you create the link
  from your whop's pricing page, it's automatically connected to that whop. When
  you create it from your Dashboard, you'll need to choose which whop it's for.
</Tip>

### Free checkout links

**To create a free checkout link:**

1. Choose **Free** under Pricing type
2. Click **Advanced Options** to add these features:
   * **Stock** — Limit how many people can use this link (or keep unlimited)
   * **Description** — Explain what users get when they join
   * **Show on store page** — Make this option visible on your public store page
   * **Add a waitlist** — Users enter card details but aren't charged until you approve them
   * **Ask questions before checkout** — Collect info from users before they join. You can make these optional by checking the **Optional** box.
   * **Auto-expire access** — Automatically remove access after a set time period
   * **Redirect after checkout** — Send users to a specific page after they complete checkout
   * **Add internal name** — A name only you can see on your dashboard

### One-time payment links

**To create a one-time payment link:**

1. Choose **One-time** under **Pricing type**
2. Set your **Price**
3. Click **Advanced Options** to add these features:
   * **Stock** — Limit how many people can use this link (or keep unlimited)
   * **Description** — Explain what users get when they join
   * **Show on store page** — Make this option visible on your public store page
   * **Add a waitlist** — Users enter card details but aren't charged until you approve them
   * **Ask questions before checkout** — Collect info from users before they join. You can make these optional by checking the **Optional** box.
   * **Auto-expire access** — Automatically remove access after a set time period
   * **Redirect after checkout** — Send users to a specific page after they complete checkout
   * **Add internal name** — A name only you can see on your dashboard
4. Choose your **Payment methods** (what customers can pay with):
   * Credit/debit card
   * Bank transfer (ACH)
   * PayPal
   * Cryptocurrency
   * Buy now, pay later (Financing)

### Subscription (recurring) links

To create a subscription link:

1. Choose **Recurring** under Pricing type
2. Set your subscription details:
   * **Subscription price** — How much customers pay each billing cycle
   * **Subscription period** — How often they're charged (weekly, monthly, yearly)
   * **Initial fee** — Optional one-time setup fee when they first join
3. Click **Advanced Options** to add these features:
   * **Stock** — Limit how many people can use this link (or keep unlimited)
   * **Description** — Explain what users get when they join
   * **Show on store page** — Make this option visible on your public store page
   * **Add a waitlist** — Users enter card details but aren't charged until you approve them
   * **Ask questions before checkout** — Collect info from users before they join. You can make these optional by checking the **Optional** box.
   * **Auto-expire access** — Automatically remove access after a set time period
   * **Redirect after checkout** — Send users to a specific page after they complete checkout
   * **Add internal name** — A name only you can see on your dashboard
   * **Free trial** — Let customers try before they pay (choose how many days)
   * **Split payments** — Let customers pay in installments instead of all at once
   * **Cancellation discount** — Offer a discount when someone tries to cancel (helps retain customers)
4. Choose your **Payment methods**:
   * Credit/debit card
   * PayPal

## How to edit checkout links

If you need to update or change your pricing and settings, you can edit your checkout links from either your Dashboard or your whop's pricing page.

### Open your Whop dashboard

* Go to **Dashboard** > **Checkout links**
* Find your link and click the 3 dots (︙) on the right
* Click **Edit**
* Make your changes and click **Update checkout link**

<Card title="Create tracking links" icon="link" href="/manage-your-whop/tracking-links">
  If you want to see how your links are performing, tracking links give you
  detailed analytics of clicks, conversion rates, and revenue generated.
</Card>

## Embed Whop Payments on your website

<Card title="Whop checkout embeds" icon="sparkles" href="/payments/checkout-embed">
  Add a complete checkout form right into your website.
</Card>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What exactly are checkout links?">
    Checkout links (also called pricing options) are custom URLs that let
    customers join your whop with free access, a one-time payment, or a
    recurring subscription.
  </Accordion>

<Accordion title="How do I limit how many people can use a link?">
    In the Advanced Options of any pricing type, look for the "Stock" setting.
    It's set to unlimited by default, but you can change it to any number you
    want.
  </Accordion>

<Accordion title="Can I change the currency for my prices?">
    Yes! When setting the price for one-time or recurring links, you'll see a
    currency dropdown next to the price field.
  </Accordion>

<Accordion title="How do I offer a free trial?">
    Free trials are only available for recurring (subscription) pricing. You'll
    find the free trial option in the Advanced Options section when creating a
    recurring link.
  </Accordion>

<Accordion title="How do I create a private link that doesn't show on my store page?">
    When creating any checkout link, leave the "Show on store page" option
    unchecked. The link will still work when you share it directly, but it won't
    appear publicly on your store.
  </Accordion>

<Accordion title="Why aren't my checkout links showing up on my store page?">
    Check that you enabled "Show on store page" in the Advanced Options when you
    created the link. If this option is off, the link will only work when shared
    directly.
  </Accordion>
</AccordionGroup>

# Credit card disputes
Source: https://docs.whop.com/payments/credit-card-disputes

Learn how to manage credit card disputes on Whop

Credit card disputes happen when customers contact their bank to challenge a payment. Learn how credit card disputes work and how to respond to them effectively.

## What you need to know

* The disputed amount is **immediately withdrawn** from your balance - this makes sure that you are able to cover the amount of the dispute if it is lost
* You have **7–21 days** to respond with proof of the purchase via Whops [**Dispute fighter**](/apps/docs/payments/dispute-fighter)
* The bank's decision will typically take **2–3 months** - you can check this status at any time from the Dispute fighter
* To respond: Go to **Dashboard** > **Dispute fighter**

## Dispute process overview

A dispute happens when a customer contacts their bank or credit card company to challenge a payment they made to your whop. Here's the basic process:

* **Customer files dispute** → Card issuer investigates the dispute
* **Whop gets notified** → You see the dispute in the [Dispute fighter](https://whop.com/dashboard/disputes/)
* **Money gets frozen** → Disputed amount + \$15 fee taken immediately from your balance
* **You submit evidence** → You have 7-21 days to respond to the dispute
* **Card issuer decides** → Takes 2-3 months for final decision

<Tip>
  To access your disputes: Go to Dashboard > Dispute fighter
</Tip>

### Common reasons customers file disputes

* They don't recognize the charge on their statement
* They think the transaction was fraudulent
* They're unhappy with their purchase and aren't aware of the **Resolution Center**
* They tried to cancel but got charged anyway

## Reserves

If your dispute rate gets too high, or if your account shows signs of being at risk of disputes, some of your Whop balance will be held in a reserve.

Reserves protect your account and make sure that you always have enough money available to cover any disputes that might arise. A percentage of each transaction (determined by your dispute risk) will be held for 90 days, after which you can withdraw it as normal.

### A reserve will be placed on your account if:

* Your dispute rate is too high 
* You have a high rate of unresolved resolution center cases      
* Transaction patterns show high risk of payments being disputed

Reserves are temporary and will be released as soon as your account’s dispute rates are healthy. You can check your dispute rate at any time on your Health report on the Payouts page of your creator dashboard.

If Whop detects fraudulent activity, an immediate, 100% reserve will be placed on your account until any signs of fraud are resolved.

## Keeping your account healthy

**Maintaining low dispute rates**

Keeping your dispute rate low is critical to keeping your business healthy. High dispute rates put you at risk with Whop, credit card networks, and financing partners.

To keep your dispute rates low:

* Have a clear Terms of Service, Return policies, and Refund policies
* Make sure your customers know where to go to get help - direct them to the **Resolution center** on Whop to resolve the issue directly
* Respond to Resolution center cases - refund customers where it is deserved to avoid them disputing the payment with their bank
* Set up [auto-responses to Resolution center](https://whop.com/dashboard/resolution-center/) cases to automatically refund cases below a certain dollar amount (that you set)
* Set up [early dispute alerts on the Dispute fighter ](https://whop.com/dashboard/disputes/)to automatically refund transactions before they officially become a dispute

**Negative balances**

Your whop balance can go negative if you have already withdrawn your funds and do not have enough money in your account to cover a dispute or refund.

You can pay off your negative balance from the [Payouts](https://whop.com/dashboard/payouts/) page on your dashboard.

## Dispute FAQs

<AccordionGroup>
  <Accordion title="Why is the dispute amount different from what the customer originally paid?">
    The dispute amount can differ for several reasons:

* **Currency changes** - Exchange rates shift between when they paid and when they disputed
    * **Partial disputes** - Customer only disputes part of what they bought
    * **Multiple charges** - Card issuer combines several disputed payments into one
    * **Partially refunded payments** - Customer disputes the full amount even after getting some money back
  </Accordion>

<Accordion title="Why can't I respond to a dispute?">
    Some disputes you automatically lose and can't challenge:

* Certain fraud cases (depending on the card company)
    * Disputes from some countries due to local laws
    * Cases where the card issuer won't accept evidence
  </Accordion>

<Accordion title="Do I need to submit evidence if the customer cancels their dispute?">
    Yes, you still need to submit evidence.
  </Accordion>
</AccordionGroup>

# Dispute fighter
Source: https://docs.whop.com/payments/dispute-fighter

Automatically fight disputes with customer logs

Whop's dispute fighter helps you track, get ahead of, respond to, and resolve disputes.

## What happens when a dispute is filed?

When a customer files a dispute:

* You’re notified instantly of the dispute via Whop's **Dispute fighter**
* The disputed amount is immediately debited from your balance to make sure you can cover the cost of the dispute, along with a \$15 dispute fee
* Whop auto-uploads key evidence (like access logs, policy disclosures, and customer info) into the dispute fighter
* You can upload additional proof and submit your response directly from your dashboard
* The dispute status, outcome, and deadline are all tracked in **Dispute fighter**

## How to view and manage disputes

You can monitor and manage all your disputes in the **Dispute fighter**:

1. Go to **Dashboard** > **Dispute fighter**
2. Click **Status** and choose from:
   * Needs response
   * Under review
   * Won
   * Lost

Track response deadlines and outcomes from this main view.

## How to respond to a dispute

When you get a dispute notification, you need to act fast and submit your evidence before the deadline.

**To fight a dispute:**

1. Go to **Dashboard** > [**Dispute fighter**](https://whop.com/dashboard/disputes/)
2. Click the dispute you want to respond to
3. Upload your evidence and documentation, such as:
   * Chat logs with the customer
   * Product details and descriptions
   * Cancellation policy
   * Refund policy
4. Add any supporting evidence like:
   * Cancellation request records
   * Customer communications
   * Refund records
   * Proof of subscription agreement
5. Click **Submit** to send your response

<Warning>
  Each dispute shows a "Respond by" date under Status. Make sure to submit your evidence before this deadline, or you'll automatically lose the dispute.
</Warning>

## What Whop automatically submits

Whop automatically uploads relevant files and user logs to strengthen your case:

**Customer details**

* Email address (proves they have an account)
* Customer name (confirms identity)
* Billing address (matches payment method to prove legitimate purchase)

**Product details**

* Purchase date (shows exactly when they bought)
* Description (proves what they purchased and agreed to)
* Access activity log showing:
  * When they bought access
  * If they agreed to Terms of Service and Refund policy
  * If they claimed access
  * If they engaged with your content

**Cancellation policy**

* Policy disclosure (shows customer saw and agreed to cancellation rules)
* Your actual cancellation policy document

**Refund policy**

* Refund refusal explanation (explains why refund wasn't given)
* Policy disclosure (proves customer knew refund rules before buying)
* Your actual refund policy document

<Tip>
  Add your own evidence: Beyond what Whop automatically includes, you can upload supporting evidence and customer communications to strengthen your case.
</Tip>

## Dispute fees

* Whop immediately takes the disputed amount from your account
* You're charged a \$15 dispute fee
* The disputed funds are held during the investigation process to make sure you have enough to cover the dispute, and they are returned once the dispute is won

**If you win**: The disputed amount is returned to your Whop balance

**If you lose**: The customer receives their refund from their card issuer - the money was already deducted to pay for this dispute, so no additional funds are taken from your account.

## How to win disputes

### 1. Set up early dispute alerts (optional)

Early dispute alerts give you advance warning when a customer is about to file a dispute, allowing you to resolve the issue before it becomes an official dispute that hurts your account.

### How Early dispute alerts work

* **Early warning system:** When a customer starts a dispute, you get notified immediately. This gives you a chance to resolve the issue before it becomes an official dispute on your record.
* **Automatic refunds save money:** Any transaction under your set amount gets automatically refunded, saving you from paying chargeback fees that can be much more expensive than the refund itself.
* **Clearer transaction info:** Each purchase shows up on the customer's bank statement with a clear description and website link, helping customers remember what they bought and reducing confusion-based disputes.

**To set it up:**

1. Go to **Dashboard** > **Dispute fighter**
2. Click **Early dispute alert**
3. Enter the amount under **Refund transactions lower than**
4. Click **Save**

<Warning>
  You'll be charged \$29 per Early dispute alert.
</Warning>

### 2. Fight disputes via the Dispute fighter

Knowing how card issuers decide disputes helps you send better proof and win more often.

<Warning>
  Even with Whop's help, the card issuer has the final call on whether you'll win or lose the dispute.
</Warning>

### The decision process

1. **Initial review:** The card issuer looks into the customer's complaint
2. **Submitting evidence:** You have 7-21 days to send your evidence (depending on the card company)
3. **Evaluation:** The card issuer reviews all evidence and makes a decision (usually 60-75 days)
4. **Final answer:** You either win or lose the dispute

### What card issuers look for in your evidence

* **Proof of transaction:** Clear records showing the customer sent the payment
* **Delivery proof:** Evidence you gave them what they paid for
* **Customer chats:** Any messages between you and the customer
* **Terms of Service:** Proof the customer agreed to your terms
* **Return policy:** Your clearly written return policy

## FAQs

<AccordionGroup>
  <Accordion title="How long do I have to respond to a dispute?">
    Each dispute has a deadline shown under Status in Dispute fighter. Response times vary for each dispute, so check them individually.
  </Accordion>

<Accordion title="How do I increase my chances of winning?">
    Provide evidence that directly answers the customer's complaint. Upload clear policies, show proof they received and used your product, and include screenshots of them using your service.
  </Accordion>

<Accordion title="Why did I lose a dispute?">
    The customer's bank makes the final decision, not Whop. Banks review all evidence you submit through Dispute fighter, but they decide the outcome. Whop gives you every tool to win, but we can't control the bank's decision.
  </Accordion>

<Accordion title="Can a customer dispute the same payment multiple times?">
    Yes, but it's rare. Card companies and payment processors allow this - it's up to the payment company, and Whop can't prevent customers from trying again. Fight each dispute fully using Dispute fighter, even if it's the same purchase.
  </Accordion>

<Accordion title="Can I refund a disputed payment?">
    If it's become a full chargeback, you can't refund it. But if the customer contacts their bank and cancels the dispute, then you can give them a refund.
  </Accordion>
</AccordionGroup>

# Financing
Source: https://docs.whop.com/payments/financing

Let customers split payments into monthly installments

Give your customers the flexibility to split their purchases into monthly installments while you get paid upfront.

When your business has been approved, financing options are added to your checkout page automatically.

## Available financing options

Whop partners with five financing providers. Depending on your business, you may qualify for some or all of these options:

* **Splitit**
* **Sezzle**
* **AfterPay**
* **Klarna**
* **Zip Pay**

## How to apply for financing

Apply for financing via this [financing application form](https://hunterd.app.n8n.cloud/form/e9e21a0c-91d5-4cda-9b14-a9506be5af44).

You can also apply for financing directly from the [Checkout links page](https://whop.com/dashboard/links/checkout/) of your dashboard.

1. Click **+ Create checkout link**
2. Select **One-time** as your pricing type
3. Under **Payment methods**, click **Apply for financing**
4. Complete the application form

You will receive an email if we cannot accept or are missing information from your application. Once you are accepted, you will get a Whop DM notifying you that you have access to financing.

Once accepted, all active financing options will automatically show up at customer checkout. You can toggle which financing options you do or do not want as an option on each checkout link from the [Checkout links page](https://whop.com/dashboard/links/checkout/).

## Eligibility requirements

To qualify for financing options, your business must meet these requirements:

### 1. Basic setup requirements

* Your **Whop Payments account** must be fully set up and verified
  * Go to [**Payouts**](https://whop.com/dashboard/payouts/) in your dashboard to complete setup
* **Your store page must be filled out**
  * We need to understand what you're selling and how you fulfill orders

### 2. Business requirements

* **Eligible categories**: Financing companies **cannot** support gambling, sports betting, trading signals (pure education may be ok!), credit offers, or adult content under any circumstances
* **Low dispute rate**: Have \< 2% dispute rate over the last 90 days
  * If you are new to Whop, we will ask for statements from the last 90 days from your previous **payment processor**. Note that we need processing statements, NOT bank statements, and we need to see your total number of transactions and total number of disputes over the last 90 days.
* **Processing volume**: At least \$30,000 processed from 10+ different customers in the last 90 days

<Tip>
  You'll receive a Whop DM when your business is approved and financing is
  enabled. If you haven't heard back about your application, check your email
  for requests for additional documentation or application updates.
</Tip>

## How it works for customers

When financing is enabled:

1. Financing options appear automatically on your checkout page
2. Customers choose their preferred provider (e.g. Klarna, AfterPay)
3. Customers are redirected to the financing provider for instant approval
4. They complete their purchase through the financing platform

You can control which financing options appear on each of your checkout links through your pricing settings.

<Tip>You still receive full payment upfront (minus standard fees)</Tip>

## Keep your financing access

Whop’s priority is to make sure you keep your financing access for the long term. Whop has the following features to help you keep your dispute rates low and keep financing active on your account:

**Dispute rate monitoring**

* View dispute rates for each financing partner on your **Health report** (in the **Payouts** section)
* Alerts sent via email and Whop DM when dispute rates hit warning levels:
  * Klarna: warning at 0.5% dispute rate on Klarna transactions
  * All others: warning 1% dispute rate on any other BNPL option

<Tip>
  When you receive an alert, take extra precautions to prevent further disputes.
  Set clear return policies, refund angry customers, and make sure your
  customers know where to go to resolve issues so they don't dispute directly
  with the bank.
</Tip>

**Splitit minimum balance (Splitit only)**

* 15% of every Splitit transaction is held in your Whop balance for 180 days
* This shows Splitit that you can cover any potential disputes
* Track your Splitit balance and release dates on your [**Payouts**](https://whop.com/dashboard/payouts/) page

### **Dispute rate limits**

Stay under these thresholds to keep your financing access:

* **Klarna:** Under 1% dispute rate
* **All other providers:** Under 2% dispute rate

Financing access will be automatically revoked if you hit these dispute rate thresholds on financed transactions, and you will be notified via email that you have lost access to financing.

## Troubleshooting

If financing isn't showing on your checkout links after approval, check these common issues:

**Transaction too large**

* Sezzle: \$2,500 limit
* AfterPay: \$4,000 limit
* Splitit: \$65,000 limit

**Wrong pricing type**

* Financing only works with one-time payments, not subscriptions

**Location restrictions**

* Sezzle, Klarna, and AfterPay only show for US customers

**Dispute rate too high**

* Check your Health report - you may have exceeded the 2% dispute threshold (1% for Klarna)

**Incomplete setup**

* Ensure your Whop Payments account is fully configured
* Verify your store page is complete with clear product descriptions

# Overview
Source: https://docs.whop.com/payments/overview

Start here if you want to use Whop to accept payments

If you want better processing, but you've already built your business on platforms, you can also use Whop for checkout and payments.

## Get started

<CardGroup cols={3}>
  <Card title="Create an account" icon="sparkles" href="/payments/create-a-whop">
    To start accepting payments, create your account on Whop.
  </Card>

<Card title="Create a product" icon="tag" href="/payments/create-a-product">
    Products are how you package and price your various offers.
  </Card>

<Card title="Copy checkout link" icon="link" href="/payments/create-checkout-link">
    Checkout links let you send customers straight to a payment page.
  </Card>
</CardGroup>

## Next steps

Customize your payments flow and offer flexible payment options to maximize conversions.

<CardGroup cols={2}>
  <Card title="Embedded checkout" icon="cart-shopping" href="/payments/checkout-embed">
    Integrate Whop's checkout directly into your website for a seamless payment
    experience without redirects.
  </Card>

<Card title="Set up financing" icon="credit-card" href="/payments/financing">
    Let customers pay in installments with flexible financing options to
    increase average order value and conversions.
  </Card>
</CardGroup>

# Payment declines
Source: https://docs.whop.com/payments/payment-declines

Learn how payment declines work and how to manage them

Learn what causes payment declines, what Whop does to recover them, and how you or your customers can fix declined payments.

## Specific decline reasons and messages

When a payment is declined, you may receive one of these specific decline codes. Here's what each means and how to resolve them:

| Decline Reason                    | Explanation                                                                                                                                                                                                                                                                    |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `insufficient_funds`              | Your card has insufficient funds to complete this purchase. Please use a different payment method or ensure your account has sufficient funds.                                                                                                                                 |
| `lost_card`                       | This payment was declined because the card is reported as lost. Please use a different card to complete your purchase.                                                                                                                                                         |
| `stolen_card`                     | This payment was declined because the card is reported as stolen. Please use a different card to complete your purchase.                                                                                                                                                       |
| `expired_card`                    | Your card has expired. Please check the expiration date and try again, or use a different card.                                                                                                                                                                                |
| `suspected_fraud`                 | For security reasons, this payment couldn't be processed. Please contact your bank for more information or try a different payment method.                                                                                                                                     |
| `invalid_card_number`             | The card number is incorrect. Please double-check the 16-digit number on your card and try again.                                                                                                                                                                              |
| `invalid_cvc`                     | The security code (CVC) is incorrect. Please check the 3-4 digit code on the back of your card (or front for Amex) and try again.                                                                                                                                              |
| `invalid_cvc_or_expiration`       | The security code (CVC) or expiration date is incorrect. Please double-check both the 3-4 digit security code and the MM/YY expiration date.                                                                                                                                   |
| `incorrect_pin`                   | The PIN entered is incorrect. Please try again with the correct PIN. This decline only applies to payments made with a card reader.                                                                                                                                            |
| `authentication_required`         | Additional verification is required for this payment. You may be redirected to your bank's website or receive a text message to confirm this transaction. Please complete the verification to proceed.                                                                         |
| `card_not_supported`              | This card doesn't support this type of purchase. Please try a different credit or debit card.                                                                                                                                                                                  |
| `currency_not_supported`          | Your card doesn't support payments in this currency. Please use a different card or contact your bank about international transactions.                                                                                                                                        |
| `duplicate_transaction`           | A transaction with the same amount and card was just processed. Please check your email for confirmation. If you didn't receive it, please wait a few minutes before trying again.                                                                                             |
| `generic_decline`                 | Your card was declined. Please try: 1) Using a different card, 2) Contacting your bank, or 3) Checking that your billing information is correct.                                                                                                                               |
| `invalid_account`                 | This card or the associated account is invalid. Please use a different card or contact your bank for assistance.                                                                                                                                                               |
| `invalid_amount`                  | The payment amount exceeds your card's limit. Please try a smaller amount or use a different payment method.                                                                                                                                                                   |
| `processing_error`                | We encountered a temporary issue processing your payment. Please wait a moment and try again, or use a different card.                                                                                                                                                         |
| `restricted_card`                 | This card cannot be used for this payment. It may have restrictions or been reported lost/stolen. Please use a different card.                                                                                                                                                 |
| `card_velocity_exceeded`          | You've exceeded your card's transaction limit or available balance. Please try a smaller amount or use a different card.                                                                                                                                                       |
| `contact_issuer`                  | Please contact your card issuer for more information about this decline. Call the 800 number on the back of your card.                                                                                                                                                         |
| `bank_declined`                   | Your bank has declined this transaction. Please try a different card or contact your bank.                                                                                                                                                                                     |
| `regulatory_blocked`              | This transaction cannot be processed due to regulatory restrictions in your region. Please try a different payment method or contact support for alternatives.                                                                                                                 |
| `transaction_not_permitted`       | Your card issuer doesn't allow this type of transaction. Please use a different card or contact your bank to enable this transaction type.                                                                                                                                     |
| `card_type_not_supported`         | This card type is not supported. Please try a different card.                                                                                                                                                                                                                  |
| `issuer_not_found`                | The payment was declined due to incorrect card or billing details. Please verify your card number, expiration date, and billing address, then try again.                                                                                                                       |
| `closed_account`                  | This card account has been closed. Please use a different card to complete your purchase.                                                                                                                                                                                      |
| `issuer_unavailable`              | We couldn't reach your card issuer to authorize this payment. This is usually temporary. Please try again in a few minutes or use a different card.                                                                                                                            |
| `invalid_zip`                     | The billing postal/ZIP code doesn't match your card's records. Please enter the ZIP code associated with your card's billing address.                                                                                                                                          |
| `invalid_expiry_month`            | The expiration month is invalid. Please enter a valid month (01-12) and try again.                                                                                                                                                                                             |
| `invalid_expiry_year`             | The expiration year is invalid. Please enter a valid 2 or 4-digit year (e.g., 25 or 2025) and try again.                                                                                                                                                                       |
| `invalid_expiry`                  | The expiration date is invalid. Please enter a valid date in MM/YY format and ensure the card hasn't expired.                                                                                                                                                                  |
| `invalid_transaction`             | The issuing bank has declined this transaction. This may be due to an incorrect card number, expired card, invalid card, wrong expiration date, mismatched billing address or zip code, or multiple rapid transaction attempts. Please verify your card details and try again. |
| `cannot_authorize`                | We couldn't authorize this payment. Please try a different card or contact your bank for more information.                                                                                                                                                                     |
| `pin_required`                    | This card requires a PIN for this transaction. Please use a card reader with PIN capability or try a different card.                                                                                                                                                           |
| `pin_try_exceeded`                | Too many incorrect PIN attempts. For security, this card is temporarily blocked. Please contact your bank or use a different card.                                                                                                                                             |
| `high_risk`                       | This payment couldn't be processed due to security concerns. Please try a different card or contact support for assistance.                                                                                                                                                    |
| `test_mode_decline`               | This appears to be a test card number. Please use a real credit or debit card to complete your purchase.                                                                                                                                                                       |
| `merchant_blacklist`              | This payment was blocked for security reasons. Please try a different card or contact support for assistance.                                                                                                                                                                  |
| `reenter_transaction`             | Your bank couldn't process this payment. Please try again, use a different card, or contact your bank for more information.                                                                                                                                                    |
| `invalid_pin`                     | The PIN entered is incorrect. Please try again with the correct PIN for this card.                                                                                                                                                                                             |
| `pin_required_as`                 | This card requires a PIN for this transaction. Please use a card reader with PIN capability or try a different card.                                                                                                                                                           |
| `withdrawal_count_limit_exceeded` | You've exceeded your card's daily transaction limit or available balance. Please try again tomorrow or use a different card.                                                                                                                                                   |
| `invalid_country`                 | The billing country doesn't match your card's records. Please verify your billing address country and try again.                                                                                                                                                               |
| `issuer_error`                    | Your bank detected an issue but couldn't specify the problem. Please try again in a few minutes or contact your bank directly for assistance.                                                                                                                                  |

## What happens when a payment is declined

When a customer's payment gets declined or fails, Whop takes several steps to try and recover the payment:

* **The subscription status changes to Past due**: This means the payment needs attention, but doesn't immediately cancel access
  * You can view Past due payments by going to **Dashboard** > **Payments**, clicking **Status** and selecting only **Past due**
* **We email the customer**: Your customers receive emails prompting them to update their payment information
* **We retry the payment**: Whop automatically retries the charge over a 5-day period
* **Access may be temporarily paused**: Depending on your settings, your customer might lose access to your whop until the payment goes through
  * Go to **Dashboard** > **Settings** > **Checkout** and choose whether you want members to have **Access while past due** or not
* **Subscription is canceled**: If the payment still fails after 5 days, the subscription is canceled automatically

## What you can do to fix a declined payment

When a payment is declined, you can help the customer update their payment method and manually retry the payment from your dashboard.

**Step 1: Ask the customer to update their payment method**

* Contact the customer to confirm they have sufficient funds and a working payment method
* To update their payment method, ask them to follow these steps:
  1. Go to [https://whop.com/@me/settings/memberships/inactive](https://whop.com/@me/settings/memberships/inactive)
  2. Click the **card** button on the affected subscription
  3. Select **Update payment**
  4. Add the new card details and save

**Step 2: Manually retry the payment from your dashboard**

1. Go to **Dashboard** > **Payments**
2. Click **Status** and select only **Failed**
3. Select the failed payment
4. Click **Retry payment**

When the payment processes successfully, Whop restores the customer’s access automatically.

# Refunds
Source: https://docs.whop.com/payments/refund-customer

Learn how to refund your customers on Whop

Process refunds instantly, set up auto-refunds, and manage your account balance on Whop.

## How to process a refund

There are three ways to refund a customer: through their **profile** (quickest method), **Payments**, or the **Resolution Center**.

<Tabs>
  <Tab title="Customer's profile">
    1. Go to your **Dashboard**
    2. Use the search bar at the top right to find the customer
    3. Click on their profile
    4. Click the **Refund** button under **Spend**
       * Or scroll down to **Payments** and click **Refund** next to the specific payment
    5. Choose your refund amount:
       * Click **Refund** for the full amount
       * Check **Partial refund** and enter the amount you want to refund
    6. Click **Confirm**
  </Tab>

<Tab title="Payments">
    Great if you want to see all your transactions:

1. Go to **Dashboard** > **Payments**
    2. Find the payment you want to refund
    3. Click the 3 dots (⋮) next to the customer
    4. Select **Refund** from the dropdown
    5. Choose your refund amount:
       * Click **Refund** for the full amount
       * Check **Partial refund** and enter the amount you want to refund
    6. Click **Confirm**
  </Tab>

<Tab title="Resolution Center">
    1. Go to **Dashboard** > **Resolution center**
    2. Click on the case you want to resolve
    3. Click **Accept**
    4. Choose your refund amount:
       * Click **Refund** for the full amount
       * Check **Partial refund** and enter the amount you want to refund
    5. Click **Confirm**
  </Tab>
</Tabs>

<Tip>
  Refunds are processed immediately, and you'll see the refund appear on the customer's profile right away.
</Tip>

## Set up auto-refunds to save time

If you want to automatically handle smaller refund requests, you can set up auto-refunds for amounts under a certain threshold.

To set up auto-refunds:

1. Go to **Dashboard** > **Resolution Center**
2. Click **Auto respond**
3. Set your auto-refund thresholds:
   * **Auto-refund card payments below**: Set the maximum amount for automatic card refunds
   * **Auto-refund PayPal payments below**: Set the maximum amount for automatic PayPal refunds
4. Add a custom message (optional) that customers will see when they receive an auto-refund
5. Click **Save**

## What to do if you don't have sufficient funds

If your Whop account doesn't have sufficient funds for a refund, you'll need to add money to your account first.

### Top up your balance

To add funds to your account:

1. Go to **Dashboard > Payouts**
2. Click **Top up +**
3. Enter the amount you want to add
4. Choose to pay from your personal balance or select another payment method
5. Click **Pay**

<Tip>
  Always keep some money in your account so you can process refunds quickly. This keeps customers happy and makes your business look professional.
</Tip>

### Set up minimum balance retention

If you use **Recurring withdrawals**, you can automatically keep money in your account for refunds:

1. Go to **Dashboard** > **Payouts**
2. Click **Recurring withdrawals**
3. Set your withdrawal schedule (**Daily**, **Weekly**, or **Monthly**) and click **Continue**
4. Enter the minimum amount you want to keep in your account and click **Continue**
   * We recommend keeping enough to cover at least two refunds at your typical price
5. Click **Confirm**

<Tip>
  If you only use manual withdrawals, you can't set a minimum balance to retain — you'll need to manage your balance manually.
</Tip>

## FAQs

<AccordionGroup>
  <Accordion title="How do fees work with refunds?">
    When you refund someone, you pay back the full amount they originally paid — even though you received less after fees were deducted.

For example: If a customer paid \$100, you'll refund the full \$100 even though you only received around \$97 after Whop and processing fees.

This applies to both full and partial refunds. There are no additional fees to process a refund.
  </Accordion>

<Accordion title="How long does it take for customers to receive their refunds?">
    It depends on the customer's bank or payment method. Customers can typically expect to see refunds in their account within 3-7 business days after the refund is processed.
  </Accordion>
</AccordionGroup>

# Resolution center
Source: https://docs.whop.com/payments/resolution-center

Manage refund requests before they turn into disputes

The **Resolution center** is where you can review and respond to customer refund claims.

## How the Resolution center works

Here’s what happens when a customer opens a claim:

1. **Customer opens a claim**
   * They explain the issue and choose a reason
   * They can upload up to 3 files (screenshots, videos, receipts)
2. **You receive a notification**
   * Whop sends you an email
   * The case appears in your **Resolution center**
3. **You respond**
   * Chat directly with the customer
   * Click **Accept**, **Deny**, or **Request more info**

<Info>
  Whop automatically uploads user logs for every case. In these, you can see:

* When the user bought access to your Whop
  * If they agreed to your Terms of Service and Refund policy
  * If they claimed access to your Whop
  * If they engaged with your Whop
</Info>

4. **A decision is made**
   * If resolved between you and the customer, the case is closed
   * If the case is not resolves or you don’t respond within 7 days, Whop will step in and make a decision

## How to respond to a Resolution center case

1. Go to **Dashboard** > **Resolution center**
2. Click the case you want to manage
3. Click **Accept**, **Deny**, or **Request more info**

You can upload any proof in your response, so make sure to have solid Terms of Service and Return policy.

<Card title="Upload legal documents" icon="file-circle-check" href="/manage-your-whop/legal-documents">
  Learn how to upload legal documents and policies to your whop.
</Card>

<Tip>
  Cases without a response for 7 days are sent to Whop's team automatically. Responding fast shows you care and helps keep customers happy.
</Tip>

## Set up auto respond for small refunds

You can set up automatic refunds for smaller claims:

1. Go to **Dashboard** > **Resolution center**
2. Click **Auto respond**
3. Pick the amount for which auto-refunds are sent:
   * This can be set under **Auto-refund card payments below**
   * And **Auto-refund PayPal payments below**
4. (Optional) Add a custom message your customers will see when they get auto-refunded

## Escalations and appeals

**If you don't respond within 7 days:**

* Whop reviews the case and decides based on all available info
* Both you and the customer are notified of the outcome

**Appeal process:**

* If either you or your customer disagrees with a decision, either party can appeal
* Whop will review the case again
* That decision is final and cannot be appealed further

## Notifications

Whop will email you when:

* A customer opens a new dispute
* A customer replies to your request for more info
* A case is esolved, escalated, or appealed
* Final decisions are made

If you're not getting emails from the Resolution center, go to **Dashboard** > **Settings** > **Notifications** and turn on the **Resolution center** toggle.

## FAQs

<AccordionGroup>
  <Accordion title="How many cases can a customer open?">
    Customers can open a case within 120 days of each payment they've made. For example, if a customer has made three payments, they can open three cases. However, only one case can be opened per payment. Once a case is closed and all appeals have been exhausted, the case cannot be reopened.
  </Accordion>

<Accordion title="Can a customer open a case for a payment that has already been refunded?">
    No. When a payment is refunded, no further case can be opened.
  </Accordion>

<Accordion title="Are all payments eligible for the Resolution center?">
    Only fiat payments are eligible for the Resolution center. Payments made with cryptocurrency via Coinbase Commerce are not eligible since they are irreversible and non-refundable.
  </Accordion>

<Accordion title="What happens when Whop decides in favor of the customer?">
    Whop will either refund the customer on your behalf (which will be automatically processed) or decide to credit the customer's Whop Balance (which you do not incur a cost for). The result will be clearly communicated to you and the customer through the Resolution center timeline for the case.
  </Accordion>
</AccordionGroup>

# Send an invoice
Source: https://docs.whop.com/payments/send-an-invoice

Learn how to create, send, and track invoices on Whop

Whether your business sends customers an invoice upfront for providing a specific service, or the customer requires an invoice before making payment,
you can create an invoice on Whop in a few seconds.

## How to create and send an invoice

<Steps>
  <Step title="Navigate to 'Invoices'" titleSize="h3">
    * Go to your **Dashboard** and click **Invoices** in the **Payments** section.
    * Click **+ Create invoice.**
  </Step>

<Step title="Add customer details" titleSize="h3">
    * Click the **Find or add a customer** dropdown menu.
    * Select an existing customer in the dropdown, or click **+ Add new customer** and enter their email and name.
  </Step>

<Step title="Add due date" titleSize="h3">
    Click the dropdown menu under **Due date** and select when the invoice will become due for payment.
  </Step>

<Step title="Add description" titleSize="h3">
    Add a clear description of what you're billing for — your customer will see this on their invoice.
  </Step>

<Step title="Add amount" titleSize="h3">
    * Choose whether it's a **One-time** or **Recurring** payment:
      * \*\*One-time: \*\*The customer receives a single invoice with the amount you set.
      * \*\*Recurring: \*\*Creates a subscription. An invoice is sent for the first payment, and all following payments are charged automatically (customers receive receipts for these payments, not new invoices). If you select *Recurring*, you'll need to choose how often the customer is charged (e.g. every 7 days, monthly, quarterly, yearly, or a custom billing cycle).
    * **Enter the amount:** Type in the price and use the dropdown to set the currency.
    * Configure advanced options:
      * **Ask questions before checkout:** Collect information from customers before they purchase.
      * \*\*Redirect after checkout: \*\*Send customers to a specific page after they complete checkout.
      * **Payment methods:** Choose how your customer can pay the invoice — options include card, ACH, platform balance, financing (apply for access), PayPal, or crypto (setup required).
  </Step>

<Step title="Pass processing fees (optional)" titleSize="h3">
    You can pass payment processing fees on to the customer by checking the box next to **Pass payment processing fees on to the customer**. When this is checked, payment processing fees will be added to the total invoice amount.
  </Step>

<Step title="Send invoice" titleSize="h3">
    When you are happy with the email and checkout link previews, and you're sure all the details are correct, click **Send invoice**. Your customer will immediately receive the invoice in their email inbox.
  </Step>
</Steps>

## How reminders work

When an invoice passes the due date, Whop's invoice reminders kick in at certain intervals. We'll remind your customers after:

* 3 days
* 7 days
* 14 days
* 30 days
* 60 days

If the invoice is still unpaid after 120 days, it will be automatically voided.

## How to cancel / void an invoice

1. Go to your Invoices dashboard.
2. Find the invoice you want to void.
3. Click the three-dot menu on the right and select **Void invoice**.
4. Once voided, the invoice can no longer be paid.

## How to download an invoice

1. Go to your **Invoices** dashboard.
2. Find the invoice you want to download.
3. Click the three-dot menu on the right and select **Download PDF**.

## Tracking invoices in your dashboard

Your dashboard gives you a full view of every invoice and its status across all your customers, so you always know what's been paid and what's still outstanding.

### Statuses

* **Open:** The invoice has been created and delivered to the customer, but it has not been paid yet.
* **Paid:** The invoice was paid by the customer.
* **Past due:** The invoice was not paid by the due date. It can still be paid for up to 120 days after the due date.
* **Void:** The invoice was either canceled manually or automatically after being past due for 120 days.

### Customize your invoices dashboard

* **Filters:** Use the filters at the top of the table to only see invoices by status (e.g. Open, Paid, Past due) or by collection method (e.g. Send invoice vs Charge automatically).
* **Edit the table view:** Click Edit in the top right to choose which columns to display, such as invoice number, customer name, email, created date, or due date. Drag and drop to reorder columns so the most important details appear first.

### Export invoices for your records

1. Click **Export** in the top right of the dashboard.
2. Choose your time zone (local or UTC).
3. Select a date range (today, last 7 days, last month, or custom).
4. Pick which columns to include, or export all.
5. Click **Export** to download a CSV file you can use for accounting or record-keeping.

# Setup payouts
Source: https://docs.whop.com/payments/set-up-payouts

Learn how to set up payouts and withdraw your balance from Whop

With Whop, you can set up manual, recurring, or instant payouts to your bank account through Whop Payments. You can also get direct payouts to your PayPal and Coinbase Commerce accounts.

## Enable withdrawals with Whop Payments

To withdraw, you'll first need to set up Whop Payments:

1. Go to **Dashboard > Payouts**.
2. Click **Set up Whop Payments**.
3. Select your country so payouts are in your local currency.
4. Complete the Stripe-powered setup (fill in your details, link your bank, and upload ID).

## Check your balance

You can view and withdraw your earnings from either your **Dashboard** or your **Profile**.

### 1. Through your Dashboard

1. Go to **Dashboard > Payouts**.
2. Your **Balance** and **Withdrawals** are here.

Your Balance includes:

* The amount you can withdraw now
* The balance that'll be available to pay out soon (when a customer pays, it can take a couple of days for the money to reach your account)

### 2. Through your Profile

Your payouts can be found at **Profile > Balance**.

## How to withdraw

You can withdraw from your **Dashboard** or **Profile** at any time, as long as you meet the minimum withdrawal threshold of \$10 (if applicable).

### Payout via Dashboard

1. Go to your **Dashboard > Payouts**.
2. Click **Withdraw**.
3. Input the **Amount** you want to withdraw and click **Continue**.
   * You can also click **Use max** to withdraw the maximum amount available.
4. Review the details and click **Confirm withdrawal**.

### Payout via Profile

1. Go to your **Profile > Balance**.
2. Click **Withdraw**.
3. Input the **Amount** you want to withdraw and click **Confirm withdrawal**.

## Setting up recurring withdrawals

1. Go to your **Dashboard** > **Payouts**.
2. Click **Recurring withdrawals**.
3. Choose **How often you want to get paid** and click **Continue.**
4. Set the minimum amount that’s kept in your account and click **Continue.**
   * You should always have a minimum balance available for refunds or to pay out disputes.
5. Review the details and click **Confirm.**

## International payouts

Creators outside the US need to set up a bank account that accepts the currency of their registered country.

On Whop Payments, Whop is the *Merchant of Record*, and our system automatically converts all currencies to the currency of the geography you initially chose when you set up your Whop organization.

* This means that, even if you accept payments in USD, Whop automatically converts the USD payments to your local currency before sending payouts.
* Payouts will NOT successfully go through to a USD-accepting bank account if the bank account is located in a country where USD is not the local currency.

<Warning>
  Your payout country can't be changed for an existing whop. To switch countries, create a new whop and set up Whop Payments under the new country with an associated bank account.
</Warning>

## PayPal payouts

To receive PayPal payouts, customers must buy using PayPal (no post-purchase transfer to PayPal).

### Setting up payouts to your PayPal

1. Go to your **Dashboard** > **Payouts** > **Additional payment methods**.
2. Select **Setup** next to the **PayPal** option.
3. Follow the on-screen instructions to link your PayPal account.

<Tip>
  For PayPal to appear at checkout, check the PayPal box under Payment options when you create a checkout link.
</Tip>

## Coinbase payouts

**Important notes:**

* Withdrawals must go to a Coinbase wallet
* To receive Coinbase payouts, customers must buy using crypto (no post-purchase transfer to Coinbase)

### Setting up payouts to your Coinbase crypto wallet

1. Go to your **Dashboard** > **Payouts** > **Additional payment methods**.
2. Select **Setup** next to the **Coinbase** option.
3. Follow the on-screen instructions to link your Coinbase Commerce account.
4. You will need to log into your Coinbase account and copy your API key and Webhook secret to paste into Whop.

**For Coinbase to appear at checkout:** Check the **Crypto** box under **Payment options** when you create a checkout link.

<Tip>
  To get paid with crypto, you have to set up a one-time pricing plan.
</Tip>

## Troubleshooting payouts

### Common payout statuses

* **Requested:** A withdrawal has been initiated and is awaiting approval
* **Processing / In Transit:** Payment is processing (takes 1–5 business days)
* **Completed:** Funds sent by Whop, awaiting bank processing

### Payout timing & processing delays

**Standard timing:**

* When you make a sale, the money will be available for withdrawal in 1–4 business days.
* Once withdrawn, allow up to 10 business days for the payout to be processed and arrive in your bank.

**If a payout fails:**

1. Go to **Dashboard** > **Payouts**.
2. Click **Retry payout** next to the failed transaction.

You can also click on the payout to see more information on the payout timeline and why the payout may have failed.

**Common reasons for failed payouts:**

* Your bank account is not in the local currency of the country where you registered your Whop
* You entered your bank account information incorrectly

**To replace your bank account:**

* Go to your **Dashboard** > **Payouts**.
* Click on **Withdraw**.
* Click on your bank account (under the amount you want to withdraw).
* Input your new bank account details and click **Replace** (bottom right).

### If a payout says "Completed" but money hasn't arrived

This means the payout has been processed on Whop's end.

1. Allow up to 5 business days (excluding weekends and bank holidays) for your bank to process it.
2. If it takes longer, click on the payout to see the payout timeline. A Trace ID will be provided.

**To track or trace your payout:**

1. Contact your bank's customer service.
2. Share the Trace ID, payout date, amount, and payor name (Whop).

## Withdraw affiliate earnings

There is a 30-day waiting period from when the referred customer makes their purchase and when the referrer gets paid the affiliate cut. This waiting period is to protect businesses on Whop from potential disputes and refunds.

**To withdraw your affiliate earnings:**

1. Go to your **Profile** > **Balance**.
2. Click on **Withdraw**.
3. Input the **Amount** you want to withdraw and click on **Confirm withdrawal**.

# Taxes
Source: https://docs.whop.com/payments/taxes

Learn more about how Whop helps you handle your taxes

<Warning>
  Whop is not qualified to provide financial or tax advice. Always consult with a Certified Public Accountant (CPA), Chartered Accountant, or professional tax advisor for guidance specific to your situation.
</Warning>

Learn how taxes work on Whop - including which tax forms you’ll receive, how sales tax and VAT are handled, and how to apply taxes to your prices.

## Tax forms you'll receive

If you're based in the US, you'll receive tax forms from Whop when you meet certain income thresholds.

### 1099-K forms from Whop

We'll send you a 1099-K tax form if you're US-based and hit the minimum gross receipts for the year:

| Tax Year        | Minimum Gross Receipts |
| :-------------- | :--------------------- |
| 2024            | \$5,000                |
| 2025            | \$2,500                |
| 2026 and beyond | \$600                  |

To receive your 1099-K by January 31st, make sure whop has your:

* Legal name
* Mailing address
* Tax ID Number (TIN)

### Additional 1099-K forms

If you use other payment processors like PayPal alongside Whop, you may receive separate 1099-K forms from each.

### If you're not in the US

We don't send tax forms to creators outside the US right now. If you need any paperwork or reports, just reach out to our support team.

## How Whop handles sales tax, GST, and VAT

Whop acts as the Merchant of Record (MoR) and Deemed Supplier for all Whop Payments transactions, which means we handle the collection and remittance of US sales tax, GST, and VAT for you.

### What Whop covers

When customers pay through Whop Payments, we automatically:

* Figure out what taxes are needed based on where your customer lives
* Collect those taxes when they check out
* Remit taxes to the appropriate tax authorities
* Handle US sales tax, international GST, and VAT compliance

### What you're responsible for

* All other tax filings required in your jurisdiction
* Handle taxes for any sales through other payment methods you might use
* Report your income on your tax returns

<Info>
  If you use other payment processors besides Whop, you might need to handle tax collection yourself. This depends on where you and your customers are located and how much you make.
</Info>

## Understanding VAT for international sales

VAT (Value-Added Tax) is a tax on products and services in places like Europe, the UK, and other jurisdictions.

### How VAT works on Whop

* **Tax rate determined by customer location**: The VAT rate depends on where your customer is located, not where you're based
* **Whop handles collection**: As the Merchant of Record, we collect VAT from EU and UK customers
* **Automatic remittance**: We remit collected VAT to the appropriate tax authorities on your behalf

This means you don't need to worry about VAT when selling to international customers through Whop Payments.

## Choose how taxes are applied to your prices

You get to choose how taxes are applied to your prices.

### Exclusive pricing (default)

Taxes are added on top of your price:

**Example:**

* Your price: \$100
* Taxes: \$20
* Customer pays: \$120
* You receive: \$100

### Inclusive pricing

Taxes are included in your price:

**Example:**

* Your price: \$100
* Taxes: \$20
* Customer pays: \$100
* You receive: \$80

### How to change how taxes are applied to your prices

To switch between **Inclusive** and **Exclusive** pricing:

1. Go to your **Dashboard**
2. Click **Settings**
3. Select **Legal**
4. Click **Tax type**
5. Choose your preferred tax setting:
   * **Exclusive**: Customer pays for tax
   * **Inclusive**: You pay for tax
6. Click **Save**

## Getting tax reports and invoices

Our support team can help you get the documents you need for tax time.

### Request reports and invoices

Contact Whop support to get:

* Tax reporting documents
* VAT compliance invoices
* Any other paperwork you need

# Refer businesses to Whop
Source: https://docs.whop.com/refer-businesses-to-whop

If you refer a business to Whop, you'll earn a 30% commission on their revenue.

If you refer a business to Whop, you'll earn a 30% commission on their revenue they drive to our platform. Revenue is calculated on every transaction.

To refer businesses, go to the [Whop partners page](https://whop.com/affiliates/partners). You will be able to see a list of everyone you have referred.

## Onboard specific business models

Customize your affiliate links to streamline the onboarding process and automatically attribute a business model to your referrals.

### Business model and industry parameters

Add these parameters to your affiliate URLs to streamline the onboarding steps:

* `business_type` - Pre-select the business model
* `industry_type` - Pre-select the industry
* `a` - Your affiliate username to track referrals and earn commissions

#### Valid business model and industry combinations:

**agency**

* `ai_agency`
* `marketing_agency`
* `clipping_agency`
* `development_agency`
* `sales_agency`
* `design_agency`
* `recruiting_agency`
* `coaching_agency`
* `customer_support_agency`
* `other`

**brick\_and\_mortar**

* `gym`
* `coffee_shop`
* `restaurant`
* `salon_spa`
* `retail_store`
* `medical_dentist_office`
* `auto_repair_shop`
* `hotel_lodging`
* `other`

**events**

* `webinars`
* `masterminds`
* `bootcamps`
* `convention`
* `meetups`
* `concerts`
* `parties`
* `other`

**physical\_products**

* `clothing`
* `beauty_and_personal_care`
* `accessories`
* `fitness_gear`
* `food_and_beverages`
* `home_goods`
* `electronics_and_gadgets`
* `other`

**coaching\_and\_courses**

* `fitness`
* `real_estate`
* `business`
* `health_and_wellness`
* `dating`
* `agencies`
* `personal_development`
* `sales`
* `social_media`
* `personal_finance`
* `ai`
* `ecommerce`
* `public_speaking`
* `trading`
* `amazon_fba`
* `reselling`
* `spirituality`
* `careers`
* `home_services`
* `travel`
* `software`
* `kindle_book_publishing`
* `video_games`
* `clipping`
* `sports_betting`
* `vas`
* `other`

**software**

* `ai`
* `trading`
* `ecommerce`
* `business`
* `agencies`
* `social_media`
* `amazon_fba`
* `reselling`
* `video_games`
* `health_and_wellness`
* `personal_finance`
* `fitness`
* `sales`
* `sports_betting`
* `real_estate`
* `software`
* `careers`
* `travel`
* `home_services`
* `public_speaking`
* `dating`
* `personal_development`
* `spirituality`
* `vas`
* `clipping`
* `kindle_book_publishing`
* `other`

**paid\_group**

* `trading`
* `sports_betting`
* `fitness`
* `health_and_wellness`
* `ecommerce`
* `reselling`
* `social_media`
* `ai`
* `business`
* `personal_development`
* `sales`
* `real_estate`
* `agencies`
* `amazon_fba`
* `personal_finance`
* `video_games`
* `dating`
* `spirituality`
* `travel`
* `careers`
* `software`
* `home_services`
* `public_speaking`
* `clipping`
* `vas`
* `kindle_book_publishing`
* `other`

**newsletter**

* `ai`
* `trading`
* `business`
* `personal_finance`
* `ecommerce`
* `health_and_wellness`
* `social_media`
* `fitness`
* `real_estate`
* `agencies`
* `sales`
* `amazon_fba`
* `sports_betting`
* `reselling`
* `personal_development`
* `spirituality`
* `video_games`
* `dating`
* `careers`
* `travel`
* `public_speaking`
* `software`
* `home_services`
* `kindle_book_publishing`
* `clipping`
* `vas`
* `other`

### Example affiliate URLs

```
https://whop.com/new/?business_type=software&industry_type=ai&a=username
https://whop.com/new/?business_type=software&a=username
```

### Common use cases

**For onboarding AI businesses:**

```
https://whop.com/new/?business_type=software&industry_type=ai&a=username
```

**For onboarding clipping groups:**

```
https://whop.com/new/?business_type=paid_group&industry_type=clipping&a=username
```

This is perfect for creating targeted content like YouTube tutorials where you want to streamline the signup process for a specific business model and industry.

# Docs for your LLM
Source: https://docs.whop.com/sdk/ai

Learn how to build with AI using Whop's APIs.

Our docs are available in a text format. You can use this to feed your LLM with the docs.

[https://docs.whop.com/llms-full.txt](https://docs.whop.com/llms-full.txt)

You can also install our MCP by runnning this command:

```bash
npx mint-mcp add whop
```

This provides you with a ready-to-use MCP server with knowledge of our docs.

# Create Access Pass
Source: https://docs.whop.com/sdk/api/access-passes/create-access-pass

<Note>This operation is only available on the server.</Note>

### Required Permissions

* `access_pass:create`

### Usage

```typescript
import { whopSdk } from "@/lib/whop-sdk";

const result = await whopSdk.accessPasses.createAccessPass({
	// A banner image for the access pass in png, jpeg format
	bannerImage: {
		// This ID should be used the first time you upload an attachment. It is the ID
		// of the direct upload that was created when uploading the file to S3 via the
		// mediaDirectUpload mutation.
		directUploadId: "xxxxxxxxxxx",

// The ID of an existing attachment object. Use this when updating a resource and
		// keeping a subset of the attachments. Don't use this unless you know what you're doing.
		id: "xxxxxxxxxxx",
	},

// The business type of the access pass.
	businessType:
		"agency" /* Valid values: agency | brick_and_mortar | coaching | coaching_and_courses | community | course | education_program | events | newsletter | other | paid_group | physical_products | saas | software */,

// The ID of the company to create the access pass for.
	companyId: "biz_XXXXXXXX",

// The creator pitch for the access pass.
	creatorPitch: "some string",

// The custom call to action for the access pass.
	customCta:
		"apply_now" /* Valid values: apply_now | call_now | complete_order | contact_us | donate_now | get_access | get_offer | join | order_now | purchase | shop_now | sign_up | subscribe */,

// The custom call to action URL for the access pass.
	customCtaUrl: "some string",

// The custom statement descriptor for the access pass i.e. WHOP*SPORTS, must be
	// between 5 and 22 characters, contain at least one letter, and not contain any
	// of the following characters: <, >, \, ', "
	customStatementDescriptor: "some string",

// A written description of the access pass.
	description: "some string",

// An array of experience IDs that this pass has
	experienceIds: ["xxxxxxxxxxx"],

// The percentage of the revenue that goes to the global affiliate program.
	globalAffiliatePercentage: 10,

// The status of the global affiliate program for this access pass.
	globalAffiliateStatus: "disabled" /* Valid values: disabled | enabled */,

// The headline of the access pass.
	headline: "some string",

// The URLs of the images to upload to the access pass.
	imageUrls: ["some string"],

// The industry type of the access pass.
	industryType:
		"accessories" /* Valid values: accessories | agencies | ai | ai_agency | amazon_fba | auto_repair_shop | beauty_and_personal_care | bootcamps | business | careers | clipping | clipping_agency | clothing | coaching_agency | coffee_shop | concerts | convention | customer_support_agency | dating | design_agency | development_agency | ecommerce | electronics_and_gadgets | fitness | fitness_gear | food_and_beverages | gym | health_and_wellness | home_goods | home_services | hotel_lodging | kindle_book_publishing | marketing_agency | masterminds | medical_dentist_office | meetups | other | parties | personal_development | personal_finance | public_speaking | real_estate | recruiting_agency | reselling | restaurant | retail_store | sales | sales_agency | salon_spa | social_media | software | spirituality | sports_betting | supplements | trading | travel | vas | video_games | webinars */,

// The logo for the access pass in png, jpeg, or gif format
	logo: {
		// This ID should be used the first time you upload an attachment. It is the ID
		// of the direct upload that was created when uploading the file to S3 via the
		// mediaDirectUpload mutation.
		directUploadId: "xxxxxxxxxxx",

// The ID of an existing attachment object. Use this when updating a resource and
		// keeping a subset of the attachments. Don't use this unless you know what you're doing.
		id: "xxxxxxxxxxx",
	},

// The ID of the marketplace category to assign to the access pass.
	marketplaceCategoryId: "xxxxxxxxxxx",

// The percentage of the revenue that goes to the member affiliate program.
	memberAffiliatePercentage: 10,

// The status of the member affiliate program for this access pass.
	memberAffiliateStatus: "disabled" /* Valid values: disabled | enabled */,

// The details to assign an autogenerated plan.
	planOptions: {
		// The respective currency identifier for the plan.
		baseCurrency:
			"aed" /* Valid values: aed | all | amd | ape | ars | aud | bam | bgn | bhd | bob | brl | bsd | btc | cad | chf | clp | cop | crc | czk | dkk | dop | dzd | egp | etb | eth | eur | gbp | ghs | gmd | gtq | gyd | hkd | huf | idr | ils | inr | jmd | jod | jpy | kes | khr | krw | kwd | lkr | mad | mdl | mga | mkd | mnt | mop | mur | mxn | myr | nad | ngn | nok | nzd | omr | pen | php | pkr | pln | pyg | qar | ron | rsd | rub | rwf | sar | sek | sgd | thb | tnd | try | ttd | twd | tzs | usd | uyu | uzs | vnd | xcd | xof | zar */,

// The interval at which the plan charges (renewal plans).
		billingPeriod: 10,

// An array of custom field objects.
		customFields: [
			{
				// The type of the custom field.
				fieldType: "text" /* Valid values: text */ /* Required! */,

// The ID of the custom field (if being updated)
				id: "xxxxxxxxxxx",

// The name of the custom field.
				name: "some string" /* Required! */,

// The order of the field.
				order: 10,

// The placeholder value of the field.
				placeholder: "some string",

// Whether or not the field is required.
				required: true,
			},
		],

// An additional amount charged upon first purchase.
		initialPrice: 10,

// Indicates if the plan is a one time payment or recurring.
		planType: "one_time" /* Valid values: one_time | renewal */,

// The method by which the plan is released to the public.
		releaseMethod: "buy_now" /* Valid values: buy_now | raffle | waitlist */,

// The amount the customer is charged every billing period.
		renewalPrice: 10,

// The visibility of the plan.
		visibility:
			"archived" /* Valid values: archived | hidden | quick_link | visible */,
	},

// The product highlights for the access pass.
	productHighlights: [
		{
			// Text to display to describe the product highlight (max length 250 for
			// qualification or benefits, 170 for who this is for, 140 for pricing features).
			content: "some string" /* Required! */,

// The type of this highlight.
			highlightType:
				"benefit" /* Valid values: benefit | pricing_feature | qualification | who_this_is_for */ /* Required! */,

// The title of the product highlight, if applicable.
			title: "some string",
		},
	],

// The ID of the product tax code to apply to this access pass.
	productTaxCodeId: "xxxxxxxxxxx",

// The URL to redirect the customer to after a purchase.
	redirectPurchaseUrl: "some string",

// The route of the access pass.
	route: "some string",

// A short description of what the access pass offers or does. Must be 150 chars or less.
	shortenedDescription: "some string",

// Whether or not to show the member count on the access pass.
	showMemberCount: true,

// Whether or not to show reviews on the access pass.
	showReviewsDtc: true,

// The social links for the access pass.
	socialLinks: [
		{
			// The URL of the social link
			url: "some string" /* Required! */,

// The website this link is for
			website:
				"facebook" /* Valid values: facebook | instagram | linkedin | tiktok | twitch | website | x | youtube */ /* Required! */,
		},
	],

// The title of the access pass.
	title: "some string" /* Required! */,

// Whether or not customers can upgrade to different plans on this access pass.
	upgradeable: true,

// This access pass will/will not be displayed publicly.
	visibility:
		"archived" /* Valid values: archived | hidden | quick_link | visible */,
});

```

### Example output

```typescript
const result = {
	// The internal ID of the public access pass.
	id: "xxxxxxxxxxx",

// When the access pass was created.
	createdAt: 1716931200,

// The route of the access pass.
	route: "some string",

// The title of the access pass. Use for Whop 4.0.
	title: "some string",

// The headline of the access pass.
	headline: "some string",

// A short description of what the company offers or does.
	shortenedDescription: "some string",

// Whether this product is Whop verified.
	verified: true,

// This access pass will/will not be displayed publicly.
	visibility:
		"archived" /* Valid values: archived | hidden | quick_link | visible */,

// The number of active users for this access pass.
	activeUsersCount: 10,

// The average of all reviews for this access pass.
	reviewsAverage: 10,

// The creator pitch for the access pass.
	creatorPitch: "some string",

// The timestamp (in milliseconds since epoch) of when the access pass was updated
	updatedAtMs: "9999999",

// Whether to show the offers on the access pass.
	showOffers: true,

// The URL to redirect the customer to after a purchase, if applicable.
	redirectPurchaseUrl: "some string",

// The custom call to action URL for the access pass, if any.
	customCtaUrl: "some string",

// The percentage of a transaction a user is eligible to earn from the whop marketplace global affiliate program.
	globalAffiliatePercentage: 10,

// The status of the global affiliate program for this access pass.
	globalAffiliateStatus: "disabled" /* Valid values: disabled | enabled */,

// The percentage of a transaction a user is eligible to earn from the whop marketplace member affiliate program.
	memberAffiliatePercentage: 10,

// The status of the member affiliate program for this access pass.
	memberAffiliateStatus: "disabled" /* Valid values: disabled | enabled */,

// Whether to show the member count.
	showMemberCount: true,

// The logo for the access pass.
	logo: {
		// The original URL of the attachment, such as a direct link to S3. This should
		// never be displayed on the client and always passed to an Imgproxy transformer.
		sourceUrl: "some string",
	},

// The banner image for the access pass.
	bannerImage: {
		// The source of the attachment
		source: {
			// The URL to access the attachment
			url: "some string",
		},
	},
};

```

# Delete Access Pass
Source: https://docs.whop.com/sdk/api/access-passes/delete-access-pass

<Note>This operation is only available on the server.</Note>

### Required Permissions

* `access_pass:delete`

### Usage

```typescript
import { whopSdk } from "@/lib/whop-sdk";

const result = await whopSdk.accessPasses.deleteAccessPass({
	// The internal ID (tag) of the access pass to delete.
	id: "xxxxxxxxxxx" /* Required! */,
});

```

### Example output

```typescript
const result = true;

```

# Get Access Pass
Source: https://docs.whop.com/sdk/api/access-passes/get-access-pass

Fetches an access pass based on the ID or the route

### Usage

```typescript
import { whopSdk } from "@/lib/whop-sdk";

const result = await whopSdk.accessPasses.getAccessPass({
	// The ID or route of the access pass to fetch.
	accessPassId: "prod_XXXXXXXX" /* Required! */,
});

```

### Example output

```typescript
const result = {
	// The internal ID of the public access pass.
	id: "xxxxxxxxxxx",

// The title of the access pass. Use for Whop 4.0.
	title: "some string",

// A short description of what the company offers or does.
	shortenedDescription: "some string",

// Whether this product is Whop verified.
	verified: true,

// This access pass will/will not be displayed publicly.
	visibility:
		"archived" /* Valid values: archived | hidden | quick_link | visible */,

// The route of the access pass.
	route: "some string",

// The number of active users for this access pass.
	activeUsersCount: 10,

// The banner image for the access pass.
	bannerImage: {
		// The original URL of the attachment, such as a direct link to S3. This should
		// never be displayed on the client and always passed to an Imgproxy transformer.
		sourceUrl: "some string",
	},

// The headline of the access pass.
	headline: "some string",

// A short type of the company that this access pass belongs to.
	company: {
		// The ID (tag) of the company.
		id: "xxxxxxxxxxx",

// The title of the company.
		title: "some string",

// The slug/route of the company on the Whop site.
		route: "some string",

// The company's logo.
		logo: {
			// The original URL of the attachment, such as a direct link to S3. This should
			// never be displayed on the client and always passed to an Imgproxy transformer.
			sourceUrl: "some string",
		},

// The company's banner image.
		bannerImage: {
			// The original URL of the attachment, such as a direct link to S3. This should
			// never be displayed on the client and always passed to an Imgproxy transformer.
			sourceUrl: "some string",
		},
	},

// The average of all reviews for this access pass.
	reviewsAverage: 10,

// The user that owns the access pass (company owner).
	ownerUser: {
		// The internal ID of the user.
		id: "xxxxxxxxxxx",

// The name of the user from their Whop account.
		name: "some string",

// The username of the user from their Whop account.
		username: "some string",

// The user's profile picture
		profilePicture: {
			// The original URL of the attachment, such as a direct link to S3. This should
			// never be displayed on the client and always passed to an Imgproxy transformer.
			sourceUrl: "some string",
		},

// Whether or not the user's phone is verified
		phoneVerified: true,

// The city the user is from.
		city: "some string",

// The country the user is from.
		country: "some string",
	},

// The attachments for the access pass.
	galleryImages: {
		// A list of nodes.
		nodes: [
			{
				// The ID of the attachment
				id: "xxxxxxxxxxx",

// A signed ID of the attachment to directly query the attachment
				signedId: "xxxxxxxxxxx",

// Whether the attachment has been analyzed
				analyzed: true,

// The size of the file in bytes
				byteSizeV2: "9999999",

// The name of the file
				filename: "some string",

// The attachment's content type (e.g., image/jpg, video/mp4)
				contentType: "some string",

// The source of the attachment
				source: {
					// The URL to access the attachment
					url: "some string",
				},

// The blurhash of the image
				blurhash: "some string",

// The height of the video
				height: 10,

// The width of the video
				width: 10,

// The aspect ratio of the video
				aspectRatio: 10,

// The preview of the video
				preview: {
					// The URL to access the attachment
					url: "some string",
				},

// The duration of the audio in seconds
				duration: 10,

// The URL of the waveform for the audio
				waveformUrl: "some string",
			},
		],
	},
};

```

# Update Access Pass
Source: https://docs.whop.com/sdk/api/access-passes/update-access-pass

<Note>This operation is only available on the server.</Note>

### Required Permissions

* `access_pass:update`

### Usage

```typescript
import { whopSdk } from "@/lib/whop-sdk";

const result = await whopSdk.accessPasses.updateAccessPass({
	// A banner image for the access pass in png, jpeg format
	bannerImage: {
		// This ID should be used the first time you upload an attachment. It is the ID
		// of the direct upload that was created when uploading the file to S3 via the
		// mediaDirectUpload mutation.
		directUploadId: "xxxxxxxxxxx",

// The ID of an existing attachment object. Use this when updating a resource and
		// keeping a subset of the attachments. Don't use this unless you know what you're doing.
		id: "xxxxxxxxxxx",
	},

// The creator pitch for the access pass.
	creatorPitch: "some string",

// The custom call to action URL for the access pass.
	customCtaUrl: "some string",

// The percentage of the revenue that goes to the global affiliate program.
	globalAffiliatePercentage: 10,

// The status of the global affiliate program for this access pass.
	globalAffiliateStatus: "disabled" /* Valid values: disabled | enabled */,

// The headline of the access pass.
	headline: "some string",

// The ID (tag) of the access pass
	id: "xxxxxxxxxxx" /* Required! */,

// The ID of an existing attachment object. Use this when updating a resource and
		// keeping a subset of the attachments. Don't use this unless you know what you're doing.
		id: "xxxxxxxxxxx",
	},

// The percentage of the revenue that goes to the member affiliate program.
	memberAffiliatePercentage: 10,

// The status of the member affiliate program for this access pass.
	memberAffiliateStatus: "disabled" /* Valid values: disabled | enabled */,

// The ID of the product tax code to apply to this access pass.
	productTaxCodeId: "xxxxxxxxxxx",

// The URL to redirect the customer to after a purchase.
	redirectPurchaseUrl: "some string",

// The route of the access pass.
	route: "some string",

// A short description of what the access pass offers or does. Must be 150 chars or less.
	shortenedDescription: "some string",

// Whether or not to show the member count on the access pass.
	showMemberCount: true,

// Whether or not to show the offers on the access pass.
	showOffers: true,

// Whether or not to show reviews on the access pass.
	showReviewsDtc: true,

// The title of the access pass.
	title: "some string",