Documentation Portal

Create GLBE_PARAMS JavaScript variable on the site as follows:

GLBE_PARAMS = {  
                countryCode: "<country_code>", // 2 letters country code selected by the customer  
                currencyCode: "<currency_code>", // 3 letters currency code  
                isExternal: true
              }             

Example:

GLBE_PARAMS = {  countryCode: "CA",    currencyCode: "CAD",   isExternal: true} 

ONLY after GLBE_PARAMS variable is set, call Global-e script available as follows:

Production

Production - https://crossborder-integration.global-e.com/resources/js/app?shop=<myshopify_domain>

QA-INT

https://crossborder-integration-qa-int.bglobale.com/resources/js/app?shop=<myshopify_domain>

Decide on a product tag to indicate a product is non-returnable. For example: nonreturnable or finalsale.

Tag your customizable products with your chosen tag by following the instructions here.

Inform Global-e of the tag you have chosen so that Global-e can configure the same tag in our system.

Customers can now see your non-returnable tag when they view your items and they are prevented from returning the item after purchase.

Add the following script tag to the head element of all storefront pages. Preferably, to the top of the HTML head section.

<script async id="ge-storefront-js" data-mid="<GLOBALE_MERCHANT_IDENTIFIER>" 
 data-store="<GLOBALE_MERCHANT_STORE_IDENTIFIER>" data-env="int" 
 src="https://bglobale.com/Scripts/Merchants/globale.merchant.storefront.js"</script>

Use the following parameter values:

Add listener to geCartAttributes event (sample code provided below). When geCartAttributes event is triggered, use Shopify Storefront API cartAttributesUpdate mutation (https://shopify.dev/docs/api/storefront/2024-07/mutations/cartAttributesUpdate) to update the Shopify cart with the same attributes provided by the geCartAttributes event.

GeCartAttributes event data structure

{
 eventId:string,
  attributes:[
    {key:string, value:string}
  ]
}

Sample event

{
  "eventId": "23lkj4lk32j4"
  "attributes": [
    {
      "key": "key1",
      "value": "value"
    },
    {
      "key": "key2",
      "value": "value"
    }
  ]
}

Sample event handling code

document.addEventListener(
 "geCartAttributes",
 (event) => { 
// use event.detail.attributes to set Shopify cart attributes - i.e. with GraphQL storefront API
https://shopify.dev/docs/api/storefront/2023-07/mutations/cartAttributesUpdate
 },
 false,
);

Example

The storefront attributes script provides the following attributes which need to be updated on the Shopify cart.

This allows Forter to relate the checkout with your cart token, and based on the customer’s activity before the transaction, Forter's fraud analysis is more accurate.

[
    {
        "key": "frtToken",
        "value": "9cc7e27f99084f52803d0369256c4342_1725451213641__UDF43_9ck__tt"
    },
    {
        "key": "isApplePay",
        "value": "false"
    },
    {
        "key": "cartToken",
        "value": "Z2NwLWV1cm9wZS13ZXN0MTowMUo2WUFSUkQxTjk0V0FXNjI5VE1ZQzkxWA"
    },
    {
        "key": "storeType",
        "value": "headless"
    }
]

On window object, set the event message as global variable geMerchantSession.

This ensures that Global-e can read the event in case geMerchantSession is fired before the Global-e script is loaded.

geMerchantSession event data structure

{
  platformCartId: string, //shopify cart token
  cartId: string, //merchant managed cart id, can be same as Shopify cart token if no other card Id used by merchant
  sessionId:string //merchant managed customer session id
}

Sample event

{
  "platformCartId": "234kn234io23j4",
  "cartId": "jkh324kj5h324jk5",
  "sessionId":"nssdfg09usdf0gklm43"
}

Sample event handling code

window.geMerchantSession = {
  "platformCartId": "234kn234io23j4",
    "cartId": "jkh324kj5h324jk5",
  "sessionId":"nssdfg09usdf0gklm43"
}
dispatchEvent(new CustomEvent("geMerchantSession" , {
  bubbles: true,
  detail: window.geMerchantSession
});