Invoicing with Whop

Connect your Whop account to sell one-off checkouts and memberships from Myra.

Invoicing with Whop

Whop is one of four ways to collect money in Myra - alongside Stripe (cards + wallets), Wise (bank transfer) and Bank transfer (manual). Whop gives you a hosted checkout page that accepts cards, Apple Pay, Google Pay and crypto, and it's the easiest way to sell memberships / recurring community access.

What Whop can do in Myra

  • One-off invoices - Myra spins up a hidden Whop plan for that exact amount and returns a hosted checkout URL.
  • Recurring memberships - monthly / yearly subscriptions on a contact.
  • Auto-reconciliation - Whop webhooks (payment.succeeded, membership.went_valid) mark invoices paid instantly.

Whop does not support on-demand off-session charges - Whop only pulls the card on its own membership renewal schedule. Use Stripe for "charge this saved customer $X right now".

Prerequisites

  • A Whop company / account: https://whop.com.
  • An API key from Whop โ†’ Developer โ†’ API keys.
  • (Optional) The company ID if you belong to more than one Whop company.

Step 1 - Create the API key in Whop

  1. Sign in at https://whop.com/dashboard.
  2. Go to Developer โ†’ API keys. Direct link: https://whop.com/dashboard/developer/
    ๐Ÿ“ธ Whop's own developer guide (with screenshots of these screens): https://dev.whop.com/introduction
  3. Click Create new API key. Give it a name like Myra.
  4. Grant it read + write on plans and payments.
  5. Copy the key (starts with whop_โ€ฆ). You'll only see it once.

Step 2 - Connect Whop to your client

  1. In Myra go to Payments โ†’ Integrations.
  2. On the Whop card click Connect Whop.
  3. Paste the API key. Add the Company ID if you belong to more than one company.
  4. Click Verify & connect. Myra stores the key encrypted (AES-256-GCM) and pulls your company name.

Step 3 - Set up the webhook (so invoices auto-mark paid)

Without a webhook, Myra can still create Whop checkout links but won't know when the customer pays until you refresh.

  1. On the Whop card in Myra, copy the Webhook URL shown (it contains your client id).
  2. In Whop, go to Developer โ†’ Webhooks โ†’ Add endpoint.
  3. Paste the URL. Subscribe to these events:
    • payment.succeeded
    • membership.went_valid
  4. Whop shows you a signing secret - copy it.
  5. Back on the Myra Whop card click Add webhook secret, paste it, save.

Whop's webhook docs with screenshots: https://dev.whop.com/webhooks

Send a Whop invoice

  1. Open Payments โ†’ Invoices โ†’ New invoice.
  2. Under Payment method choose Whop (hosted checkout).
  3. Pick the contact, add line items, set a due date.
  4. Click Create. Myra:
    • Creates a hidden plan in your Whop company for that exact amount.
    • Saves the checkout URL on the invoice and sends it to the customer.
    • Marks the invoice paid when Whop's payment.succeeded webhook arrives.

Sell a recurring membership

  1. Payments โ†’ Recurring โ†’ New subscription.
  2. Pick the contact and choose Whop as the provider.
  3. Set monthly / yearly interval and price.
  4. The customer completes checkout on Whop; renewals are handled by Whop and Myra tracks them via membership.went_valid.

Troubleshooting

  • "Invalid API key" - the key was revoked in Whop, or you belong to multiple companies and didn't set a Company ID. Recreate the key with correct scopes and reconnect.
  • Invoice stays "Sent" after the customer paid - webhook not set up, or the signing secret is missing / wrong. Re-do Step 3.
  • Customer paid the wrong amount - Whop only charges the plan amount. If the invoice was regenerated, resend the new checkout link.

What we store

Your API key and the (optional) webhook signing secret, both encrypted at rest with AES-256-GCM. Only server functions can decrypt them.

Optional scopes (unlock more features)

The minimum scopes are Plans (R+W) and Payments (R+W). If you grant these extras on the API key, Myra unlocks more:

Extra scope What it unlocks
Memberships: Read + Write Cancel, pause and refund subscriptions from inside a contact in Myra
Users: Read Auto-link Whop buyers back to Myra leads by email
Webhooks: Write One-click Auto-register webhook button - no need to paste the URL or copy the signing secret manually

Recreate or edit the key in Whop -> Developer -> API keys and tick the extra boxes, then reconnect in Myra.

One-click webhook setup

If your API key has Webhooks: Write:

  1. On the Whop card in Myra click Auto-register webhook.
  2. Myra creates the webhook on your Whop account, subscribes to the right events and saves the signing secret automatically.
  3. You're done - no need to visit Whop -> Developer -> Webhooks at all.

Without that scope you still have the manual flow in Step 3 above.

What Whop still cannot do

  • On-demand off-session charges. Whop only bills on the plan's own renewal schedule. For "charge this saved customer $X right now" use Stripe.