Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.flexprice.io/llms.txt

Use this file to discover all available pages before exploring further.

Overview

A Whop connection in Flexprice lets you:
  • Sync invoices - push finalized Flexprice invoices to Whop
  • Generate payment links - every synced invoice gets a Whop-hosted payment URL
  • Reconcile payments - payment status is kept in sync between Whop and Flexprice automatically

Prerequisites

Before you start, have:
  1. Whop business account - whop.com
  2. Flexprice account - flexprice.io

Keys you need

KeyWhere to get itWhat it’s for
API KeyWhop Dashboard → DeveloperAPI KeysCreate → select Admin roleAuthenticating all Whop API calls from Flexprice
Company IDView your business profile on Whop → click the three-dot menu () → Copy IDYour Whop business identifier (biz_...)
Product ID (optional)Whop Dashboard → ProductsWhich Whop product invoices are grouped under - leave blank and Flexprice creates one automatically

How to connect your Whop account

Go to Flexprice DashboardSettingsIntegrationsWhopAdd a connection.
1

Name your connection

Enter a name to identify this connection, e.g. Whop Production.
2

Enter API Key and Company ID

  • API Key - starts with apik_. Go to Whop Dashboard → DeveloperAPI KeysCreate, enter a name, and select the Admin role.
  • Company ID - starts with biz_. Open your business profile on Whop, click the three-dot () menu in the top right, and select Copy ID.
3

Product ID (optional)

If you have an existing Whop product, enter its ID (prod_...).Leave blank - Flexprice will automatically create a product called Flexprice Billing Product on the first invoice sync and reuse it for all future invoices.
4

Enable Invoice Sync

Toggle Invoice Sync on to push finalized invoices to Whop. With this off, invoices stay only in Flexprice.
5

Copy your Webhook URL

At the bottom of the drawer, copy your webhook URL. You will need it in the next step.The URL format depends on your region:
RegionWebhook URL
UShttps://us.api.flexprice.io/v1/webhooks/whop/{tenant_id}/{environment_id}
Indiahttps://api.cloud.flexprice.io/v1/webhooks/whop/{tenant_id}/{environment_id}

Configure Webhook in Whop

For Flexprice to mark invoices as paid when payment is completed through Whop, register your webhook URL in Whop.
1

Open Whop Webhook Settings

Go to your Whop Dashboard → SettingsWebhooksAdd Endpoint.
2

Paste the Webhook URL

Paste the URL copied from the Flexprice connection drawer.
3

Subscribe to invoice.paid

Select the invoice.paid event and save.
Without the webhook configured, invoices synced to Whop will not automatically mark as paid in Flexprice when payment is completed. You would need to reconcile payments manually.

Troubleshooting

IssueCauseSolution
Invoice not syncing to WhopInvoice sync toggle is offEnable outbound sync in connection settings
Sync fails - customer errorCustomer has no email addressAdd an email to the customer in Flexprice before finalizing the invoice
invoice.paid not receivedWrong URL or event not subscribedRe-copy the URL from the drawer and confirm invoice.paid is selected in Whop

Next Steps

  1. Finalize a test invoice in Flexprice and verify it appears in your Whop dashboard
  2. Check the invoice in Flexprice for whop_checkout_url in the metadata
  3. Pay the Whop invoice and confirm the Flexprice invoice is marked paid