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 events

Select the following events and save:
EventPurpose
invoice_paidMarks the Flexprice invoice as paid when payment completes
payment_succeededEnables Charge Automatically for future invoices
Without the webhook configured, invoices synced to Whop will not automatically mark as paid in Flexprice and Charge Automatically will not activate.

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
Webhook events not receivedWrong URL or events not subscribedRe-copy the URL from the drawer and confirm both invoice_paid and payment_succeeded are 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
  • Invoice Sync - How invoices are synced and payments reconciled