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

KeyWhere to get itWhat it’s for
API KeyWhop Dashboard → Developer → API Keys → Create → select Admin roleAuthenticating all Whop API calls from Tirdad
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 Tirdad creates one automatically

​
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 depends on your region:
RegionWebhook URL
UShttps://api.tirdad.ai/v1/webhooks/whop/{tenant_id}/{environment_id}
Indiahttps://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:
EventPurpose
invoice_paidMarks the Tirdad 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 Tirdad 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 Tirdad 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 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