createPackageV2( )


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Creates a package of product instances.

You must pass the relevant Wix account ID in the header of the call. In the DIY flow, we recommend to pass the customer's sub-account ID instead of your main reseller account ID.

You may also pass a Wix site ID for each product in the body of the call. If you omit the site ID, a floating product instance is created.

When Wix customers purchase a specific paid service or product, Wix may offer them time-limited free access to a different product. For example, customers get a voucher for a free 1-year domain registration when purchasing any Wix Premium plan. If you want to offer your customers the same benefit, create a package containing the original product first. Then, create a second package with the additional product. In the second Create Package call, pass the instance ID of the original product as referenceProductInstanceId. This way, Wix doesn't charge you for the additional product. Make sure that the status of the referenced product is either "PENDING" or "ACTIVE". Note that you can use each product instance only a single time as reference instance.

You need to pass a countryCode to specify where customers can claim vouchers that may come with a product. Contact the Wix B2B sales team to get information about vouchers and supported locations.

Important: This call requires an account level API key and cannot be authenticated with the standard authorization header.

Method Declaration
Copy
Method Parameters
optionsCreatePackageV2Options
Returns
Return Type:Promise<CreatePackageResponse>
Did this help?