Wix eCommerce: Checkout Page

The following slots and APIs are available when building a plugin for the Checkout Page.

Slots

The following image shows slots in the checkout page, into which users can add plugins.

The slots are represented by the following placement object:

Copy

Provide the following values for each property:

KeyValue
appDefinitionId"1380b703-ce81-ff05-f115-39571d94dfcd"
widgetId"14fd5970-8072-c276-1246-058b79e70c1a"
slotIdID of the slot you want as displayed in the image above.
Supported values:
  • "checkout:header"
  • "checkout:top"
  • "checkout:steps:before"
  • "checkout:summary:before"
  • "checkout:summary:lineItems:after"
  • "checkout:summary:lineItems:after2"
  • "checkout:summary:totalsBreakdown:before"
  • "checkout:summary:after"

For example, for your widget to appear before the totals breakdown in a checkout page use the following object in your configuration:

Copy

Learn more about how to add your plugin to a slot from the dashboard page.

Checkout Plugin API

Use the Checkout plugin API to integrate with the plugin's host.

The API provides data about the current checkout process and lets you define a callback function that is invoked whenever changes are made in the checkout.

Properties

NameTypeDescription
checkoutIdStringThe ID of the current checkout process.
stepIdStringThe ID of the step currently rendered in the checkout page, which can be one of the following:
  • 'contact-details'
  • 'delivery-method'
  • 'payment-and-billing'
  • 'place-order'

Functions

NameTypeDescription
onRefreshCheckout()(refreshCheckoutCallback: () => void) => voidAn event handler that accepts a callback function that is invoked by a widget. The widget should call the function whenever the checkout needs to be refreshed.

Code example

Copy

Checkout plugins usually need to integrate with Wix eCommerce's Checkout APIs, as well as other backend APIs.

In your site plugin or in your app's server code, you may want to perform actions or implement logic that is dependent on the state of the current checkout or related data.

The following Wix APIs may be useful:

Did this help?