Skip to main content

Documentation Portal

Storefront Configuration

This page describes the following elements:

Global-e Module Javascript

Below is a suggested way of loading the Bespoke JavaScript library asynchronously on your site:

Integration Environment

<script id="globaleScript">
(function () {
var s = document.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = '//intgepi.bglobale.com/includes/js/{merchant id}';
document.getElementsByTagName('head')[0].appendChild(s);
})();
</script>

Production Environment

<script id="globaleScript">
(function () {
var s = document.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = '//gepi.global-e.com/includes/js/{merchant id}';
document.getElementsByTagName('head')[0].appendChild(s);
})();
</script>

The above snippets will ensure that the Bespoke JavaScript module will load asynchronously and not block your current page rendering.

Note

Replace {merchant id} at the end of the URL with the merchant ID provided to you by Global-e.

The Global-e Module CSS

You must place the Bespoke CSS on your site’s header.

The following example is the Bespoke CSS you must use in your Integration environment:

<link id="GEPIStyles" rel="stylesheet" href="//intgepi.bglobale.com/includes/css/{merchant id}" />

The following example is the Bespoke CSS you must use in your Production environment:

<link id="GEPIStyles" rel="stylesheet" href="//gepi.global-e.com/includes/css/{merchant id}" />

Note

Replace {merchant id} at the end of the URL with the merchant ID that Global-e gave you.

Mandatory Developments

The following table shows the mandatory developments:

Feature

Description

Pricelist

You must be able to retrieve the country from the Global-e Module cookie to use the relevant pricelist on the front-end

My account currency conversion

The following parameters are required to correctly convert currencies in the My Account or My Orders sections:

  • Customer ID: dedicated cookie

  • Global-e order ID: in the Document Object Model (DOM) of the relevant pages in the section

Client analytics

See the GEM client snippet.

Google Shopping feed

See the Marketing Feeds and Tax/Shipping Rates.

Cookies

The following cookies are required:

  • New cookie: Session token - The session token taken from Centra. Global-e needs the merchant's DTC plugin for identifying this token.

  • New cookie: Customer ID - Global-e needs a cookie to hold the customer ID in Centra.

Browsing

This section describes Centra's browsing elements.

Global-e Browsing Elements

Global-e supports the following browsing elements:

  • Welcome pop-up

  • Country switcher

  • Free shipping banner

For more information, see Site Customization.

Global-e Storefront Attributes

The Global-e storefront attributes are described on the Storefront Attributes page.

Calculating Prices

Global-e supports calculating both dynamic prices and fixed prices.

Dynamic price calculations are based on pricelists created by merchants using Centra's back-office.

You must use this set of configurations to properly support price conversions:

  • All Global-e markets must be assigned to a pricelist. Global-e automatically assigns Centra's default pricelist for unassigned markets.

  • All pricelists used for Global-e markets must be set in your base currency.

Fixed price calculations are supported per country and is based on Centra's native pricelist creation.

You must follow these rules when setting their fixed prices:

  • Each country's fixed prices must be set with its respective currency as configured by Global-e.

  • The geolocation must be set according to the country's fixed prices.

  • All fixed prices must be set on the country's catalog.

Products

Product Restrictions

As with other Global-e Module (GEM) integrations, we support merchants restricting purchases of checkout items to specific countries based on regulations or commercial restrictions. We support restrictions at the Checkout level.

For more information on product restrictions, see. Restricted Products

Pre-Ordering Items

You can sell pre-order items if needed, and can enable them by selecting the stock section checkbox for the required item.

Merchants must pass the pre-order attribute indication for the relevant products.

Note the following:

  • We do not validate stock in the order stock validation phase for items identified as pre-order.

  • Items identified as pre-order must be marked in Centra as PreOrder. Items not marked as PreOrder will be a Failed Transfer to Merchant (FTM). Merchants must mark pre-order items in both Global-e and Centra.

Product Attributes

Global-e supports the following product attributes:

  • Product name

  • HS code

  • Country of origin

  • Weight

  • Brand

  • Description

Note

We do not support custom fields.

Cart

Sending Language to Checkout

Global-e supports sending language to Checkout with GEM capabilities. For more information, see Global-e Checkout Language.

Clearing Your Cart

Global-e supports clearing your cart with GEM capabilities. For more information, see Clearing your Cart.

Applying Discounts

Centra supports several discount types that may include multiple rules and dependencies. You can specify these conditions while creating both vouchers and campaigns.

Checkout

Stock Validation

When you place an order in Checkout, the Global-e plug-in runs a stock validation based on Centra's stock to see if the item is available. This process does not occur for pre-order items.

Discounts

The supported discount types described in Applying Discounts apply to the Checkout capabilities as well. Only voucher code discounts are available, and consumers use these codes during Checkout, and discounts are applied when the checkout is complete.