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

# Configuration

## Integration Features

| Feature                       | Description                                                                                                                |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Country and Currency Switcher | Choose over 200 countries with default or free currencies (which can be replaced by a custom implementation)               |
| Currency Conversion           | View prices in local currency with up-to-date conversion rates, country coefficients, rounding rules, and currency symbols |
| Duty and Tax Calculations     | Country and continent-specific duty and tax calculations                                                                   |
| Delivery Cost                 | Dynamic delivery cost calculations based on country                                                                        |
| Multiple Shipping Options     | Country-specific shipping options from standard to express                                                                 |
| Local Payment Methods         | Choose from the most popular payment methods for each country                                                              |
| Promotions                    | Manage promotions for Global‑e operated countries                                                                          |
| Customer Service              | View and manage Global-e Orders through the Customer Services Tool                                                         |

## Examples

<Frame>
  <img src="https://mintcdn.com/globale-pro/DI7MhNRIGZmJisxS/images/uuid-cc70c928-d20f-4a37-71b1-69248c560887.png?fit=max&auto=format&n=DI7MhNRIGZmJisxS&q=85&s=a3a103217082e05365bd63d8ae96d524" width="367" height="240" data-path="images/uuid-cc70c928-d20f-4a37-71b1-69248c560887.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/globale-pro/xVCfMCeeDxhz61Tt/images/uuid-51709f5b-6ace-0802-7fa9-3529f73b5289.png?fit=max&auto=format&n=xVCfMCeeDxhz61Tt&q=85&s=c981c6935948d3b2ece9e74bf9ef86a7" width="409" height="186" data-path="images/uuid-51709f5b-6ace-0802-7fa9-3529f73b5289.png" />
</Frame>

## High-Level Flow

<Frame>
  <img src="https://mintcdn.com/globale-pro/Ur00Q-BwL5gi4PHb/images/uuid-f8da5c3d-431d-0988-8959-147cf8c5f38a.svg?fit=max&auto=format&n=Ur00Q-BwL5gi4PHb&q=85&s=a355a402040f10570e974e4212cdbdd0" width="935" height="625" data-path="images/uuid-f8da5c3d-431d-0988-8959-147cf8c5f38a.svg" />
</Frame>

## Sample Reference Architecture

<Frame>
  <img src="https://mintcdn.com/globale-pro/Ur00Q-BwL5gi4PHb/images/uuid-e245c6c0-ecc9-5c99-8cda-e938b1ff7407.svg?fit=max&auto=format&n=Ur00Q-BwL5gi4PHb&q=85&s=739405b89fa9faadbc3825274a69ce72" width="1042" height="598" data-path="images/uuid-e245c6c0-ecc9-5c99-8cda-e938b1ff7407.svg" />
</Frame>

## Integration Overview Before Global‑e

<Frame>
  <img src="https://mintcdn.com/globale-pro/Ur00Q-BwL5gi4PHb/images/uuid-f6ac8d5c-5bce-967a-1226-0b572f3d97c4.svg?fit=max&auto=format&n=Ur00Q-BwL5gi4PHb&q=85&s=725a7f92ac8c9fdafec1409640d76972" width="893" height="553" data-path="images/uuid-f6ac8d5c-5bce-967a-1226-0b572f3d97c4.svg" />
</Frame>

## Customer Journey (Technical)

<Frame>
  <img src="https://mintcdn.com/globale-pro/Ur00Q-BwL5gi4PHb/images/uuid-eaa3eafe-1832-a796-6127-104c6e241069.svg?fit=max&auto=format&n=Ur00Q-BwL5gi4PHb&q=85&s=76bea46ad4c1b235e87783bac713cff6" width="1097" height="583" data-path="images/uuid-eaa3eafe-1832-a796-6127-104c6e241069.svg" />
</Frame>

## Integration Overview with GE - Customer Browsing

