Skip to main content

Documentation Portal

Integration

Browsing

GEM Attributes

GEM Attributes have been implemented into some of the UI elements of the store to automate the merchant integration process within the GEM selectors needed in the browsing.

These attributes should be configured in the Global-e Admin.

We cover the following list of attributes:

Cart Settings:

  • data-wix-item-total-price

  • data-wix-line-item-price

  • data-wix-cart-total-price

  • data-wix-line-item-id

  • data-wix-line-full-item-price

  • data-wix-product-compare-price

Shipping Switcher Settings:

The switcher is always located at the “global-e-ce-switcher” element.

Checkout Settings:

  • data-wix-checkout-button

Price selectors:

  • data-wix-price

  • data-wix-original-price

Elements to hide:

  • data-wix-hideable

    Note

    The TS tool is used to manually hide an element that is not preselected with an attribute and which needs to be hidden.

Automatic CatalogueCatalog Update

The initial catalogue catalog should be uploaded manually.

To avoid the need for constantly updating the merchant’s catalogue catalog in the Global-e database, we have added support for CORE’s API SaveProductList which is triggered by the relevant Wix webhooks (listed below) to update any changes the merchant has made on the catalogcatalogue catalog from the platform.

The following fields are sent to Global-e with each update:

  • Name

  • Description

  • Weight

  • ProductCode (from SKU)

  • ProductCodeSecondary (from variant id)

  • ProductGroupCode (from product id)

  • OriginalListPrice (from price)

  • OriginalSalePrice (from discounted price)

  • URL

  • IsVirtual (from product type different than physical)

Cart and Checkout

GetCart

Example:

