Preview Wix plan change

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Shows what an upgrade with Change Wix plan would charge, without changing or charging anything. Send the same new_product_id and period_unit you plan to send there. Only the workspace owner can preview.

Only upgrades can be previewed. A downgrade returns 400, because it charges nothing now and takes effect at the end of the billing period.

This works only for workspaces billed through Wix. For a Stripe-billed workspace, use Preview plan change. Wix billing is still rolling out, so this can return 404 for your account.

The base rate limit is 20 requests per minute per user. See Rate limits for the multiplier your plan gets.

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

post/api/billing/dynamic-offering/preview-subscription

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/billing/dynamic-offering/preview-subscription
  • Auth
    HTTP bearer

Request body

new_product_idstring required

Wix product of the plan to preview, from wix_product_id in List plans.

period_unit'MONTH' | 'YEAR' required

Billing period of the new plan: MONTH or YEAR.

Example request

{
  "new_product_id": "5f0c7a2e-3b91-4d6a-9e0f-2c8b1d4a7e63",
  "period_unit": "MONTH"
}

Response

What the upgrade costs now and at renewal.

prorated_amount_duenumber required

Amount Change Wix plan charges now for this upgrade, in major units of currency (dollars, not cents).

currencystring required

Lowercase three-letter currency code of both amounts.

recurring_amountnumber required

What the new plan costs at each renewal, in major units of currency.

next_billing_dateinteger required

When the new plan next renews, as a Unix timestamp in seconds.

billing_interval'month' | 'year' required

How often the new plan renews: month or year.

card_last4string nullable required

Last four digits of the card that would be charged, or the wallet's name for a wallet such as Apple Pay. null when Wix doesn't report one.

Example response

{
  "prorated_amount_due": 18.5,
  "currency": "usd",
  "recurring_amount": 50,
  "next_billing_date": 1763971200,
  "billing_interval": "month",
  "card_last4": "4242"
}

Changes