<Frame>
  <img src="https://mintcdn.com/globale-pro/DI7MhNRIGZmJisxS/images/uuid-cf522b18-d2dd-4c29-4ce9-56cc2c1c0a7b.svg?fit=max&auto=format&n=DI7MhNRIGZmJisxS&q=85&s=db8a45ccdd570222e1195add379bdfb4" width="1080" height="606" data-path="images/uuid-cf522b18-d2dd-4c29-4ce9-56cc2c1c0a7b.svg" />
</Frame>

## Integration Overview with Global‑e - Order Creation

<Frame>
  <img src="https://mintcdn.com/globale-pro/xVCfMCeeDxhz61Tt/images/uuid-3978ac07-e224-19e0-9356-8ce4b8ff3093.svg?fit=max&auto=format&n=xVCfMCeeDxhz61Tt&q=85&s=9bf7f2aed4cb1e658640c74202aef7d2" width="1063" height="596" data-path="images/uuid-3978ac07-e224-19e0-9356-8ce4b8ff3093.svg" />
</Frame>

## Client-side Includes

<Frame>
  <img src="https://mintcdn.com/globale-pro/z_1NWH1VDGkrAUPj/images/uuid-56ab865b-76f0-31bd-88c9-fac7a9454843.svg?fit=max&auto=format&n=z_1NWH1VDGkrAUPj&q=85&s=8efbd411c2ae3da3e74fdeb1af5c43a5" width="1154" height="485" data-path="images/uuid-56ab865b-76f0-31bd-88c9-fac7a9454843.svg" />
</Frame>

## BigCommerce Order List

<Frame>
  <img src="https://mintcdn.com/globale-pro/z_1NWH1VDGkrAUPj/images/uuid-65be733b-915d-05f0-19de-feca2df13b66.png?fit=max&auto=format&n=z_1NWH1VDGkrAUPj&q=85&s=0ff6988e9be53d80bc9927b87d38773a" width="1136" height="568" data-path="images/uuid-65be733b-915d-05f0-19de-feca2df13b66.png" />
</Frame>

## BigCommerce Order Details

<Frame>
  <img src="https://mintcdn.com/globale-pro/94o3xziQy0q7S1yz/images/uuid-38cbd9dc-6c8b-1e8f-5ba5-631f55ecae88.jpg?fit=max&auto=format&n=94o3xziQy0q7S1yz&q=85&s=923f9758d8b3368cc78087fb6890b438" width="723" height="338" data-path="images/uuid-38cbd9dc-6c8b-1e8f-5ba5-631f55ecae88.jpg" />
</Frame>

* The order is created as domestic
* The international details are stored in staff notes

## Integration Overview with Global‑e

### Order Dispatch

<Frame>
  <img src="https://mintcdn.com/globale-pro/ZZL9nUpH-VJskFgH/images/uuid-7cc8af63-9279-ccd9-368c-9cfb481cce27.svg?fit=max&auto=format&n=ZZL9nUpH-VJskFgH&q=85&s=f6148c0d9caa0bcb7945cb11407d8c9e" width="1066" height="594" data-path="images/uuid-7cc8af63-9279-ccd9-368c-9cfb481cce27.svg" />
</Frame>

## Marketing, Analytics, and Communication

| Item                   | Handling                                                                                                                                     |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Google shopping feed   | Leverage existing feeds and new feeds for Global‑e operated destinations leveraging the Global‑e cartridge or price feed API                 |
| Analytics and tracking | Review current trackers and analytics integration to build the associated data layer and triggers using the Global‑e checkout callbacks      |
| Email Communications   | Transactional emails provided by Global-e and suppressed on the merchant sideAll marketing material and communications remain with the brand |

## Analytics and Tracking Pixels - Client SDK

<Frame>
  <img src="https://mintcdn.com/globale-pro/ZZL9nUpH-VJskFgH/images/uuid-7c0ddcd8-b410-33df-d10f-b36ab198b8d3.svg?fit=max&auto=format&n=ZZL9nUpH-VJskFgH&q=85&s=5cb95a73c04cf39c4ff37b04ab1ab221" width="889" height="530" data-path="images/uuid-7c0ddcd8-b410-33df-d10f-b36ab198b8d3.svg" />
</Frame>

