> 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: Introduction

## Article: Introduction - Packages and Product Instances

## Article Link: https://dev.wix.com/docs/api-reference/account-level/resellers/packages-and-product-instances/introduction.md

## Article Content:

# About the Packages and Product Instances API

The Packages and Product Instances API allows
[resellers](https://dev.wix.com/docs/rest/account-level/resellers/introduction.md)
to manage paid Wix services for their customers. A package groups one or more product instances together as part of a single transaction for a specific Wix account. Each product instance represents a specific paid service or product, such as a Premium plan or a business tool, that a reseller provisions to a customer.
Product instances can be assigned to a Wix site or left floating at the
account level until they're ready to be used.

With this API, you can:

+ Create, retrieve, and cancel packages of paid Wix services.
+ Assign, unassign, and reassign product instances to sites.
+ Adjust product instance specifications, such as upgrading or downgrading a plan.
+ Query packages to monitor the status of your customers' services.

## Before you begin

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

+ Most resold Wix services don't have an expiration date. They're available to the
  customer until the reseller actively cancels them. Domains are an exception,
  since they're purchased by Wix, the reseller, or the customer through an
  external registrar. Resellers must actively extend access to domains,
  but extending domain access isn't yet possible with Wix's APIs.
+ Some paid Wix services or products can't be resold to customers who don't
  already have access to another product. For example, you can resell domains only to
  Wix sites that have an active Premium plan. You must create a package
  containing the essential product first, before you can create a second
  package with the additional product.
+ When Wix customers purchase specific paid services or products, Wix may offer
  them time-limited free access to a different paid service or product. For
  example, customers get a voucher for a free 1-year domain registration when
  purchasing any Wix Premium plan.
+ Resellers can also offer their customers an additional, associated product. To
  do so, create a package containing the original product first. Then, create a
  second package with the additional product. In this second
  [Create Package](https://dev.wix.com/docs/rest/account-level/resellers/packages-and-product-instances/create-package-v2.md)
  call, pass the instance ID of the original product as `referenceProductInstanceId`.
  This way, Wix doesn't charge you for the additional product.
+ There are currently no webhooks available for the Resellers API.

## Use cases

+ [Set up a customer's site in your team account](https://dev.wix.com/docs/api-reference/account-level/resellers/packages-and-product-instances/sample-flows.md#set-up-a-customers-site-in-your-team-account)
+ [Reassign a paid service to a different site](https://dev.wix.com/docs/api-reference/account-level/resellers/packages-and-product-instances/sample-flows.md#reassign-a-paid-service-to-a-different-site)

## Terminology

+ __Package__: Group of product instances that the reseller offers to a customer
  as part of a single transaction.
+ __Product Instance__: Specific instance of a paid service or product that a
  reseller provisions to one of their customers.
+ __Reference Product Instance__: Product instance that you can use to offer
  your customers time-limited free access to an additional product or service.
  Not all products can be used as reference products. You can use each product
  instance only once as reference product instance.
+ __Floating__: Product instance that hasn't been assigned to a Wix site, but
  only to a Wix account. Customers don't have access to floating instances.
  They or the reseller must assign the instance to a site before it can be used.
+ __Service Type__: Wix service types are groups of related services. For
  example, the service type `Premium Plans` includes both the `Website Plan` and
  `Business & eCommerce Plan` services.
+ __Feature__: Most granular capability or benefit that comes with a Wix service.
+ __Adjust__: Resellers can up- or downgrade a product instance that they're
  offering to a customer. For example, you could upgrade a
  `Business Basic` plan to `Business Unlimited`.
+ __Voucher__: Time-limited benefit for non-Wix products that comes with some
  Wix services.
+ __Site ID__: Unique identifier of a Wix site. See the
  [Sites API](https://dev.wix.com/docs/api-reference/account-level/sites/sites/query-sites.md)
  for more details.

@sdk_package_setup