Skip to main content

Overview

A Whop connection in Tirdad lets you:
  • Sync invoices - push finalized Tirdad 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 Tirdad automatically

Prerequisites

Before you start, have:
  1. Whop business account - whop.com
  2. Tirdad account - tirdad.ai

Keys you need

How to connect your Whop account

Go to Tirdad Dashboard → Settings → Integrations → Whop → Add 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 → Developer → API Keys → Create, 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 - Tirdad will automatically create a product called Tirdad 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 Tirdad.
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 is https://api.tirdad.ai/v1/webhooks/whop/{tenant_id}/{environment_id}.

Configure Webhook in Whop

For Tirdad 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 → Settings → Webhooks → Add Endpoint.
2

Paste the Webhook URL

Paste the URL copied from the Tirdad connection drawer.
3

Subscribe to events

Select the following events and save:
4

Copy the Secret and paste it into Tirdad

Whop shows a Secret for the endpoint you just created. Copy it and paste it into the Webhook Secret field in the Tirdad connection drawer before saving.
The webhook secret is required. Tirdad will not create a Whop connection without it. Without the webhook configured, invoices synced to Whop will not automatically mark as paid in Tirdad and Charge Automatically will not activate.

Troubleshooting

Next Steps

  1. Finalize a test invoice in Tirdad and verify it appears in your Whop dashboard
  2. Check the invoice in Tirdad for whop_checkout_url in the metadata
  3. Pay the Whop invoice and confirm the Tirdad invoice is marked paid
  • Invoice Sync - How invoices are synced and payments reconciled