> 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 One-Time Payments ## Article: Set Up One-Time Payments ## Article Link: https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-one-time-payments.md ## Article Content: # Set Up One-Time Payments One-time payments let you offer packages that Wix users pay for as standalone, non-recurring purchases. For example, if your app sells custom images, you can sell each image as a one-time purchase or offer a pack of 10 images at a set fee. One-time payments use the [single billing model](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/about-pricing-plans-and-business-models.md#billing-models) and can be part of either a [freemium](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-freemium-business-model.md) or [premium](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-premium-business-model.md) business model.
__Important:__ You can't mark your app as "Free" and offer one-time payments, as this would mislead Wix users. Your app must use a freemium or premium business model.
## Step 1 | Add pricing plans Add at least 1 single pricing plan to define what Wix users can purchase in your app. 1. 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 in your app's dashboard. 2. Select **Freemium** or **Premium** under Business model. 3. Go to **Pricing Plans** and click **Add Plan**. 4. Choose the **Single** billing model. This sets up a non-recurring upfront fee each time Wix users use a service in the app. 5. Set a price for the plan. 6. Add plan details: - **Plan Name**: Add a name for the plan (max. 23 characters). Choose a name that clearly describes what the Wix user is purchasing, such as "100 SMS Credits" or "Image Pack." - **Benefits**: Add up to 4 benefits that describe what's included in the package. 7. Click **Add Plan**. 8. Click **Save**. > **Note:** Single plans don't appear in the Wix App Market listing or on the Wix-hosted pricing page. You need to design your own pricing page to showcase these plans. See [step 2](#step-2--design-your-own-pricing-page). Repeat these steps for each package you want to offer. For example, you might create separate plans for different credit amounts or package sizes. You can always come back and [update your pricing plans](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/change-app-pricing.md) later if your needs change. ## Step 2 | Design your own pricing page Because single plans aren't supported on the Wix-hosted pricing page, you need to build your own pricing UI. Display this page in your app's settings panel or dashboard so Wix users can browse the available packages and make a purchase. Your pricing page should: - Show each available package with its name, price, and benefits. - Include a clear call-to-action button for each package. - Display the Wix user's current balance or remaining credits, if applicable. To set up the full external pricing page flow, including OAuth and webhook configuration, see [Set up an external pricing page](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-an-external-pricing-page.md). ## Step 3 | Direct Wix users to the Wix checkout When a Wix user clicks a call-to-action button on your pricing page, direct them to the Wix checkout to complete the purchase. 1. Connect each package's call-to-action button to a call to the [Billing API](https://dev.wix.com/docs/rest/app-management/app-billing/billing/introduction.md). 2. Call [Get URL](https://dev.wix.com/docs/api-reference/app-management/app-billing/billing/get-url.md) to retrieve a checkout link for the selected plan. Open this link in a new tab. 3. After the Wix user completes their purchase, Wix redirects them to the `successUrl` you specified in the Get URL call. If you don't specify a `successUrl`, Wix uses its default success page. > **Note:** Checkout links are valid for 48 hours. Call [Get URL](https://dev.wix.com/docs/api-reference/app-management/app-billing/billing/get-url.md) again to generate a fresh link before the current one expires. For apps with an internal dashboard, set the `successUrl` to `"https://www.wix.com/my-account/app//"` to redirect Wix users back to their app dashboard after purchase. You can find your app ID in the [app dashboard](https://dev.wix.com/apps), and the instance ID by calling [Get App Instance](https://dev.wix.com/docs/rest/app-management/app-instance/get-app-instance.md). ## Step 4 | Track purchases and manage balances Unlike recurring plans, one-time purchases require you to track each Wix user's balance on your server. For example, if a Wix user buys 100 SMS credits, your app needs to know how many credits they've used and how many remain. ### Listen for billing webhooks Subscribe to the following webhooks to get notified when a Wix user makes a purchase: - [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) Check the `cycle` property in these webhooks to identify the purchase details. ### Retrieve purchase history Use the [Get Purchase History](https://dev.wix.com/docs/rest/app-management/app-billing/billing/get-purchase-history.md) API to retrieve a Wix user's full purchase history. Don't rely solely on webhooks to know when a Wix user makes a purchase -- always validate with the API. ### Update and track balances Keep track of each Wix user's remaining balance on your server. Make sure that: - The balance persists even if the Wix user uninstalls and reinstalls your app. - Your app displays the Wix user's remaining balance so they know when to buy more. - Your app handles the case where a Wix user's balance runs out, such as by prompting them to make another purchase. ## Step 5 | Test your pricing flow All plans are automatically priced at 0.00 during development, so you can test the full purchase flow at no cost. Once your app is approved and published, the real prices you configured are activated. Test the following: - The purchase flow works end-to-end, from your pricing page through Wix checkout and back to your app. - Your app receives and processes webhooks correctly after each purchase. - The Wix user's balance updates correctly after each purchase. - The balance displays correctly to the Wix user after purchase. Learn more about [testing your app's upgrade process](https://dev.wix.com/docs/build-apps/launch-your-app/app-distribution/test-your-app-s-upgrade-process.md). ## See also - [About pricing plans and business models](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/about-pricing-plans-and-business-models.md) - [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) - [Set up a premium business model](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-premium-business-model.md) - [Set up an external pricing page](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-an-external-pricing-page.md) - [Identify and manage app users](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/identify-and-manage-app-users.md)