### Conversion Tracking Server-Side

Google Analytics solution hosted by Global‑e OR through a JavaScript callback from the iframe to the container page.

```
gle("OnCheckoutStepLoaded", function (data) {
    switch (data.StepId) {
    case data.Steps.LOADED:
        break;
    case data.Steps.CONFIRMATION:
        if (data.IsSuccess) {
            ga('send', 'event', 'order', 'success', 'global-e');
        }
        break;
    }
});
```

### Marketing Feeds

Adjust existing Google feed and new feed for Global‑e markets.

## Order Processing

Global‑e-operated orders are created in the e-commerce platform as domestic orders (base currency) with:

* End Customer transaction currency data
* End Customer shipping and billing address
* “Global-e” shipping service(s) – for warehouse dispatch routing – to be mapped in ERP
* “Global-e” payment provider – for financial/accountancy handling – to be mapped in ERP
* Both Global‑e and brand platform order numbers referenced on both sides

OMS/ERP Order flow: suppression of current activities on fraud, auth/capture, emails

Shipping documentation (carrier label and invoice) when provided by Global‑e entails:

→ No actual end customer address is required by the Warehouse team and systems

→ Order number documentation allows retrieving from Portal or API

## Order Downstream Flow and Dispatch

<Frame>
  <img src="https://mintcdn.com/globale-pro/DI7MhNRIGZmJisxS/images/uuid-cbe33314-0cde-544c-7398-819f29170f6f.svg?fit=max&auto=format&n=DI7MhNRIGZmJisxS&q=85&s=393c067654a803bbc00090dae4ab08c2" width="1040" height="473" data-path="images/uuid-cbe33314-0cde-544c-7398-819f29170f6f.svg" />
</Frame>

## Returns and Refund Management

<Frame>
  <img src="https://mintcdn.com/globale-pro/03R8uscobgLW4hbM/images/uuid-8f194ded-82f6-b38c-6348-de657f83149a.png?fit=max&auto=format&n=03R8uscobgLW4hbM&q=85&s=ba3dcec0e78514dac4cf783d47bd0f2f" width="692" height="458" data-path="images/uuid-8f194ded-82f6-b38c-6348-de657f83149a.png" />
</Frame>

<Note>
  The customer submits returns requests directly through the Global-e Returns Portal (Global-e Customer Service Portal).The Admin can perform returns via the Global-e Merchant Portal Returns screen.Refunds are executed either via:→ The Global-e Customer Service Portal→ Direct API integration with Global-e
</Note>

## To configure the Global-e Application

1. From the BigCommerce left menu, select **Apps > Global-e**.

   The Global-e Configuration screen opens.

   <Frame>
     <img src="https://mintcdn.com/globale-pro/ZZL9nUpH-VJskFgH/images/uuid-84115994-cbdb-be04-b00a-7fe41448ee55.png?fit=max&auto=format&n=ZZL9nUpH-VJskFgH&q=85&s=0fb0c55401b5f35d2b236fb3e04492da" width="1023" height="546" data-path="images/uuid-84115994-cbdb-be04-b00a-7fe41448ee55.png" />
   </Frame>
2. Configure the following parameters, as required:

   | Field/Box     | Description/Steps                                                                                                                                                                                           |
   | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Is Active     | Adds or removes the Global-e includes to or from your site.Select **Is Active** to add the Global-e script includes to your Merchant site.Clear the box to delete the Global-e includes from your Pla site. |
   | Include type  | The Global-e include types are based on the Global-e solutions (Pro, GEM). The default *include* type is based on the Global-e GEM solution.                                                                |
   | Merchant ID   | Your Merchant Account ID, as recorded in the Global-e system. Example: 899Modify your Merchant Account ID, if required.                                                                                     |
   | Merchant GUID | The private key of your Merchant Account ID in the Global-e system.Example: F978DFEB-FF8C-4EE1-BFDA-68FB1B78E217Modify your Merchant Account ID private key, if required.                                   |
3. Click **SAVE**.

   The Global-e scripts for BigCommerce are added to your Merchant site.