{
  "CartToken":null,

  "ClientIP":"54.76.161.209",
  "CountryCode":"IL",
  "Culture":{
    "CultureCode":"he",
    "InputDataCultureCode":null,
    "PreferedCultureCode":null
  },
  "Currency":{
    "CurrencyCode":"ILS",
    "OriginalCurrencyCode":"GBP"
  },
  "Discounts":[
    {
      "Name":"10%All2",
      "DiscountCode":"40819d8c-1ad8-46e0-8b86-e3159487fd72",
      "OriginalDiscountValue":6.9,
      "DiscountValue":34.5,
      "ProductCartItemId":null,
      "LocalVATRate":20.000000000000000000000000000,
      "VATRate":20.000000000000000000000000000,
      "DiscountType":1,
      "CouponCode":"15%All2",
      "Description":null,
      "IsFreeShipping":false,
      "CalculationMode":1,
      "DiscountSource":1,
      "BenefitExternalId":null
    }],
  "FreeShipping":null,
  "HubId":null,
  "LocalShippingOptions":[
    {
      "Carrier":"globaleintegration_standard",
      "CarrierName":"globaleintegration_standard",
      "CarrierTitle":"globaleintegration_standard",
      "Code":"globaleintegration_standard",
      "IsPreferred":true,
      "Method":"globaleintegration_standard",
      "MethodDescription":"globaleintegration_standard",
      "MethodTitle":"globaleintegration_standard",
      "Price":0.0
    }],
  "LoyaltyData":null,
  "LoyaltyPoints":null,
  "Benefits":null,
  "MerchantCartHash":"EA9BFCB402065D2B93118B4D0F49203C",
  "MerchantCartToken":"e35774a9-7284-4296-b6c4-9ed1f14e1b03",
  "PaymentInstallments":null,
  "PriceModification":{
    "IncludeVAT":null,
    "PriceCoefficientRate":1.000000,
    "RoundingRuleId":11220
  },
  "Products":[
    {
      "ProductCode":"0006",
      "ProductCodeSecondary":null,
      "OrderedQuantity":1,
      "OriginalSalePrice":22.0,
      "OriginalListPrice":22.0,
      "OriginalMerchantPriceForDuties":null,
      "OriginalMerchantUnitSalePrice":22.0,
      "ListPrice":110.0000,
      "SalePrice":110.0000,
      "SalePriceBeforeRounding":107.848145823000000000,
      "MerchantPriceForDuties":null,
      "CartItemId":"00000000-0000-0000-0000-000000000001",
      "Name":"I'm a product",
      "ImageURL":"https://static.wixstatic.com/media/c837a6_dff384ebdb954fd9a5903b028ce213c7~mv2.jpg",
      "IsFixedPrice":false,
      "VATRateType":{
        "VATRateTypeCode":"vatRateType_GB_20.0",
        "Name":"vatRateType_GB_20.0",
        "Rate":20.0,
        "InternalVATRateTypeId":0
      },
      "LocalVATRateType":{
        "VATRateTypeCode":"vatRateType_GB_20.0",
        "Name":"vatRateType_GB_20.0",
        "Rate":20.0,
        "InternalVATRateTypeId":0
      },
      "Description":null,
      "ProductVatRate":null,
      "Keywords":null,
      "URL":null,
      "OriginCountryCode":"",
      "IsBlockedForGlobalE":false,
      "Attributes":[
      ],
      "ProductGroupCode":"1a2d7e83-4bef-31d5-09e1-3326ee271c09",
      "ProductGroupCodeSecondary":null,
      "ParentCartItemId":null,
      "CartItemOptionId":null,
      "ProductClass":null,
      "Weight":null,
      "NameEnglish":"",
      "DescriptionEnglish":"",
      "AttributesEnglish":[
      ],
      "Categories":[
      ],
      "Brand":null,
      "IsVirtual":false,
      "IsBundle":false,
      "BundleId":null,
      "IsBackOrdered":false,
      "BackOrderDate":null,
      "PriceCoefficientRate":null,
      "MetaData":{
        "Attributes":[
          {
            "AttributeKey":"CatalogItemId",
            "AttributeValue":"1a2d7e83-4bef-31d5-09e1-3326ee271c09"
          },
          {
            "AttributeKey":"AppId",
            "AttributeValue":"215238eb-22a5-4c36-9e7b-e7c08025e04e"
          },
          {
            "AttributeKey":"Options",
            "AttributeValue":"{\"variantId\":\"00000000-0000-0000-0000-000000000000\",\"options\":{}}"
          },
          {
            "AttributeKey":"ProductName",
            "AttributeValue":"I'm a product"
          }]
      },
      "DiscountPercentage":null,
      "IsGiftCard":false,
      "GiftCardId":null,
      "GenericHSCode":null
    },
    {
      "ProductCode":"0014",
      "ProductCodeSecondary":null,
      "OrderedQuantity":1,
      "OriginalSalePrice":24.0,
      "OriginalListPrice":24.0,
      "OriginalMerchantPriceForDuties":null,
      "OriginalMerchantUnitSalePrice":24.0,
      "ListPrice":120.0000,
      "SalePrice":120.0000,
      "SalePriceBeforeRounding":117.652522716000000000,
      "MerchantPriceForDuties":null,
      "CartItemId":"00000000-0000-0000-0000-000000000002",
      "Name":"I'm a product",
      "ImageURL":"https://static.wixstatic.com/media/c837a6_8ea5cc0a06664ef6a3c1cf64e1cb5a27~mv2.jpg",
      "IsFixedPrice":false,
      "VATRateType":{
        "VATRateTypeCode":"vatRateType_GB_20.0",
        "Name":"vatRateType_GB_20.0",
        "Rate":20.0,
        "InternalVATRateTypeId":0
      },
      "LocalVATRateType":{
        "VATRateTypeCode":"vatRateType_GB_20.0",
        "Name":"vatRateType_GB_20.0",
        "Rate":20.0,
        "InternalVATRateTypeId":0
      },
      "Description":null,
      "ProductVatRate":null,
      "Keywords":null,
      "URL":null,
      "OriginCountryCode":"",
      "IsBlockedForGlobalE":false,
      "Attributes":[
      ],
      "ProductGroupCode":"bc1da057-a5df-4b2f-9f8e-b37036b09524",
      "ProductGroupCodeSecondary":null,
      "ParentCartItemId":null,
      "CartItemOptionId":null,
      "ProductClass":null,
      "Weight":null,
      "NameEnglish":"",
      "DescriptionEnglish":"",
      "AttributesEnglish":[
      ],
      "Categories":[
      ],
      "Brand":null,
      "IsVirtual":false,
      "IsBundle":false,
      "BundleId":null,
      "IsBackOrdered":false,
      "BackOrderDate":null,
      "PriceCoefficientRate":null,
      "MetaData":{
        "Attributes":[
          {
            "AttributeKey":"CatalogItemId",
            "AttributeValue":"bc1da057-a5df-4b2f-9f8e-b37036b09524"
          },
          {
            "AttributeKey":"AppId",
            "AttributeValue":"215238eb-22a5-4c36-9e7b-e7c08025e04e"
          },
          {
            "AttributeKey":"Options",
            "AttributeValue":"{\"variantId\":\"00000000-0000-0000-0000-000000000000\",\"options\":{}}"
          },
          {
            "AttributeKey":"ProductName",
            "AttributeValue":"I'm a product"
          }]
      },
      "DiscountPercentage":null,
      "IsGiftCard":false,
      "GiftCardId":null,
      "GenericHSCode":null
    }],
  "rateData":"ZEN99zm71Xg2IYEeJVY5bQcKOSee8Xg98MCdPj2%2bQSU%3d",
  "UrlParameters":null,
  "UseIpv6":false,
  "UserDetails":{
    "AddressDetails":[
    ],
    "UserId":null,
    "IsB2B":null
  },
  "VATRegistration":null,
  "VoucherData":null,
  "WebStoreCode":null,
  "WebStoreInstanceCode":null,
  "CartId":null,
  "IsFreeShipping":null,
  "FreeShippingCouponCode":null,
  "AllowMailsFromMerchant":false,
  "AllowSMSFromMerchant":false,
  "CookieConsent":0,
  "IsMOTO":0
}

