Pricing Plans Settings: Sample Flows

This article presents possible use cases and corresponding sample flows that you can support. It provides a useful starting point as you plan your implementation.

Configure tax handling for pricing plan purchases

You can choose which of the site's addresses determines the tax applied to plan purchases, and verify the change before relying on it.

To configure tax handling:

1. Call Get Pricing Plans Settings and store the returned revision. Settings always exist for a site with Wix Pricing Plans installed, so you don't need to handle a missing object.

2. Decide which address applies. BILLING calculates tax from the buyer's billing address, supplied at checkout. BUSINESS calculates tax from the site owner's business address.

3. If you're switching to BUSINESS, confirm the site has a business address by calling the Site Properties API. Plan purchases fail while taxableAddress is BUSINESS and the site has no business address.

4. Call Update Pricing Plans Settings with taxableAddress and the revision from step 1.

5. Read the revision from the response and use it for your next update. Reusing a stale revision fails.

Let visitors buy a plan without signing in

By default, a site visitor must sign in as a site member before buying a plan. You can lift that requirement for the whole site.

To let visitors buy a plan without signing in:

1. Call Get Pricing Plans Settings and store the returned revision.

2. Call Update Pricing Plans Settings with guestCheckoutSettings.enabled set to true and the revision from step 1.

3. Read the revision from the response and store it for your next update.

4. On the live site, select a plan as a visitor and confirm that the checkout completes without a sign-in step.