Connect your Whop business
Connect your Whop business so VYG can follow up on abandoned checkouts, declined payments and failed renewals, create promo codes and credit recovered sales.
Connecting your Whop business lets VYG receive checkout, payment, refund and membership events from Whop. You can then build campaigns that text or email buyers who left your checkout, whose payment was declined or whose renewal failed. VYG can create a Whop promo code for each message and credits the sale when the buyer pays. It takes about two minutes.
Before you start
You need to be an owner or admin of the Whop business you want to connect. If you have more than one business on Whop, you pick one while connecting. Each Whop business can be connected to one VYG account.
Connect your business
Add Whop as a data source
Go to Settings > Data sources, click Add data source and pick Whop. Click Continue.
Connect with Whop
Click Connect with Whop. Whop opens and asks you to sign in if you are not signed in already. If you have more than one business, choose the one to connect.
Approve the VYG AI app
Whop shows the permissions the VYG AI app asks for on your business. Review them and approve the app. Whop then sends you back to VYG.
If VYG shows Install our app on Whop, click it, approve the app on your business and come back to the data source page.
Done
Once the app is installed, VYG adds a webhook to your Whop business that sends events to this data source. The data source page shows Receiving events from Whop. New payments and memberships start coming in from then on. Past payments are not imported.
Collect phone numbers at checkout
Whop asks buyers for a phone number only when your checkout is set up to collect one. Without a phone number, VYG can reach the buyer by email only.
To send text messages, turn on phone number collection for your checkout in your Whop dashboard. Only buyers who check out after you turn it on have a phone number on their payment.
Events from Whop
| Event | When it arrives |
|---|---|
| Payment failed | A charge was declined. This covers a declined first purchase and a failed renewal. |
| Payment needs verification | The buyer's bank asked them to verify a payment. The event carries a link the buyer can use to finish it. |
| Payment started | The buyer pressed Pay on your checkout. |
| Payment succeeded | Whop collected the money. This counts as the sale. |
| Membership activated | A buyer gained access to one of your products. |
Whop also sends these events:
- Checkout started, Payment info added and Added to cart: the buyer opened your checkout, entered payment details or added a product to the cart. They come from Whop checkout on whop.com and on your whop.site store.
- Visitor identified: a visitor entered their email or phone number, for example at checkout. Each one arrives as its own event.
- Payment pending and Payment canceled: a payment is waiting to settle, or was canceled before money was collected.
- Refund created and Dispute created: a payment was refunded, or the buyer disputed it with their bank.
- Membership deactivated, Membership cancellation changed and Membership trial ending soon: a buyer lost access, turned cancel at period end on or off, or their free trial is about to end.
- Member created and Member updated: a person joined your business, or their details changed.
- Invoice past due and Invoice paid: an invoice was not paid by its due date, or was paid.
- Waitlist sign-up: a person joined the waitlist for a product.
A checkout event can be followed up only when it carries the buyer's email or phone number.
Campaign tips
Declined checkouts and failed renewals. Both arrive as Payment failed. To target one of them, add a filter on billing_reason:
one_timeorsubscription_create: a declined first purchase.subscription_cycle: a failed renewal of an existing membership.
Abandoned checkouts. Start the campaign from Checkout started, add a wait (for example 30 minutes), then add a filter that continues only if the buyer has not paid. The message can include the checkout link the buyer left.
Some checkouts, such as a custom checkout on your whop.site store, send Visitor identified but not Checkout started. For those, start the campaign from Visitor identified, add a filter on url containing /checkout/, then the same wait and not-paid filter.
Buyers who did not finish paying. Start the campaign from Payment started, add a wait (for example 30 minutes), then add a filter that continues only if the buyer has not paid. Buyers whose payment went through in the meantime are skipped.
Verification needed. Start a campaign from Payment needs verification and include the payment link in the message so the buyer can finish the payment.
See Create a campaign that starts when something happens for how to build these.
Abandoned checkouts on a whop.site store
If you sell through a whop.site store, the site's own server can send Checkout updated to your Whop data source each time a shopper enters an email or phone number at checkout, or changes their checkout. Each event carries the shopper's contact details, the plan and a link back to the checkout, so shoppers who never reached Pay can be followed up too. The site signs each request with a store signing secret that only you and VYG know.
Create the store signing secret
Open your Whop data source. Under Capture checkouts on your whop.site, click Create store signing secret and copy the secret. It is shown only once. If you lose it, click Replace store signing secret; the old one stops working straight away.
Add it to your site
In your whop.site settings, add an environment variable named STORE_WEBHOOK_SECRET and paste the secret as its value. Only your site's server reads it.
Give Whop AI the prompt
Under Prompt for Whop AI, click Copy prompt and paste it into Whop AI for your site. The prompt already contains your webhook URL. It asks Whop AI to send checkout updates from the checkout page through a server route, and to add an optional, unchecked box near the phone field that lets shoppers agree to texts about their order.
Publish the site
Publish the changes, then enter an email or phone number on your checkout. Checkout updated appears in the data source's activity within a few seconds.
Build the campaign
Start a campaign from Checkout updated, add a wait (for example 30 minutes), then add a filter that continues only if the shopper has no Payment succeeded. The message can include the checkout link from the event.
Checkout updated is sent by your site, not by Whop. If a site has no store signing secret, or signs with an old one, VYG rejects its requests.
Promo codes
On the Discounts page, your Whop business appears as a store. A Whop discount can be a percentage or a fixed amount off, valid for 1 to 365 days.
Each buyer gets their own code, created in your Whop business when the message is sent. Each code can be used once and applies to the first billing period. A shared code for everyone, free shipping, buy X get Y and minimum order amounts are not available for Whop.
A payment that uses one of these codes is credited to VYG when Payment succeeded arrives.
Disconnect
To stop receiving events, uninstall the VYG AI app from your Whop business in your Whop dashboard. VYG then receives no new events from that business and cannot create promo codes in it.
You can also turn the data source off in VYG: go to Settings > Data sources, open your Whop data source, click the ... menu at the top right and choose Turn off. Events from Whop are ignored until you turn it back on.
To connect again, open the data source and click Reconnect with Whop.
Troubleshooting
- No events arrive: open the data source page. If it says Install our app on Whop to start receiving events, install the VYG AI app on your Whop business and open the page again. If you deleted the VYG webhook in your Whop dashboard, opening the data source page adds it back.
- Texts are not sent to some buyers: those buyers have no phone number on their payment. Turn on phone collection at checkout, as described above.
- VYG says the business is already connected: the business is connected to another VYG account or data source. If the business is yours, email service@vyg.ai.