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:
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.
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.
The order totals in customer currency are stored in the buyer notes of the order
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.
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
Fulfillment
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.
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.
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.
The following are not supported:
Replacements
Pre-orders
Cart abandonment
Analytics &Market Feeds