Documentation Portal

When a registered customer logs into the Merchant’s webstore before proceeding to Global-e checkout, the Global-e Magento2 Lite extension transfers securely transfer the customer’s details to Global-e checkout, where shipping and billing information will be pre-populated.

Orders placed by logged-in customers through Global-e are assigned to the corresponding account in your merchant store.

You must update your order history pages to show the correct localized prices for your international orders. The prices displayed should show the same currency and prices that the customer paid and sent to your platform via the sendOrderToMerchant request.

This can be achieved by defining separate stores per target country’s currency and configuring the respective countries as “fixed price” on the Global-e side. For example, if a store in Magento has a base currency EUR, it can be used as a fixed price for all (or some) countries having EUR as a default currency.

The fixed price will be used for all products.

Configuration:

It’s possible to manage fixed prices by uploading the Pricebook CSV via the interface provided by the Global-e Magento2 Lite extension in the Magento admin: Catalogue-> Global-e Fixed prices.

To display fixed prices on your site, make sure to enable the Global-e module setting Add data-fp to product attribute automatically. This adds data-fp attributes to products on HP/PLP/PDP/Search.

bin/magento module:enable [-c|--clear-static-content] [-f|--force] [--all] <module-list>

Upload Pricebook

To upload the Pricebook into Magento Admin, please proceed to Catalogue -> Global-E Fixed Prices -> Import/Export prices

Price should have the following columns:

Parameter	Description	State
product_code	Product SKU from Magento	Mandatory
country_code	ISO2 letters country	Optional
currency_code	ISO3 currency mode	Mandatory
price	Fixed price in the specified currency	Mandatory
special_price	Fixed price for the special price	Optional
date_from	The date when the special price is applied	Optional
date_to	The date until the special price is applied	Optional

Fixed prices should be uploaded for configurable and child products

After upload, fixed prices will be stored in the dedicated table created by Global-e in the Magento database: globale_fixed_price table.

The Global-e confirmation page comes from the Global-e platform, not the Magento confirmation page.

To allow merchants to implement conversion tracking for Global-e orders, there are JavaScript events that will be sent from the Global-e checkout iframe to the container page.

The OnCheckoutStepLoaded event is fired when the Global-e checkout is open (in this case no additional data is provided) and also when the confirmation page is showing. In the 2^nd case, the data object with all the order details will be provided. This object can be used by merchants to report events to any platform (GA, GTM, Facebook etc).

To simplify the implementation of conversion tracking, the Global-e Magento2 Lite extension provides 2 configuration fields in the Magento admin panel. Merchants can use these fields to add tracking code (in the form of executable JavaScript) to report the transaction.

The advanced analytics feature allows merchants to track customer activities inside the checkout form and OnClientEvent will be fired on every change inside the form. This can be particularly useful in capturing customer e-mail addresses and implementing abandoned checkout integration. More details about this event can be found here.

Conversion Tracking

1. Global-e checkout is opened in an iframe and this iframe is then reloaded to display the confirmation page to the customer.

2. In order to allow merchant to perform conversion tracking and implement goals in the GA, the Global-e iframe will fire JavaScript events to the container page.

3. As part of the extension, Global-e provides a configuration field in Magento Admin (Stores > Configurations > Services > Global-E Integration Lite > Checkout > JS Code on Success Page) where this event handler can be added.

Configuration (Example)

Add JS Code for successful international orders. These settings can be found under the Global-e Crossborder Checkout or Analytics section depending on the module version.

Add JS Code to the body of the checkout page for successful international orders:

Add JS Cod to the body of the page for successful international orders:

The Global-e Extension for Magento features a logic that determines whether an order should be marked as Backordered during the GetCart request process.

This decision is based on specific criteria:

When both conditions are met, IsBackOrdered = true.

Additionally, a BackOrderMessage is included in the MetaData.

By default, this message is set to "pre-order".

However, you can customize this message can be customized through the configuration settings of the Global‑e module within the Magento Admin panel.

This feature allows for a tailored communication strategy regarding back-ordered items to customers.

To inform Global-e that a product is on pre-order or backorder, include the following fields in your getCheckoutCartInfo response:

Adding a metadata field to getCheckoutCartInfo allows the Global-e design team to display additional details on the checkout page and in transactional emails.

Example:

{
    "productsList": [{
            "ProductCode": "ProductCode",
            "CartItemId": "line 1",
            "Name": "Product Name",
            "NameEnglish": "Product Name",
            "Description": "Description",
            "DescriptionEnglish": "Description",
            "ImageURL": "https://domain/img/imageName.jpg",
            "ImageWidth": "",
            "ImageHeight": "",
            "OriginalListPrice": 100,
            "OriginalSalePrice": 100,
            "OrderedQuantity": 1,
            "IsBackOrdered": true,
            "BackOrderDate": "2023-10-30 11:57:13",
            "MetaData": {
                "Attributes": [{
                        "AttributeKey": "BackOrderMessage",
                        "AttributeValue": "Shipping on 2023-10-30"
                    }
                ]
            }
        }
    ]
}