Set Up an External Pricing Page

You can host a pricing page on your own platform to showcase the key features of each plan you offer. Add at least 1 pricing plan in the app dashboard.

Before you begin

Hosting a pricing page on your own platform requires you to monitor user actions and respond appropriately within your app, so you should:

1. Set up OAuth.
2. Subscribe to the relevant webhooks:
   • Paid Plan Purchased
   • Paid Plan Changed
   • Paid Plan Auto Renewal Cancelled
3. Use each Wix user's unique app instance ID to recognize them as a Wix user and display the correct settings.

Step 1 | Add a URL for your external pricing page

Set a URL to direct Wix users from Wix to your platform.

To add the URL:

1. In your app's dashboard, go to the Pricing page.
2. Select Link to External Pricing Page.
3. Add the URL for your pricing page.
4. Click Save.

Wix users can access your pricing page from:

• App Market listing: Users can view pricing without installing your app.
• Upgrade App button in Manage Apps: Users will see this if they have already installed your app. You can use a query parameter with the user's app instance ID to identify users, log them in, and show relevant pricing info.

Step 2 | Connect your call-to-action buttons to the Billing API

Link each plan's call-to-action button on your pricing page to a call to the Billing API to get the relevant checkout link. Refresh checkout links regularly as they're only valid for 48 hours.

Step 3 | Redirect Wix users to the Wix checkout link

When a Wix user clicks a plan's call-to-action button, direct them to the checkout link you retrieved from the Get URL API call. This checkout link directs users to complete their purchase in the Wix checkout flow.

After purchase

After a Wix user completes their purchase:

1. Wix redirects the user to the successUrl you specified when you called Get URL. If you don't specify a successUrl, Wix redirects them to the default Wix success page. For apps with an internal dashboard, set the successUrl to "https://www.wix.com/my-account/app/<appID>/<appInstanceID>" to redirect Wix users directly to their app dashboard.
2. If you're registered for the Paid Plan Purchased event, you receive the event. Validate that the returned Plan ID matches the plan from the checkout link.
3. Validate the Wix user's premium plan by calling the App Instance method.

See also

• Set up a freemium business model
• About monetizing your app