Skip to main content
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.
We highly recommend allowing Global-e 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.
To perform the app installations yourself, follow the steps below. Installing the applications is a two-part process: install the three applications (CrossBorder App, Onsite Payment app, and Offsite Payment app), then enable each of them. 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 app

  • Click the relevant Global‑e CrossBorder installation link and run the installation. INT (Integration environment) - Integration link: https://apps.shopify.com/global-e-crossborder-int PROD (Production) - Production link: https://apps.shopify.com/global-e-crossborder The installation screen opens showing the Global‑e CrossBorder application icon.
  • Click Install app. A screen opens showing Setup Instructions and Account Settings.
    AT THIS STAGE, DO NOT TOGGLE THE GLOBAL-E ENABLED BUTTON.This button is disabled by default and should only be enabled upon Global-e’s confirmation.
  • Exit the page.

Step 2. Install the Global-e Onsite Payment app

  • Click the relevant Global‑e Payments installation link and run the installation. INT (Integration environment) - Integration link: https://apps.shopify.com/global-e-onsite-payments-int PROD (Production) - Production link: https://apps.shopify.com/global-e-onsite-payments The Global-e Onsite Payments (INT) screen opens.
  • At the top of the screen, click Install. The installation screen opens showing the Global‑e Onsite Payment icon.
  • At the top of the screen, click Install app. The Global‑e Payments App installation is complete, and the Configuration page opens.
  • Exit the configuration page.

Step 3. Install the Global-e Offsite Payment app

  • Click the relevant Global‑e Payments installation link and run the installation. INT (Integration environment) - Integration link: https://apps.shopify.com/global-e-payment-int PROD (Production) - Production link: https://apps.shopify.com/global-e-payments The installation screen opens showing the Global‑e Payment icon.
  • At the bottom of the screen click Install app. The Global‑e Payments App installation is complete, and the Configuration page opens.
  • 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

  • Make sure you have your Merchant ID and Merchant GUID.
    If you are unable to retrieve your Merchant credentials, contact your Global‑e Project Manager.
  • Under Account Settings, enter your account information as detailed below and click Save.
  • 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
  • Toggle Global-e Enabled and click Save.
    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
    The CrossBorder app MUST be enabled before you can enable the Payment app.
  • Enable the Global‑e storefront app embed in your Shopify theme. See Global‑e JavaScript.
  • Wait for your Project Manager to confirm that the configurations are complete before you enable the payment apps. This process takes about 1-2 business days, during which time Global-e performs several validations.

Global‑e JavaScript

Global‑e JavaScript runs on all the pages of your store through the Global‑e storefront app embed. You must enable this app embed on every installation. To enable the Global‑e storefront app embed:
  • In the theme editor, navigate to Apps.
  • Enable Global‑e storefront on the published theme.
  • Click Save.
The following figure shows the App embeds panel in the theme editor:
Shopify theme editor with the App embeds panel open, the Global‑e storefront toggle turned on, and the Save button
App embeds are enabled per theme. If you publish a new theme, turn on Global‑e storefront on that theme as well. Until you do, Global‑e JavaScript does not run on your storefront.
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 the Global-e Onsite Payment app

  • Click on the relevant link to return to the Onsite Payment app page.
  • Click Manage Account. The Onsite Payment App Configuration page opens.
  • Click Enable. A message displays confirming that the app is enabled.
  • 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.
    • 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.
  • In the integration (INT) environment, enable test mode. In production, leave test mode disabled (the default).
  • On the bottom right, click Activate.

Step 7. Enable the Global-e Offsite Payment app

  • Click on the relevant link to return to the Offsite Payment app page.
  • Click Enable to enable the Offsite Payment app.
  • 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.
    The notes about the Payment Methods screen in Step 6 apply here too.
  • In the integration (INT) environment, select Enable test mode. In production, leave it disabled (the default).
  • Click Activate Global-e Payment The Payment Methods supported by Global‑e in Shopify are enabled.
  • Notify your Project Manager that the apps are enabled.

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.
    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. Navigate to Products.
  3. Click Export. The Export products dialogue box opens.
  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.

Shopify Store Settings

To configure your Shopify store:
  • Set the Customer contact method to Email (only). From your Shopify admin, navigate to Settings > Checkout and Accounts.
  • 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.
  • Optionally, you can enable/disable the setting to review your order.
    • From your Shopify Admin, navigate to Settings > General > Order processing.
    • The Require a confirmation step is supported by Global-e. If you do not see the option, you can skip it.
  • Set customer information:
    • From your Shopify Admin, navigate to Settings > Checkout > Customer Information > Full Name.
    • Adjust the setting to Require first and last name.