SendCart

Example:

{
  "id":"e35774a9-7284-4296-b6c4-9ed1f14e1b03",

  "userDetails":null,
  "productsList":[
    {
      "productCode":"0006",
      "productCodeSecondary":null,
      "orderedQuantity":1,
      "originalSalePrice":22,
      "originalListPrice":22,
      "originalMerchantPriceForDuties":null,
      "originalMerchantUnitSalePrice":0,
      "listPrice":0,
      "salePrice":0,
      "salePriceBeforeRounding":0,
      "merchantPriceForDuties":null,
      "cartItemId":"00000000-0000-0000-0000-000000000001",
      "name":"I'm a product",
      "imageURL":"https://static.wixstatic.com/media/c837a6_dff384ebdb954fd9a5903b028ce213c7~mv2.jpg",
      "imageWidth":"4213",
      "imageHeight":"5197",
      "isFixedPrice":false,
      "vatRateType":null,
      "localVATRateType":null,
      "description":null,
      "productVatRate":null,
      "keywords":null,
      "url":"https://www.m123m123.shop/product-page/im-a-product-6",
      "originCountryCode":null,
      "isBlockedForGlobalE":false,
      "attributes":null,
      "productGroupCode":"1a2d7e83-4bef-31d5-09e1-3326ee271c09",
      "parentCartItemId":null,
      "cartItemOptionId":null,
      "productClass":null,
      "weight":0.00000,
      "nameEnglish":null,
      "descriptionEnglish":null,
      "attributesEnglish":null,
      "categories":null,
      "brand":null,
      "isVirtual":false,
      "isBundle":false,
      "bundleId":null,
      "isBackOrdered":false,
      "backOrderDate":null,
      "priceCoefficientRate":null,
      "metaData":{
        "attributes":[
          {
            "attributeKey":"CatalogItemId",
            "attributeValue":"1a2d7e83-4bef-31d5-09e1-3326ee271c09"
          },
          {
            "attributeKey":"AppId",
            "attributeValue":"215238eb-22a5-4c36-9e7b-e7c08025e04e"
          },
          {
            "attributeKey":"Options",
            "attributeValue":"{\"variantId\":\"00000000-0000-0000-0000-000000000000\",\"options\":{}}"
          },
          {
            "attributeKey":"ProductName",
            "attributeValue":"I'm a product"
          }]
      },
      "discountPercentage":null,
      "isGiftCard":false,
      "giftCardId":null,
      "genericHSCode":null
    },
    {
      "productCode":"0014",
      "productCodeSecondary":null,
      "orderedQuantity":1,
      "originalSalePrice":24,
      "originalListPrice":24,
      "originalMerchantPriceForDuties":null,
      "originalMerchantUnitSalePrice":0,
      "listPrice":0,
      "salePrice":0,
      "salePriceBeforeRounding":0,
      "merchantPriceForDuties":null,
      "cartItemId":"00000000-0000-0000-0000-000000000002",
      "name":"I'm a product",
      "imageURL":"https://static.wixstatic.com/media/c837a6_8ea5cc0a06664ef6a3c1cf64e1cb5a27~mv2.jpg",
      "imageWidth":"4213",
      "imageHeight":"5197",
      "isFixedPrice":false,
      "vatRateType":null,
      "localVATRateType":null,
      "description":null,
      "productVatRate":null,
      "keywords":null,
      "url":"https://www.m123m123.shop/product-page/im-a-product-14",
      "originCountryCode":null,
      "isBlockedForGlobalE":false,
      "attributes":null,
      "productGroupCode":"bc1da057-a5df-4b2f-9f8e-b37036b09524",
      "parentCartItemId":null,
      "cartItemOptionId":null,
      "productClass":null,
      "weight":0.00000,
      "nameEnglish":null,
      "descriptionEnglish":null,
      "attributesEnglish":null,
      "categories":null,
      "brand":null,
      "isVirtual":false,
      "isBundle":false,
      "bundleId":null,
      "isBackOrdered":false,
      "backOrderDate":null,
      "priceCoefficientRate":null,
      "metaData":{
        "attributes":[
          {
            "attributeKey":"CatalogItemId",
            "attributeValue":"bc1da057-a5df-4b2f-9f8e-b37036b09524"
          },
          {
            "attributeKey":"AppId",
            "attributeValue":"215238eb-22a5-4c36-9e7b-e7c08025e04e"
          },
          {
            "attributeKey":"Options",
            "attributeValue":"{\"variantId\":\"00000000-0000-0000-0000-000000000000\",\"options\":{}}"
          },
          {
            "attributeKey":"ProductName",
            "attributeValue":"I'm a product"
          }]
      },
      "discountPercentage":null,
      "isGiftCard":false,
      "giftCardId":null,
      "genericHSCode":null
    }],
  "discountsList":[
    {
      "originalDiscountValue":"6.9",
      "couponCode":"15%All2",
      "name":"10%All2",
      "discountType":1,
      "discountValue":0,
      "calculationMode":1,
      "productCartItemId":null,
      "discountCode":"40819d8c-1ad8-46e0-8b86-e3159487fd72",
      "isFreeShipping":null
    }],
  "merchantCartHash":null
}

