whopio/whop-developer

Set up and call the Whop API: pick the credential (API key, user or account token, iframe token, OAuth), configure @whop/sdk in TypeScript, Python or Ruby for sandbox or production, read IDs and dollar amounts, pin versions, send idempotency keys, paginate, handle errors, look up live docs, and use the Whop MCP server's tools safely. Use when: "set up the Whop SDK", "Whop API key", "use the Whop sandbox", "which Whop token do I need", "Whop API returns 401", "Whop 403 forbidden", "Api-Version-Date", "Whop idempotency key", "what is a biz_ / plan_ ID", "Whop MCP", "find my product ID". Chain with: whop-checkout to take a payment, whop-webhooks to receive events, whop-billing for memberships after the sale. NOT for: taking payments (use whop-checkout), webhook handlers (use whop-webhooks), payouts and transfers (use whop-payouts), connected accounts (use whop-platforms), apps inside Whop, OAuth flows and iframe auth (use whop-apps), chat (use whop-communities), Stripe or old Whop API names (use whop-migrate).

Build apps that run inside Whop and install from the Whop App Store: scaffold and deploy with the whop CLI, configure experience and dashboard views, verify the x-whop-user-token and check access with users.checkAccess, request permissions, track installs with app_installation webhooks, run cron jobs, send push notifications, upload files, Sign in with Whop, iframe SDK, Frosted UI, React Native. Use when: "build a Whop app", "whop apps init", "who is the user in my Whop app", "check access to this experience", "app permissions", "app installed webhook", "push notification to members", "x-whop-user-token is missing", "run my app on a schedule". Chain with: whop-api for client setup, whop-webhooks for deliveries, whop-checkout for in-app purchases, whop-communities for chat, forums and courses. NOT for: embedding chat in your own site (use whop-communities), checkout links (use whop-checkout), connected accounts (use whop-platforms), moving off @whop/api (use whop-migrate).

Run Whop billing after the sale: check on the server whether a user has access, read and list memberships and members, cancel at period end or immediately, pause, resume and extend subscriptions, store membership metadata, validate license keys, create and send invoices or charge them to a saved method, refund payments, respond to disputes and dispute alerts, and write fraud rules. Use when: "check if user has access", "only paying members can see this", "cancel subscription at end of period", "pause a membership", "refund a Whop payment", "respond to a chargeback", "send an invoice", "block risky payments". Chain with: whop-webhooks to react to membership, payment and dispute events, whop-checkout for the purchase itself, whop-api for client setup. NOT for: creating prices or checkout pages (use whop-checkout), verifying webhook signatures (use whop-webhooks), paying out sellers (use whop-payouts), access inside a Whop app iframe (use whop-apps).

Take payments with Whop: create products and variants (one-time or recurring), share a checkout link or checkout configuration, embed the Checkout element or Express Checkout with @whop/elements-react, build a form with payment elements and card fields, add Apple Pay or Google Pay, save a payment method and charge it later, add promo codes and tax IDs, test with sandbox cards, and sell from iOS or React Native. Use when: "Whop checkout", "accept payments", "create a subscription price", "checkout link", "embed checkout in my page", "Apple Pay button", "save a card and charge later", "Whop paywall in my iOS app", "test card". Chain with: whop-webhooks to fulfill once the payment succeeds, whop-billing for memberships, refunds and invoices after the sale, whop-api for client setup. NOT for: cancelling or checking a subscription (use whop-billing), connected accounts or charging on behalf of sellers (use whop-platforms), apps inside Whop (use whop-apps), moving from Stripe (use whop-migrate).

Embed Whop chat in your own web or iOS app and use Whop's community APIs: mint chat access tokens, sync your users, render the Chat, DMs list and search elements, theme them, create channels, DMs and support chats, send messages and reactions, and manage forums, forum posts, courses, chapters, lessons and students. Use when: "embed Whop chat", "add chat to my React app", "chat token endpoint", "ChatElement", "DMs list", "support chat for a customer", "open a DM between two users", "send a message to a Whop channel", "post to a Whop forum", "create a course with the API", "read lesson completions", "chat shows unauthorized". Chain with: whop-api for client setup, whop-platforms for enrolling your users as connected accounts, whop-webhooks for chat.message.created, whop-apps when the code runs inside a Whop app. NOT for: building an app that runs inside Whop (use whop-apps), checkout or payment elements (use whop-checkout), payout or wallet elements (use whop-payouts).

Move a payment integration to Whop, or upgrade old Whop code to current API names. Scans a codebase for Stripe or other processor code, maps products, prices, checkout, customers, subscriptions and webhooks to Whop's products, variants, checkout configurations, members, memberships and events, and rewrites old Whop calls (plans, companies, withdrawals, top-ups, API v2, public GraphQL, @whop/api, cents) to current ones. Use when: "migrate from Stripe to Whop", "switch payment processor to Whop", "replace Stripe Checkout with Whop", "move subscribers to Whop", "update old Whop code", "Whop API v2 deprecated", "@whop/api is shut down", "plans renamed to variants", "company_id vs account_id". Chain with: whop-api for client setup, whop-checkout for the new checkout, whop-webhooks for the new handler, whop-billing for memberships. NOT for: a new integration with no existing payment code (use whop-checkout), payouts and transfers (use whop-payouts), connected accounts (use whop-platforms), app auth (use whop-apps).

Move money out of Whop balances: transfers between balances, payouts to banks and PayPal, payout quotes and cancels, payout methods, the embedded payout portal (Wallet element or hosted payouts_portal link), adding funds with deposits, settlement currency, ledgers, financial activity and stats. Use when: "pay my sellers", "send money to a connected account", "transfer from my platform balance", "create a payout", "withdraw to bank", "connect PayPal for payouts", "let users manage their payouts", "embed a payout portal", "top up my balance", "show balance and activity", "reconcile payouts". Chain with: whop-platforms to create and verify the connected accounts you pay, whop-webhooks for payout and transfer events, whop-api for client setup. NOT for: onboarding sellers or KYC (use whop-platforms), charging buyers (use whop-checkout), refunds and disputes (use whop-billing), moving from Stripe Connect (use whop-migrate).

Run a marketplace or platform on Whop: create connected accounts for your sellers, onboard them with account links, verify identity (KYC/KYB) through the hosted flow, the API or the Verifications element, answer RFIs, and collect payments for connected accounts with an application fee. Use when: "build a marketplace", "onboard a seller", "create a connected account", "sub-merchant", "send sellers to KYC", "verify my sellers", "KYB", "verification needs more information", "take a platform fee", "application fee", "split payments with sellers", "embed onboarding in my app". Chain with: whop-payouts to pay connected accounts and embed their payout portal, whop-webhooks for connected-account events, whop-checkout for the checkout UI, whop-api for client setup. NOT for: transfers and payouts (use whop-payouts), a single store taking payments (use whop-checkout), moving from Stripe Connect (use whop-migrate), apps installed inside Whop (use whop-apps).

Receive and verify Whop webhooks: create an endpoint, verify signatures with unwrapWebhook from @whop/sdk/helpers, handle payment, membership, refund, dispute, invoice, payout and app-install events, deduplicate retries, and test locally. Use when: "Whop webhook", "listen for payments", "fulfill after checkout", "grant access when someone pays", "revoke access when a subscription ends", "webhook signature failed", "Whop events aren't arriving". Chain with: whop-checkout for what creates the payment, whop-billing for acting on memberships, whop-api for client setup. NOT for: running a live store by hand (use the Whop CLI or whop plugin), ad conversion tracking.