> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.bglobale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

<Note>
  **This section does not apply to Shopify's Checkout Extensibility. For more information and support, contact your Project Manager.**
</Note>

<Warning>
  The integration of the CrossBorder solution requires that you install, enable, and configure **both**, the CrossBorder App and the Global‑e Payment app for the solution to be functional.

  Note that these applications are interdependent and **cannot** be implemented or used separately.
</Warning>

The following figure illustrates the installation of the Global‑e Application for Shopify.

<Frame>
  <img src="https://mintcdn.com/globale-enterprise/4kLlWOCKssl9AEZa/images/uuid-dd9f2baa-1820-87ac-4591-97049fff1e5b.png?fit=max&auto=format&n=4kLlWOCKssl9AEZa&q=85&s=2acbd80324fc49408c3a39aaea5ba253" width="1416" height="815" data-path="images/uuid-dd9f2baa-1820-87ac-4591-97049fff1e5b.png" />
</Frame>

For details, see:

* [Install the CrossBorder App](/installation-271802#install-the-crossborder-app)
* [Install the Global‑e Payments App](/installation-271802#install-the-global-e-payments-app)

## Install the CrossBorder App

<Warning>
  The Global‑e CrossBorder app works in tandem with the Global‑e Payments; this app cannot be implemented or used independently.
</Warning>

The following sections describe the steps needed to perform the **initial** installation and configuration of the Global‑e CrossBorder Application.

**To install the Global-e CrossBorder application:**

1. Click the Global‑e CrossBorder installation link.

   **STG (Staging)** - Sandbox Example:

   [https://apps.shopify.com/global-e-crossborder-int](https://apps.shopify.com/global-e-crossborder-int)

   **PROD (Production)** - (Example):

   Run the installation on the subdomain Myshopify.com.

   [https://apps.shopify.com/global-e-crossborder](https://apps.shopify.com/global-e-crossborder)

   The installation screen opens showing the Global‑e CrossBorder application icon.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-a822d21b-5644-263f-fd8c-7303d17132ba.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=6789aac769524c4a873410050b1774eb" width="860" height="1331" data-path="images/uuid-a822d21b-5644-263f-fd8c-7303d17132ba.png" />
   </Frame>
2.
3. Click **Install app**.

   A screen opens showing Setup Instructions and Account Settings.

   <Warning>
     **AT THIS STAGE, DO NOT TOGGLE THE GLOBAL-E ENABLED BUTTON.**
   </Warning>

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/X_jditTJssq_GTcj/images/uuid-76d726d7-9b45-5956-626d-981abb38ac7a.png?fit=max&auto=format&n=X_jditTJssq_GTcj&q=85&s=6a84225c214a14a2e00a5e300a386c18" width="980" height="930" data-path="images/uuid-76d726d7-9b45-5956-626d-981abb38ac7a.png" />
   </Frame>

**To set up your account and enable the CrossBorder App:**

1. Make sure you have your Merchant ID and your Merchant GUID.

   <Note>
     If you are unable to retrieve your merchant credentials, contact your Global‑e Customer Success Manager.
   </Note>
2. Under Account Settings, enter your account information as detailed below, then click **Save**.

   | Account Information | Description                                                                                                                                                                                                                    |
   | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | Merchant ID         | Your Merchant Account ID, as recorded on the Global-e Merchant Portal. Example: 899                                                                                                                                            |
   | Merchant GUID       | The private key of your Merchant Account ID on the Global-e Merchant Portal.Example: F978DFEB-FF8C-4EE1-BFDA-68FB1B78E217**Note:** Currently, Global‑e does not support multiple stores under the same Global‑e Merchant GUID. |

   After completing your account setup:

   1. Notify your Global‑e Integration Manager that your account setup is complete.

      Global‑e can now prepare your merchant environment, which includes uploading your catalogue, configuring shipping methods, and more.
   2. Wait for Global-e to request that you toggle Global-e enabled. (This button is disabled by default and should only be enabled upon Global-e's confirmation).
3. Upon Global-e request, toggle **Global-e Enabled**, then click **Save**.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-b4d87fed-4182-e255-b819-b5d5af513b41.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=be6be7613a18a3616126b6db9abed9d7" width="663" height="238" data-path="images/uuid-b4d87fed-4182-e255-b819-b5d5af513b41.png" />
   </Frame>

   The CrossBorder app is now enabled.

   Once enabled, Global‑e adds the shipping zones (for countries operated by Global‑e) and the carrier service to your store and adds the Global‑e JavaScript on each page of your site, including on the Checkout page. See [Global‑e JavaScript](/installation-271802#global-e-javascript-271802).

   The Configuration screen shows that your Global‑e account configuration (Step 1) is complete. For more information on the Configuration screen, see section [Install the Global‑e Payments App](/installation-271802#install-the-global-e-payments-app).

   <Warning>
     The CrossBorder app **MUST** be enabled before you can enable the Payment app.
   </Warning>

### Global‑e JavaScript

Global‑e adds the JavaScript files automatically to all the pages of your website by the means of the Shopify Script Tag API.

**Global‑e JavaScript main functionality:**

* Restricted products
* Handles the replacement flow
* Adds the marketing banner
* Supports the payment flow on the checkout page.

## Install the Global‑e Payments App

The Global‑e Payments App enables Global‑e to process international payments on your behalf.

<Warning>
  The Global‑e Payments App works in tandem with the Global‑e CrossBorder app and cannot be implemented or used independently.
</Warning>

The following sections describe the steps required to perform the **initial** installation and configuration of the Global‑e Payments.

**To install Global-e Payments:**

1. Click the Global‑e Payments installation link.

   **STG** (Staging) - sandbox:

   [https://apps.shopify.com/global-e-onsite-payments-int](https://apps.shopify.com/global-e-onsite-payments-int)

   **PROD** (Production - example:

   Run the installation on the subdomain Myshopify.com.

   [https://apps.shopify.com/global-e-onsite-payments](https://apps.shopify.com/global-e-onsite-payments)

   The installation screen opens showing the Global‑e Payment icon.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/j_QcUA5HG17m29tL/images/uuid-fdb8e783-cb29-6385-c09b-47a761b6074a.png?fit=max&auto=format&n=j_QcUA5HG17m29tL&q=85&s=689ae6d758e6f53f76da5cea74c284ac" width="832" height="566" data-path="images/uuid-fdb8e783-cb29-6385-c09b-47a761b6074a.png" />
   </Frame>
2. Click **Install app** (at the bottom of the installation screen).

   The Global‑e Payments App installation is complete, and the Configuration page opens.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/vhiwVFSofQQTfWIF/images/uuid-9d13bafa-b197-d40a-4d3a-28e75f1d6105.png?fit=max&auto=format&n=vhiwVFSofQQTfWIF&q=85&s=03c43344adcf2528c4b39f2657772caf" width="370" height="394" data-path="images/uuid-9d13bafa-b197-d40a-4d3a-28e75f1d6105.png" />
   </Frame>
3. Click **Enable app** to enable the Global‑e Payments app.

   Note that you can only perform this step if the CrossBorder app has been enabled (1), as detailed in the [CrossBorder App installation and configuration](/installation-271802#install-the-crossborder-app) section.
4. To Activate Global-e Payments, click **Open payment gateway settings.**

   The Payment Methods screen opens, featuring a partial list of payments methods supported by Global-e.

   <Note>
     In the Payment Methods screen:

     * The checkboxes in front of the payment methods are not functional.

       Selecting or clearing them has no impact on the payment methods displayed on the checkout page.
     * This screen features only a partial list of Payment Methods supported by Global-e.
     * Test mode is not available when using the Global‑e Payments app in the Production store. You can only test payments in the sandbox (staging environment).
   </Note>

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/-95KX8vS1vYAnafZ/images/uuid-4d40e0c7-129e-421a-0c95-566758400eba.png?fit=max&auto=format&n=-95KX8vS1vYAnafZ&q=85&s=8daac51d9e3dc69191f9eae03fa737cd" width="918" height="798" data-path="images/uuid-4d40e0c7-129e-421a-0c95-566758400eba.png" />
   </Frame>
5. Click **Activate Global‑e Payment**.

   Activating Global‑e Payments enables the Payment Methods supported by Global‑e in Shopify.

   The Global‑e CrossBorder solution is now set. Global‑e can now manage your international orders and process payments on your behalf.

## Check the Installation

You can view the Global-e CrossBorder App installation listed with other apps previously installed.

**To view the installation:**

* In your Shopify admin, click on **> Apps**.

  <Frame>
    <img src="https://mintcdn.com/globale-enterprise/4kLlWOCKssl9AEZa/images/uuid-c84ea7a5-5212-a8cc-281d-e325010b230f.png?fit=max&auto=format&n=4kLlWOCKssl9AEZa&q=85&s=b9bdbc50b9db5bde19a267724ee79bd2" width="1645" height="610" data-path="images/uuid-c84ea7a5-5212-a8cc-281d-e325010b230f.png" />
  </Frame>

  A window opens with a list of all the installed apps.

## Export your Catalogue

Global-e uses your catalogue to perform the product classification.

**To export your product catalogue
from your Shopify Production site:**

1. Log in to your Shopify Production site.
2. Go to **Products**.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/X_jditTJssq_GTcj/images/uuid-73a07a30-5271-6ef1-496a-0deea791127a.jpg?fit=max&auto=format&n=X_jditTJssq_GTcj&q=85&s=ac00a30a94068fbd2138a4e430698a05" width="1365" height="395" data-path="images/uuid-73a07a30-5271-6ef1-496a-0deea791127a.jpg" />
   </Frame>
3. Click **Export**.

   The Export products dialogue box opens.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/-95KX8vS1vYAnafZ/images/uuid-59dcfa27-e734-93ea-ea62-c3e9267b6d0e.jpg?fit=max&auto=format&n=-95KX8vS1vYAnafZ&q=85&s=dec7ef8c63b9683db39a72a648d69b98" width="866" height="550" data-path="images/uuid-59dcfa27-e734-93ea-ea62-c3e9267b6d0e.jpg" />
   </Frame>
4. Select **All products** and **Plain CSV file**.
5. Click **Export Products**.

   A CSV file containing your product catalogue is downloaded.
6. Zip the CSV file and email it to your Global-e Project Manager and to your Global-e Team.

## Migrating to Shopify Checkout Extensibility

Shopify’s new Checkout Extensibility makes it easier for Merchants to customize the Checkout using extensions and apps.

Merchants with a sandbox can choose to test out the Checkout Extensibility within the sandbox and then proceed with the migration in the live store. If you don't have a sandbox or prefer not to use it, you can migrate to the Checkout Extensibility directly in your live store.

### Merchants on Shopify Plus Plan

Follow the steps below to transition to Checkout Extensibility:

1. Provide Global-e with the URL, password, and permissions to your sandbox and live store. If you don't have, or prefer not to use, a sandbox, provide the details only for the live store.

   Global-e updates your settings and installs the on-site payment application.

   Note: If requested, you may need to provide Global-e with the permissions to install the application.
2. After 1-2 days, when the **Create Draft Checkout**option becomes available:

   1. Go to Shopify > Settings > Checkout> Checkout customization.
   2. Click **Create draft checkout.**

      <Frame>
        <img src="https://mintcdn.com/globale-enterprise/X_jditTJssq_GTcj/images/uuid-5d6ab2cc-30b9-2fda-bf0a-3026b73e8850.png?fit=max&auto=format&n=X_jditTJssq_GTcj&q=85&s=ea730dcad86261e96275708318f9ef3c" width="2156" height="1064" data-path="images/uuid-5d6ab2cc-30b9-2fda-bf0a-3026b73e8850.png" />
      </Frame>
3. Add your extensions to the checkout, as per the Shopify instructions: [Customizing and editing your checkout](https://help.shopify.com/en/manual/checkout-settings/checkout-extensibility)
4. Notify Global-e that the extensions have been added so that Global-e can complete the configurations.
5. Go to Settings > Checkout > Customize your checkout > Draft and click **Publish**.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/4kLlWOCKssl9AEZa/images/uuid-d0651986-4cce-aea8-2430-64b15b76748c.png?fit=max&auto=format&n=4kLlWOCKssl9AEZa&q=85&s=c442c50df5bd38ff0ec6a7b82e7b349e" width="1042" height="402" data-path="images/uuid-d0651986-4cce-aea8-2430-64b15b76748c.png" />
   </Frame>

   The Checkout Extensibility is now in place.

### Merchants on Shopify Non-Plus Plan

Follow this process to transition to Checkout Extensibility:

* Provide Global-e with the URL, password, and permissions to your sandbox and live store. If you don't have, or prefer not to use, a sandbox, provide the details only for the live store.

  Global-e updates your settings and installs the on-site payment application.

  Note: If requested, you may need to provide Global-e with the permissions to install the on-site payment application.
* After 1-2 days, you are automatically transitioned to Checkout Extensibility, and the Global-e extensions are added.

## Installation with Checkout Extensibility

The following Global-e applications are installed as part of the Shopify integration:

* CrossBorder app
* Offsite Payment app
* Onsite Payment app

**Note:** These applications are interdependent and cannot be implemented or used separately.

<Warning>
  We highly recommend allowing Global- to perform the installations for you.

  To have Global-e perform the installations, provide your project manager with the URL, password, and permissions to your sandbox and live store. If you don't have, or prefer not to use, a sandbox, provide the details just for the live store.
</Warning>

To perform the app installations yourself, follow the instructions for the relevant Shopify plan:

* [Shopify Plus plan](/installation-271802#shopify-plus-apps-installation)
* [Shopify Non-Plus plan](/installation-271802#shopify-non-plus-apps-installation)

### Shopify Plus Apps Installation

Installing the applications is a two-part process:

1. Install the three applications: CrossBorder App, Onsite Payment app, and Offsite Payment app.
2. Enable each of the applications.

It is very important to follow the precise order in which each app is installed and enabled. You also need to be in regular contact with your project manager during the process so Global-e can implement the required settings and configurations.

### Step 1. Install the CrossBorder Application

1. Click the relevant Global‑e CrossBorder installation link, replace **\[MerchantDomain]** with your Shopify domain, and run the installation.

   **STG (Staging)** - Sandbox link:

   [https://apps.shopify.com/global-e-crossborder-int](https://apps.shopify.com/global-e-crossborder-int)

   **PROD (Production)** - Production link:

   [https://apps.shopify.com/global-e-crossborder](https://apps.shopify.com/global-e-crossborder)

   The installation screen opens showing the Global‑e CrossBorder application icon.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-a822d21b-5644-263f-fd8c-7303d17132ba.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=6789aac769524c4a873410050b1774eb" width="860" height="1331" data-path="images/uuid-a822d21b-5644-263f-fd8c-7303d17132ba.png" />
   </Frame>
2. Click **Install app**.

   A screen opens showing Setup Instructions and Account Settings.

   <Warning>
     **AT THIS STAGE, DO NOT TOGGLE THE GLOBAL-E ENABLED BUTTON.**
   </Warning>

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/SJpQAWts8R8ncyo4/images/uuid-097b3e3b-773e-6643-67d3-b0e29c2ed197.png?fit=max&auto=format&n=SJpQAWts8R8ncyo4&q=85&s=c1b15b2ed71e669d877bab3cb5222372" width="980" height="930" data-path="images/uuid-097b3e3b-773e-6643-67d3-b0e29c2ed197.png" />
   </Frame>
3. Exit the page.

### Step 2. Install the Global-e Onsite Payment app

1. Click the relevant Global‑e Payments installation link, replace **\[shopify domain]** with your Shopify domain, and run the installation.

   **STG** (Staging) - Sandbox link:

   [https://apps.shopify.com/global-e-onsite-payments-int](https://apps.shopify.com/global-e-onsite-payments-int)

   **PROD** (Production) - Production link:

   [https://apps.shopify.com/global-e-onsite-payments](https://apps.shopify.com/global-e-onsite-payments)

   The Global-e Onsite Payments (INT) screen opens.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/SJpQAWts8R8ncyo4/images/uuid-0fec0897-0b46-9244-4fff-760ea499358b.png?fit=max&auto=format&n=SJpQAWts8R8ncyo4&q=85&s=e118eb9c1259985521ecad452586e56f" width="745" height="222" data-path="images/uuid-0fec0897-0b46-9244-4fff-760ea499358b.png" />
   </Frame>
2. At the top of the screen, click **Install.**

   The installation screen opens showing the Global‑e Onsite Payment icon.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-b58cf2bf-38a2-8b98-4b0a-63a1891658af.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=c19932e75aa3dbeab1734d3a72af711d" width="742" height="594" data-path="images/uuid-b58cf2bf-38a2-8b98-4b0a-63a1891658af.png" />
   </Frame>
3. At the top of the screen, click **Install app.**

   The Global‑e Payments App installation is complete, and the Configuration page opens.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-ae5261db-6f8a-63d1-c2c8-1a9a89600d8c.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=838ca5b09b4c5f510ad6d26fec52c567" width="422" height="284" data-path="images/uuid-ae5261db-6f8a-63d1-c2c8-1a9a89600d8c.png" />
   </Frame>
4. Exit the configuration page.

### Step 3. Install the Global-e Offsite Payment app

1. Click the relevant Global‑e Payments installation link, replace **\[MerchantDomain]** with your Shopify domain, and run the installation.

   **STG** (Staging) - Sandbox link:

   [https://apps.shopify.com/global-e-payment-int](https://apps.shopify.com/global-e-payment-int)

   **PROD** (Production) - Production link:

   [https://apps.shopify.com/global-e-payments](https://apps.shopify.com/global-e-payments)

   The installation screen opens showing the Global‑e Payment icon.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/j_QcUA5HG17m29tL/images/uuid-fdb8e783-cb29-6385-c09b-47a761b6074a.png?fit=max&auto=format&n=j_QcUA5HG17m29tL&q=85&s=689ae6d758e6f53f76da5cea74c284ac" width="832" height="566" data-path="images/uuid-fdb8e783-cb29-6385-c09b-47a761b6074a.png" />
   </Frame>
2. At the bottom of the screen click **Install app.**

   The Global‑e Payments App installation is complete, and the Configuration page opens.
3. Exit the configuration page.

### Step 4. Notify your Project Manager that you have installed the applications.

After Global-e incorporates the additional settings, you receive a notification to proceed to step 5.

### Step 5. Enable the CrossBorder app

1. Make sure you have your Merchant ID and Merchant GUID.

   <Note>
     If you are unable to retrieve your Merchant credentials, contact your Global‑e Project Manager.
   </Note>
2. Under Account Settings, enter your account information as detailed below and click **Save**.

   | Account Information | Description                                                                                                                                                                                                                                                   |
   | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Merchant ID         | Your Merchant Account ID, as recorded on the Global-e Merchant Portal. Example: 899                                                                                                                                                                           |
   | Merchant GUID       | The private key of your Merchant Account ID on the Global-e Merchant Portal.The private key of your Merchant Account ID on the Global-e Merchant Portal.**Note:** Currently, Global‑e does not support multiple stores under the same Global‑e Merchant GUID. |
3. Notify your Project Manager that you have set up your account.

   Global-e prepares your Merchant environment, which includes uploading your catalogue and configuring shipping methods.

   Once these configurations are completed, your project manager notifies you that the app can be enabled
4. Toggle **Global-e Enabled** and click Save.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-b4d87fed-4182-e255-b819-b5d5af513b41.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=be6be7613a18a3616126b6db9abed9d7" width="663" height="238" data-path="images/uuid-b4d87fed-4182-e255-b819-b5d5af513b41.png" />
   </Frame>

   The Configuration screen confirms that your Global‑e account configuration is complete.

   The CrossBorder app is now enabled and Global-e implements the following settings:

   * Global-e extensions are automatically added to your Checkout.
   * Global‑e adds the shipping zones (for countries operated by Global‑e) and the carrier service to your store
   * Global‑e JavaScript is added on each page of your site, including on the Checkout page. See [Global‑e JavaScript](/installation-271802#global-e-javascript-271802-1).

   <Warning>
     The CrossBorder app **MUST** be enabled before you can enable the Payment app.
   </Warning>
5. Wait for your Project Manager to confirm that the configurations are complete before continuing with Step 6.

   This process takes about 1-2 days business days, during which time Global-e performs several validations.

### Global‑e JavaScript

Global‑e adds the JavaScript files automatically to all the pages of your website by means of the Shopify Script Tag API.

**Global‑e JavaScript main functionality:**

* Restricted products
* Handles the replacement flow
* Adds the marketing banner
* Supports the payment flow on the checkout page.

### Step 6. Enable Global-e Onsite Payment app

1. Click on the relevant link to return to the Onsite Payment app page.

   * Testing sandbox (QA-INT) environment:

     [https://apps.shopify.com/global-e-onsite-payments-int](https://apps.shopify.com/global-e-onsite-payments-int)
   * Production environment:

     [https://apps.shopify.com/global-e-onsite-payments](https://apps.shopify.com/global-e-onsite-payments)

   <Note>
     Make sure to replace the **MyShopifyPrefix** with your Shopify domain.
   </Note>

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-a77f49d3-00d2-522d-6502-b844091fab6b.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=58deaf3b9a65253a8cfd2a20adaacc03" width="730" height="361" data-path="images/uuid-a77f49d3-00d2-522d-6502-b844091fab6b.png" />
   </Frame>
2. Click **Manage Account**.

   The Onsite Payment App Configuration page opens.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-ae5261db-6f8a-63d1-c2c8-1a9a89600d8c.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=838ca5b09b4c5f510ad6d26fec52c567" width="422" height="284" data-path="images/uuid-ae5261db-6f8a-63d1-c2c8-1a9a89600d8c.png" />
   </Frame>
3. Click **Enable**.

   A message displays confirming that the app is enabled.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/vhiwVFSofQQTfWIF/images/uuid-a0dcb922-82ac-2379-ca88-07552ac1a726.png?fit=max&auto=format&n=vhiwVFSofQQTfWIF&q=85&s=768b103c6beb1c0413b48dac012729b3" width="429" height="278" data-path="images/uuid-a0dcb922-82ac-2379-ca88-07552ac1a726.png" />
   </Frame>
4. Click **Open payment gateway settings** to return to the Onsite Payments page.

   The Payment Methods screen opens, featuring a partial list of payment methods supported by Global-e.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-b7bb1aaf-8695-87e1-1150-31e9a0434e7b.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=3bc15e1239b85016782f3c3c90c209e7" width="760" height="804" data-path="images/uuid-b7bb1aaf-8695-87e1-1150-31e9a0434e7b.png" />
   </Frame>

   <Note>
     * The checkboxes in front of the payment methods are not functional. Selecting or clearing them has no impact on the payment methods displayed on the checkout page.
     * the Payment Methods screen features only a partial list of Payment Methods supported by Global-e.
   </Note>
5. Enable test mode, if you are in the sandbox.

   Note: Test mode is not available when using the app in production.
6. On the bottom right, click **Activate**.

### Step 7. Enable Global-e Offsite Payment app

1. Click on the relevant link to return to the Offsite Payment app page.

   * Testing sandbox (QA-INT) environment:

     [https://apps.shopify.com/global-e-payment-int](https://apps.shopify.com/global-e-payment-int)
   * Production environment:

     [https://apps.shopify.com/global-e-payments](https://apps.shopify.com/global-e-payments)

     <Note>
       Make sure to replace \[MerchantDomain] with your Shopify domain.
     </Note>
2. Click **Enable** to enable the Offsite Payment app.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/j_QcUA5HG17m29tL/images/uuid-ecc77de2-bae3-dc13-15fb-a631786ed7c7.png?fit=max&auto=format&n=j_QcUA5HG17m29tL&q=85&s=4fa2df1cc5ec352fc8c46bdd92d060b2" width="849" height="352" data-path="images/uuid-ecc77de2-bae3-dc13-15fb-a631786ed7c7.png" />
   </Frame>
3. Click **Open payment gateway settings** to activate the Offsite Payment app.

   The Payment Methods screen opens, featuring a partial list of payment methods supported by Global-e.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/-95KX8vS1vYAnafZ/images/uuid-4d40e0c7-129e-421a-0c95-566758400eba.png?fit=max&auto=format&n=-95KX8vS1vYAnafZ&q=85&s=8daac51d9e3dc69191f9eae03fa737cd" width="918" height="798" data-path="images/uuid-4d40e0c7-129e-421a-0c95-566758400eba.png" />
   </Frame>

   <Note>
     * The checkboxes in front of the payment methods are not functional.

       Selecting or clearing them has no impact on the payment methods displayed on the checkout page.
     * The Payment Methods screen features only a partial list of Payment Methods supported by Global-e.
   </Note>
4. Select **Enable test mode**, if you are in the sandbox.

   Note: Test mode is not available when using the app in production.
5. Click **Activate Global-e Payment**

   The Payment Methods supported by Global‑e in Shopify are enabled.
6. Notify your Project Manager that the apps are enabled.

### Shopify Non-Plus Apps Installation

Installing the applications is a two-part process.

1. Install the three applications: CrossBorder App, Onsite Payment app, and Offsite Payment app.
2. Enable each of the applications.

It is very important to follow the precise order in which each app is installed and enabled. You also need to be in regular contact with your project manager during the process so Global-e can implement the required settings and configurations.

### Step 1. Install the Global-e Onsite Payment app

1. Click the relevant Global‑e Payments installation link, replace **\[shopify domain]** with your Shopify domain, and run the installation.

   **STG** (Staging) - Sandbox link:

   [https://apps.shopify.com/global-e-onsite-payments-int](https://apps.shopify.com/global-e-onsite-payments-int)

   **PROD** (Production) - Production link:

   [https://apps.shopify.com/global-e-onsite-payments](https://apps.shopify.com/global-e-onsite-payments)

   The Global-e Onsite Payments (INT) screen opens.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/SJpQAWts8R8ncyo4/images/uuid-0fec0897-0b46-9244-4fff-760ea499358b.png?fit=max&auto=format&n=SJpQAWts8R8ncyo4&q=85&s=e118eb9c1259985521ecad452586e56f" width="745" height="222" data-path="images/uuid-0fec0897-0b46-9244-4fff-760ea499358b.png" />
   </Frame>
2. At the top of the screen, click **Install.**

   The installation screen opens showing the Global‑e Onsite Payment icon.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-b58cf2bf-38a2-8b98-4b0a-63a1891658af.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=c19932e75aa3dbeab1734d3a72af711d" width="742" height="594" data-path="images/uuid-b58cf2bf-38a2-8b98-4b0a-63a1891658af.png" />
   </Frame>
3. At the top of the screen, click **Install app.**

   The Global‑e Payments App installation is complete, and the Configuration page opens.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-ae5261db-6f8a-63d1-c2c8-1a9a89600d8c.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=838ca5b09b4c5f510ad6d26fec52c567" width="422" height="284" data-path="images/uuid-ae5261db-6f8a-63d1-c2c8-1a9a89600d8c.png" />
   </Frame>
4. Exit the configuration page.

### Step 2. Notify your Project Manager that you have installed the Onsite Payment App

At this point, Global-e implements additional configurations, a process that takes 1-2 days.

After the settings are in place, your Project Manager informs you that you can continue to Step 3.

<Warning>
  Wait for confirmation from your project manager before advancing to Step 3.
</Warning>

### Step 3. Install the CrossBorder App

1. Click the relevant Global‑e CrossBorder installation link, replace \[MerchantDomain] with your Shopify domain, and run the installation.

   **STG (Staging)** - Sandbox link:

   [https://crossborder-integration-qa-int.bglobale.com/Integration/App/InstallOrUpgrade?shop=\[MerchantDomain\].myshopify.com](https://apps.shopify.com/global-e-crossborder-int)

   **PROD (Production)** - Production link:

   [https://crossborder-integration.global-e.com/Integration/App/InstallOrUpgrade?shop=\[MerchantDomain\].myshopify.com](https://crossborder-integration.global-e.com/Integration/App/InstallOrUpgrade?shop=%5bMerchantDomain%5d.myshopify.com)

   The installation screen opens showing the Global‑e CrossBorder application icon.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-a822d21b-5644-263f-fd8c-7303d17132ba.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=6789aac769524c4a873410050b1774eb" width="860" height="1331" data-path="images/uuid-a822d21b-5644-263f-fd8c-7303d17132ba.png" />
   </Frame>
2. Click **Install app**.

   A screen opens showing setup instructions and account settings.

   <Warning>
     **AT THIS STAGE, DO NOT TOGGLE THE GLOBAL-E ENABLED BUTTON.**
   </Warning>

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-b033218c-5110-6969-e911-897fde5ca551.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=5c4848b03fac3b2e4f24c6d230e0b2bc" width="1296" height="856" data-path="images/uuid-b033218c-5110-6969-e911-897fde5ca551.png" />
   </Frame>
3. Exit the page.

### Step 4. Install the Global-e Offsite Payment app

1. Click the relevant Global‑e Payments installation link, replace **\[MerchantDomain]** with your Shopify domain, and run the installation.

   **STG** (Staging) - Sandbox link:

   [https://apps.shopify.com/global-e-payment-int](https://apps.shopify.com/global-e-payment-int)

   **PROD** (Production) - Production link:

   [https://apps.shopify.com/global-e-payments](https://apps.shopify.com/global-e-payments)

   The installation screen opens showing the Global‑e Payment icon.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/j_QcUA5HG17m29tL/images/uuid-fdb8e783-cb29-6385-c09b-47a761b6074a.png?fit=max&auto=format&n=j_QcUA5HG17m29tL&q=85&s=689ae6d758e6f53f76da5cea74c284ac" width="832" height="566" data-path="images/uuid-fdb8e783-cb29-6385-c09b-47a761b6074a.png" />
   </Frame>
2. At the bottom of the screen click **Install app.**

   The Global‑e Payments App installation is complete, and the configuration page opens.
3. Exit the configuration page.

### Step 4. Enable the CrossBorder app

1. Make sure you have your Merchant ID and Merchant GUID.

   <Note>
     If you are unable to retrieve your Merchant credentials, contact your Global‑e Project Manager.
   </Note>
2. Under Account Settings, enter your account information as detailed below and click **Save**.

   | Account Information | Description                                                                                                                                                                                                                                                   |
   | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Merchant ID         | Your Merchant Account ID, as recorded on the Global-e Merchant Portal. Example: 899                                                                                                                                                                           |
   | Merchant GUID       | The private key of your Merchant Account ID on the Global-e Merchant Portal.The private key of your Merchant Account ID on the Global-e Merchant Portal.**Note:** Currently, Global‑e does not support multiple stores under the same Global‑e Merchant GUID. |
3. Notify your Project Manager that you have set up your account.

   Global-e prepares your Merchant environment, which includes uploading your catalogue and configuring shipping methods. Once these configurations are completed, your project manager notifies you that the app can be enabled
4. Toggle **Global-e Enabled** and click Save.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-b4d87fed-4182-e255-b819-b5d5af513b41.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=be6be7613a18a3616126b6db9abed9d7" width="663" height="238" data-path="images/uuid-b4d87fed-4182-e255-b819-b5d5af513b41.png" />
   </Frame>

   The configuration screen confirms that your Global‑e account configuration is complete.

   The CrossBorder app is now enabled and Global-e implements the following settings:

   * Global-e extensions are automatically added to your Checkout.
   * Global‑e adds the shipping zones (for countries operated by Global‑e) and the carrier service to your store
   * Global‑e JavaScript is added on each page of your site, including on the Checkout page. See [Global‑e JavaScript](/installation-271802#global-e-javascript-271802-2).

   <Warning>
     The CrossBorder app **MUST** be enabled before you can enable the Payment app.
   </Warning>
5. Wait for your Project Manager to confirm that the configurations are complete before continuing with Step 5.

   This process takes about 1-2 days, during which time Global-e performs some validations.

### Global‑e JavaScript

Global‑e adds the JavaScript files automatically to all the pages of your website by means of the Shopify Script Tag API.

**Global‑e JavaScript main functionality:**

* Restricted products
* Handles the replacement flow
* Adds the marketing banner
* Supports the payment flow on the checkout page.

### Step 5. Enable Global-e Onsite Payment app

1. Click on the relevant link to open the Onsite Payment app page.

   * Testing sandbox (QA-INT) environment:

     [https://apps.shopify.com/global-e-onsite-payments-int](https://apps.shopify.com/global-e-onsite-payments-int)
   * Production environment:

     [https://apps.shopify.com/global-e-onsite-payments](http://https://apps.shopify.com/global-e-onsite-payments)

     <Note>
       Make sure to replace the **MyShopifyPrefix** with your Shopify domain.
     </Note>

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-a77f49d3-00d2-522d-6502-b844091fab6b.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=58deaf3b9a65253a8cfd2a20adaacc03" width="730" height="361" data-path="images/uuid-a77f49d3-00d2-522d-6502-b844091fab6b.png" />
   </Frame>
2. Click **Manage Account**.

   The Onsite Payment App Configuration page opens.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-ae5261db-6f8a-63d1-c2c8-1a9a89600d8c.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=838ca5b09b4c5f510ad6d26fec52c567" width="422" height="284" data-path="images/uuid-ae5261db-6f8a-63d1-c2c8-1a9a89600d8c.png" />
   </Frame>
3. Click **Enable**.

   A message displays confirming that the app is enabled.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/vhiwVFSofQQTfWIF/images/uuid-a0dcb922-82ac-2379-ca88-07552ac1a726.png?fit=max&auto=format&n=vhiwVFSofQQTfWIF&q=85&s=768b103c6beb1c0413b48dac012729b3" width="429" height="278" data-path="images/uuid-a0dcb922-82ac-2379-ca88-07552ac1a726.png" />
   </Frame>
4. Click **Open payment gateway settings** to return to the Onsite Payments page.

   The Payment Methods screen opens, featuring a partial list of payment methods supported by Global-e.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/83nCB7AJobthQFqb/images/uuid-b7bb1aaf-8695-87e1-1150-31e9a0434e7b.png?fit=max&auto=format&n=83nCB7AJobthQFqb&q=85&s=3bc15e1239b85016782f3c3c90c209e7" width="760" height="804" data-path="images/uuid-b7bb1aaf-8695-87e1-1150-31e9a0434e7b.png" />
   </Frame>

   <Note>
     * The checkboxes in front of the payment methods are not functional. Selecting or clearing them has no impact on the payment methods displayed on the checkout page.
     * The Payment Methods screen features only a partial list of Payment Methods supported by Global-e.
   </Note>
5. Enable test mode, if you are in the sandbox.
6. Note: Test mode is not available when using the app in production.
7. On the bottom right, click **Activate**.

### Step 6. Enable Global-e Offsite Payment app

1. Click on the relevant link to open the Offsite Payment app page.

   * Testing sandbox (QA-INT) environment:

     [https://apps.shopify.com/global-e-payment-int](https://apps.shopify.com/global-e-payment-int)
   * Production environment:

     [https://apps.shopify.com/global-e-payments](https://apps.shopify.com/global-e-payments)

   <Note>
     Make sure to replace **\[MerchantDomain]** with your Shopify domain.
   </Note>
2. Click **Enable** to enable the Offsite Payment app.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/j_QcUA5HG17m29tL/images/uuid-ecc77de2-bae3-dc13-15fb-a631786ed7c7.png?fit=max&auto=format&n=j_QcUA5HG17m29tL&q=85&s=4fa2df1cc5ec352fc8c46bdd92d060b2" width="849" height="352" data-path="images/uuid-ecc77de2-bae3-dc13-15fb-a631786ed7c7.png" />
   </Frame>
3. Click **Open payment gateway settings** to activate the Offsite Payment app.

   The Payment Methods screen opens, featuring a partial list of payment methods supported by Global-e.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/-95KX8vS1vYAnafZ/images/uuid-4d40e0c7-129e-421a-0c95-566758400eba.png?fit=max&auto=format&n=-95KX8vS1vYAnafZ&q=85&s=8daac51d9e3dc69191f9eae03fa737cd" width="918" height="798" data-path="images/uuid-4d40e0c7-129e-421a-0c95-566758400eba.png" />
   </Frame>

   <Note>
     In the Payment Methods screen:

     * The checkboxes in front of the payment methods are not functional.

       Selecting or clearing them has no impact on the payment methods displayed on the checkout page.
     * This screen features only a partial list of Payment Methods supported by Global-e.
     * Test mode is not available when using the Global‑e Payments app in the Production store. You can only test payments in the sandbox (staging environment).
   </Note>
4. Click **Activate Global-e Payment**

   Activating **Global‑e Payments** enables the Payment Methods supported by Global‑e in Shopify.
5. Notify your Project Manager that the apps are enabled.

## Shopify Store Settings

**To configure your Shopify store:**

1. Set the Customer contact method to Email (only).

   From your Shopify admin, go to Settings > Checkout and Accounts.

   <Frame>
     <img src="https://mintcdn.com/globale-enterprise/SJpQAWts8R8ncyo4/images/uuid-0300d39c-746e-204a-5bdc-1f993ca9f2cc.png?fit=max&auto=format&n=SJpQAWts8R8ncyo4&q=85&s=f4000e64a1bbff43372baf44b8868b57" width="605" height="146" data-path="images/uuid-0300d39c-746e-204a-5bdc-1f993ca9f2cc.png" />
   </Frame>
2. The phone number field must appear on the checkout page. Please set **Shipping address phone** number to **Required**.

   To complete the checkout, the Global-e CrossBorder solution requires that customers enter their phone number as part of the shipping address on the Shopify checkout page.
3. Optionally, you can enable/disable the setting to review your order.

   1. From your Shopify Admin, go to Settings > General > Order processing.
   2. The **Require a confirmation step** is supported by Global-e. If you do not see the option, you can skip it.

      <Frame>
        <img src="https://mintcdn.com/globale-enterprise/j_QcUA5HG17m29tL/images/uuid-f25584ea-9d31-7d21-0ba8-cc33529021af.png?fit=max&auto=format&n=j_QcUA5HG17m29tL&q=85&s=f5ff46dec024ddb0b40cb8a7d28ec517" width="783" height="456" data-path="images/uuid-f25584ea-9d31-7d21-0ba8-cc33529021af.png" />
      </Frame>
4. Set customer information:

   * From your Shopify Admin, go to Settings > Checkout > Customer Information > Full Name.
   * Adjust the setting to **Require first and last name.**

     <Frame>
       <img src="https://mintcdn.com/globale-enterprise/X_jditTJssq_GTcj/images/uuid-5e50cf4d-e291-fbb8-6465-9a1cf0593f20.png?fit=max&auto=format&n=X_jditTJssq_GTcj&q=85&s=99337fa8339e8bc5234716bfbd2cb82d" width="379" height="116" data-path="images/uuid-5e50cf4d-e291-fbb8-6465-9a1cf0593f20.png" />
     </Frame>