Checkout

When the shopper adds items to the cart and clicks the checkout button, the extension redirects from the native environment to the Global-e checkout. The Global-e Application implements a Global-e API method that uses the Platform API to load the contents of the user's cart and pass it securely to the Global-e checkout by means of a server-to-server API call.

Clear Cart

To clear the cart, once an order has been placed on the Global-e checkout, we use Wix’s API “Mark checkout as completed” to inform of the order creation of a cart and as a result clear the cart in the front-end and back-end of the store.

Stock Validation

To prevent inventory issues such as out-of-stock items in Global-e orders, we conduct a stock validation call before processing new orders. Each item in the cart is validated and checked to ensure it is in stock before creating the order in Global-e. When there is an item with missing stock, it is communicated to the consumer in a popup as follows:

wix_stock_validation.png

This functionality has been implemented in case we may want to activate additional logic beyond Stock Validation at the moment the customer places the order.

For this validation we use Wix’s APIs Create Checkout and Get Checkout.

Cart Discount

Discounts in this integration are currently only supported from the cart. The merchant can use all of the available online discounts the platform offers. These include:

  • Coupons (Cart & Item level)

    • $ Discount: Offer a fixed price discount (e.g. $10 off).

    • % Discount: Offer a discount as a percentage (e.g. 20% off) The discount could be 100% on the item.

    • Free Shipping: Reward customers with free shipping.

    • Sale Price: Offer products at a specific price (e.g. Buy t-shirts for only $12).

    • Buy X get Y

  • Automatic Discounts (Item level)

    • Percentage off (e.g. 20% off).

    • Amount off (e.g. $20 off).

    • Sale price (e.g. all hats are just $20).

