Checkout Object


Create and manage an eCommerce checkout

Properties
idstringRead-onlyformat GUID

Checkout ID.


lineItemsArray <LineItem>Read-onlyminItems 1maxItems 300

Line items.

Max: 300 items


billingInfoBillingInfo

Billing information.


shippingInfoShippingInfo

Shipping information.


buyerNotestringmaxLength 1000

Buyer note left by the customer.


buyerInfoBuyerInfo

Buyer information.


conversionCurrencystringRead-onlyformat CURRENCY

All converted prices are displayed in this currency in three-letter ISO-4217 alphabetic format.


priceSummaryPriceSummaryRead-only

Calculated price summary for the checkout.


calculationErrorsCalculationErrorsRead-only

Errors when calculating totals.


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.


appliedDiscountsArray <AppliedDiscount>Read-only

Applied discounts.


customFieldsArray <CustomField>

Custom fields.


weightUnitstringRead-only

Weight measurement unit - defaults to site's weight unit.


taxSummaryTaxSummaryRead-only

Tax summary.


currencystringRead-onlyformat CURRENCY

The currency used when submitting the order.


channelTypestringRead-only

Sales channel that submitted the order.

  • "UNSPECIFIED": Unspecified sales channel. This value is not supported.
  • "WEB": A web client.
  • "POS": Point of sale solutions
  • "EBAY": eBay
  • "AMAZON": Amazon
  • "WISH": Wish
  • "WIX_INVOICES": Wix Invoices app in your dashboard
  • "WIX_APP_STORE": Wix Owner app
  • "BACKOFFICE_MERCHANT": Wix merchant backoffice
  • "OTHER_PLATFORM": Other sales platform.

siteLanguagestringRead-only

Site language in which original values are shown.


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.


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).


taxIncludedInPricebooleanRead-only

Whether tax is included in line item prices.


createdByCreatedByRead-only

ID of the checkout's initiator.


createdDatestringRead-onlyformat date-time

Date and time the checkout was created.


updatedDatestringRead-onlyformat date-time

Date and time the checkout was updated.


payNowPayNowRead-only

Minimal amount to pay in order to place the order.


payLaterPayLaterRead-only

Remaining amount for the order to be fully paid.


membershipOptionsMembershipOptions

Memberships to apply when creating the order.


additionalFeesArray <AdditionalFee>maxItems 100

Additional Fees.


cartIdstringformat GUID

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


violationsArray <Violation>Read-only

List of validation violations raised by the Validations service plugin.


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.


purchaseFlowIdstringRead-onlyformat GUID

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


customSettingsCustomSettings

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.

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.

Did this help?