> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Set Up an External Pricing Page

## Article: Set Up an External Pricing Page

## Article Link: https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-an-external-pricing-page.md

## Article Content:

# 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](https://dev.wix.com/docs/build-apps/develop-your-app/access/authentication/about-oauth.md).
2. Subscribe to the [relevant webhooks](https://dev.wix.com/docs/build-apps/develop-your-app/api-integrations/events-and-webhooks/about-webhooks.md):
   - [Paid Plan Purchased](https://dev.wix.com/docs/rest/app-management/app-instance/paid-plan-purchased.md)
   - [Paid Plan Changed](https://dev.wix.com/docs/rest/app-management/app-instance/paid-plan-changed.md)
   - [Paid Plan Auto Renewal Cancelled](https://dev.wix.com/docs/rest/app-management/app-instance/paid-plan-auto-renewal-cancelled.md)
3. Use each Wix user's unique [app instance ID](https://dev.wix.com/docs/build-apps/develop-your-app/access/app-instances/about-app-instances.md#app-instance-id) to recognize them as a Wix user and display the correct settings.

<blockquote class="important">

**Important:**
Prevent Wix users from downgrading through your external pricing page. Downgrades or switches from yearly to monthly pricing require subscription cancellation and repurchase of the lower-priced plan. This is due to how the Wix billing system handles subscription modifications to ensure accurate billing and prevent revenue discrepancies.

</blockquote>

## 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**](https://manage.wix.com/app-selector?title=Select+an+App&primaryButtonText=Select+Site&actionUrl=https%3A%2F%2Fdev.wix.com%2Fapps%2F%7BappId%7D%2Fpricing) 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](https://dev.wix.com/docs/build-apps/develop-your-app/access/app-instances/about-app-instances.md#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](https://dev.wix.com/docs/rest/app-management/app-billing/billing/introduction.md) 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`](https://dev.wix.com/docs/api-reference/app-management/app-billing/billing/get-url.md) 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](https://dev.wix.com/docs/rest/app-management/app-instance/get-app-instance.md).
  
## See also
- [Set up a freemium business model](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-freemium-business-model.md)
- [About monetizing your app](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/about-monetizing-your-app.md)