Order Flow

Order Creation

After an order is completed in the Global-e checkout the order information is sent to the WIX platform so you can review your Global-e orders from your store's back-office.

Wix’s API Create Order is used to support order creation in WIX’s back-office after the required data of the orders is received through the SOTM API.

Note: The main currency stored and displayed on WIX’s back-office is the merchant reconciliation currency. Only the product reconciliation price is reflected in Wix.

wix_order_example.png

Once the order is created in the platform you can find it in the list of orders in the back office.

Order details in the back office

  • Shipping and Taxes values are not stored or displayed on the platform.

  • The order is marked as a Global-e order and displays a Global-e order ID. globale_order_id.png

  • The order totals in customer currency are stored in the buyer notes of the order

    wix_order_buyer_notes.png

Payment Verification

In order to successfully complete the update of an order in WIX back-office, we change the payment status of the order from UNPAID to PAID, once the fraud check on our end is completed.

wix_payment_info_unpaid.png
wix_payment_info_paid.png

To complete this update, use Global-e's PerformPayment API and communicate with Wix’s end-point Bulk Update Payment Statuses.

OrderFulfilmentFulfillment

Since the fulfilmentfulfillment process occurs on the Global- side, we notify Wix and create the fulfilmentfulfillment of the parcel so that the order status is synced to the actual fulfilmentfulfillment status. Once a fulfilmentfulfillment is done in the Global-e Admin, Wix is notified and updated with the tracking number and the tracking URL of the parcel. This number and URL appear under the status of each parcel.

Partial fulfilmentfulfillment

wix_partial_fulfilment.png

Fulfillment

wix_order_fulfilment.png

To create fulfilmentfulfillment for a parcel in Wix we use Global-e's API Update Parcel Dispatch to send the relevant order information to Wix and communicate with the end-point Create FulfilmentFulfillment

Order cancelation

Cancelations are managed through the Global-e Merchant admin. Users can cancel orders, select the reason for cancelation, and automatically create a refund once the order is canceled.

Once the order is canceled, the order status is updated in Wix’s back office so you can see the actual status of the orders.

wix_order_status.png

When an order is canceled, Wix is notified through Global-e's Update Order Status API and Wix’s end-point Cancel Order.

Order refund

Refunds are also managed through the Global-e Merchant admin. There you can create full and partial refunds.

To keep track of the payment status of an order from Wix’s back-office, Global-e notifies the platform each time a new refund is created.

wix_refund_example.png

The only refund values that are stored and displayed on the platform are for the line items and the discounts.

The notification and status updates are completed using Global-e's Notify Order Refund API and communication with Wix’s end-point Add Refund.

The items will be restocked.

Returns

If you support returns via Global‑e, the shopper can use the Returns Portal to return goods or a dedicated merchant role can use the Merchant Portal to support the shopper.

For more information on the Returns Portal see Returns Portal.Global-e Returns Portal

The following are not supported:

  • Replacements

  • Pre-orders

  • Cart abandonment

  • Analytics &Market Feeds