Skip to main content

How to Integrate Whop with Phoenix

To integrate your Whop store with Phoenix, you must generate a set of API credentials in your Whop Developer settings and enter them into your store's configuration. This connects your storefront to Phoenix's checkout, billing, and webhook processing, so transactions and billing events sync automatically between the two platforms.

Prerequisites​

Before you generate your Whop credentials, make sure you have access to the Whop Developer area:

  • Create a Whop account.

  • In the Whop Dashboard, make sure you have a Company configured. This makes you the Owner of that company, which gives you the access you need to create API keys and webhooks.

Generate Your Whop API Credentials​

Complete the following sections in Whop to create an API key, a webhook, and a product, then copy each credential as you go.

Create an API Key​

Perform these steps to create your Whop API key.

  1. Click Developer in the left navigation menu.

  2. Click Create under Company API Keys.

  3. Enter PHX API KEY in the Name field of the Create API key dialog.

  4. Change Inherit permissions from role from Custom to Admin. Whop automatically selects the required permissions once you make this change.

  5. Click Create to generate the key.

  6. Click the copy icon next to the masked key in the API key details panel that appears to copy it to your clipboard. This is your API Key.

    Business ID

    Your Whop dashboard URL also contains your Business ID. In your browser's address bar, copy the value that begins with biz_, for example https://whop.com/dashboard/biz_xxxxxxxxxxxxx/developer/.

Create a Webhook​

Use these steps to create the webhook Phoenix uses to receive billing events.

  1. Open Webhooks under Developer and click Create webhook.

  2. Enter https://api.phoenixcrm.io/portal/api/webhooks/whop in the Endpoint URL field.

  3. Select the following under Events:

    • Invoice: invoice_created, invoice_paid, invoice_past_due, invoice_voided

    • Setup Intent: setup_intent_requires_action, setup_intent_succeeded, setup_intent_canceled

    • Payout: payout_method_created

    • Payment: payment_created, payment_succeeded, payment_failed, payment_pending

    • Dispute: dispute_created, dispute_updated

    • Refund: refund_created, refund_updated

  4. Click Save to create the webhook.

  5. Locate the Secret for the webhook you created and click it to copy it to your clipboard. This is your Webhook Secret.

Create a Product​

Follow these steps to create the Whop product tied to your offer.

  1. Click Products in the left navigation menu.

  2. Select Create product.

  3. Enter a name using the format PHX + <Offer Name> in the Name field.

  4. Click Next repeatedly until Save product becomes available.

  5. Select Save product to finish creating the product.

  6. Open the three-dot menu next to the product you created.

  7. Select Details to reveal the Product ID.

  8. Copy the Product ID to your clipboard. This is your Product ID.

Configure Your Store in Phoenix​

Enter the following Whop credentials into Phoenix: the API Key, Business ID, Webhook Secret, and Product ID.

  1. Click Stores in the left navigation menu.

  2. Find the store you want to configure and click the Edit icon in the Actions column.

  3.  Enter your Whop credentials in the Storefront Setup tab, in their corresponding fields:

    • Whop API Key: paste the API key you copied from Whop.

    • Whop Business ID: paste the Business ID from the dashboard URL.

    • Whop Product ID: paste the Product ID you copied from the product's Details menu.

    • Whop Webhook Secret: paste the Secret you copied from the Webhooks page.

  4. Click Continue to move through the remaining tabs.

  5. Click Update Storefront on the final tab to save your changes.

For more on configuring your store and troubleshooting your integration, see the guides below: