About the Billing API

The Billing API allows you to charge Wix users for using your app when Wix processes the payments.

With the Billing API, you can:

• Retrieve the Wix checkout URL for a specific plan. Use it to redirect Wix users from your custom pricing page to Wix checkout.
• Retrieve data about a site's previous purchases for your app.
• Test your app's integration and charge Wix users varying amounts each billing cycle with the Custom Charges service plugin.

For more information on how to track data associated with individual app instances, see the App Instance API.

Before you begin

It's important to note the following points before starting to code:

• Wix allows you to manage your app's pricing page either through Wix or externally. You can display up to 4 different plans for your app on the Wix pricing page.
• If you manage your app's pricing page on your own servers with an external pricing page, you can still redirect Wix users to the Wix checkout page by using Get URL.

Use cases

• Set up an external pricing page

Terminology

• App instance: Specific occurrence of your app on a particular Wix site.
• Paid plan: Wix users have installed a version of your app that isn't free of charge. Your app can charge them a one-time payment or on a subscription basis.
• Wix pricing page: Wix offers your app an out-of-the-box pricing page that displays up to 4 plans for your app to Wix users.
• External pricing page: A custom pricing page that you host on your own servers. You can use an external pricing page with either Wix-processed payments using this Billing API, or partner-processed payments using the External Billing Events API.
• Partner Billed App: An app where you process payments through your own payment provider, such as Stripe or PayPal, instead of using Wix checkout. Partner Billed Apps must report billing events using the External Billing Events API.
• Wix checkout: The standard Wix checkout page where Wix processes payments.