Checkout Object


Create and manage an eCommerce checkout

Properties
additionalFeesArray <AdditionalFee>maxItems 100

Additional Fees.


appliedDiscountsArray <AppliedDiscount>Read-only

Applied discounts.


billingInfoBillingInfo

Billing information.


businessLocationIdstringbetaformat GUID

The business location ID associated with the checkout.

To learn more, see the Locations API.


buyerInfoBuyerInfo

Buyer information.


buyerLanguagestringRead-only

Language for communication with the buyer. Defaults to the site language.

For a site that supports multiple languages, this is the language the buyer selected.


buyerNotestringmaxLength 1000

Buyer note left by the customer.


calculationErrorsCalculationErrorsRead-only

Errors when calculating totals.


cartIdstringformat GUID

Cart ID that this checkout was created from. Empty if this checkout wasn't created from a cart.


channelTypestringRead-only

Sales channel that submitted the order.


completedbooleanRead-only

Whether an order was successfully created from this checkout.

For an order to be successful, it must be successfully paid for (unless the total is 0).


conversionCurrencystringRead-onlyformat CURRENCY

The currency selected by the customer during the purchase flow, in three-letter ISO-4217 alphabetic format.

This reflects the customer’s preferred display currency and may differ from the site’s default currency. When no specific currency is selected by the customer, this matches the currency property.


createdByCreatedByRead-only

ID of the checkout's initiator.


createdDatestringRead-onlyformat date-time

Date and time the checkout was created.


currencystringRead-onlyformat CURRENCY

The site’s default currency, in three-letter ISO-4217 alphabetic format. This represents the base currency configured for the site and remains constant regardless of the customer’s currency selection.


customContentReferenceCustomContentReferencebeta

Reference IDs for the app and component providing custom checkout page content.

To access and manage custom checkout page content, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about permission scopes.


customFieldsArray <CustomField>

Custom fields.


customSettingsCustomSettingsimmutable

Additional settings for customization of the checkout process.

Notes:

  • Custom settings can only be set when creating a checkout.
  • To access and manage custom checkout page content, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about permission scopes.

extendedFieldsExtendedFields

Custom field data for the checkout object.

Extended fields must be configured in the app dashboard before they can be accessed with API calls.


externalReferenceExternalReferencebetaimmutable

References to an external app and resource associated with this checkout. Used for integration and tracking across different platforms.


giftCardGiftCardRead-only

Applied gift card details.

Note: Gift cards are supported through the Wix UI, though the service plugin is not currently available. Learn more about Wix Gift Cards.


idstringRead-onlyformat GUID

Checkout ID.


lineItemsArray <LineItem>Read-onlyminItems 1maxItems 300

Line items.

Max: 300 items


membershipOptionsMembershipOptions

Memberships to apply when creating the order.


payAfterFreeTrialPayAfterFreeTrialRead-onlybeta

Payment for subscriptions after free trial period.


payLaterPayLaterRead-only

Remaining amount for the order to be fully paid.


paymentCurrencystringRead-onlybetaformat CURRENCY

The currency used for payment, in three-letter ISO-4217 alphabetic format.

This is determined by the customer's selected currency and the site’s supported payment currencies. If the customer’s selected currency is supported for payment, this matches the conversionCurrency property. If not supported, this falls back to the currency property.


payNowPayNowRead-only

Minimal amount to pay in order to place the order.


priceSummaryPriceSummaryRead-only

Calculated price summary for the checkout.


purchaseFlowIdstringRead-onlyformat GUID

Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.


shippingInfoShippingInfo

Shipping information.


siteLanguagestringRead-only

Site language in which original values are shown.


taxExemptGroupIdstringbetaformat GUID

Tax exempt group ID to use for tax exemptions.


taxIncludedInPricebooleanRead-only

Whether tax is included in line item prices.


taxSummaryTaxSummaryRead-only

Tax summary.


updatedDatestringRead-onlyformat date-time

Date and time the checkout was updated.


violationsArray <Violation>Read-only

List of validation violations raised by the Validations service plugin.


weightUnitstringRead-only

Weight measurement unit. Defaults to a site's weight unit.

Did this help?