Global-e Integration

Edited

Global-e integrates with Loop Returns to provide cross-border return and exchange shipping for international orders. When a shopper initiates a return or exchange on a Global-e order, Loop coordinates with Global-e to generate return labels, track shipments, and handle multi-currency refunds. Merchants manage both domestic and international returns from a single portal.


What It Does

  • Cross-border return labels — Loop automatically generates international return shipping labels through Global-e when shoppers initiate returns on Global-e orders. Global-e selects the carrier and route for each return.

  • BETA Even exchanges — Shoppers can exchange items on Global-e orders using Variant Exchanges (different size or color of the same product) or Advanced Exchanges (a different product entirely), as long as the exchange is cost-for-cost — meaning no price difference between the returned and exchanged items.

  • Unified returns portal — Shoppers use the same Loop experience for domestic and international returns.

  • Shipment tracking — Loop polls Global-e for tracking updates and surfaces status changes (In Transit, Out for Delivery, Delivered) to the shopper.

  • Multi-currency refunds — Refunds are issued in the shopper's original purchase currency.

  • Store credit in shop currency — Gift cards and store credit are issued in your shop's base currency (platform limitation).

  • Carrier selection — Global-e determines the shipping method and carrier for each return. Loop uses the rate Global-e provides.


Exchanges on Global-e Orders BETA

Merchants can enable exchanges on Global-e orders. Two exchange types are supported:

  • Variant Exchanges — The shopper exchanges for a different variant (e.g., size or color) of the same product.

  • Advanced Exchanges — The shopper exchanges for a different product entirely.

Both exchange types require the exchanged item to be the same price as the returned item (cost-for-cost). Exchanges that involve a price difference — where the shopper would owe additional money or receive a partial refund — are not supported.

Handling fees cannot be applied to exchanges on Global-e orders. If your return policy includes a handling fee, it will not be charged on exchange transactions.

To enable exchanges on your Global-e integration, contact your Loop Merchant Success Manager.


Key Concepts

  • Cross-border return — A return where the shopper is in a different country than the merchant, requiring international shipping and currency handling.

  • Presentment currency — The currency the shopper paid in. Refunds are issued in this currency.

  • Shop currency — Your store's base currency. Store credit and gift cards are issued in this currency.

  • Merchant of record — Global-e acts as the merchant of record for international transactions and handles payment reversal, duties, and taxes.

  • GEOrderId — A reference number that links your Shopify order to Global-e's system. It is added to your Shopify order automatically by Global-e's Shopify app.

  • Return window alignment — Your Loop return-policy window must match or be shorter than the window configured in Global-e.


Prerequisites

  1. An active Global-e agreement and account.

  2. Your Global-e MerchantGUID (found in Global-e admin).

  3. A Loop plan that includes cross-border shipping support — confirm tier eligibility with your Loop Merchant Success Manager.

  4. Coordination with your Loop Merchant Success Manager to enable the integration.


Setup

  1. Contact Loop — Reach out to your Merchant Success Manager to have the Global-e integration enabled on your shop.

  2. Connect Global-e in Loop — Go to Settings > Shipping > Shipping Services and connect the Global-e service.

  3. Enter your MerchantGUID — Paste the MerchantGUID from your Global-e admin.

  4. Select your environment — Choose test or production mode.

  5. Configure return policies — Enable label generation in the return policies that handle international orders.

  6. Set the handling fee to 100% — For Global-e return policies, set the Loop handling fee to 100%. Note: handling fees do not apply to exchange transactions.

  7. Align return windows — Ensure your Loop return-policy window matches Global-e's return window.

  8. Prevent double refunds — If you use Loop's early or automatic refund features, disable refunds in Global-e so both systems don't issue a refund.

  9. Add currency transparency — Add language about "estimated presentment amounts" to your Policy Acceptance copy.

  10. Enable exchanges (optional, Beta) — Contact your Merchant Success Manager to enable even exchanges on Global-e orders.

Note: The return destination configured in Global-e overrides the destination set in your Loop return policy.


Testing

Testing is done in your production environment. You will need access to your Global-e admin (Hub Operator privileges).

  1. In Global-e admin, navigate to Orders > Merchant Hub > Process Orders, find your test order, and change Order Status to Dispatched to customer.

  2. In Shopify admin, open the order, go to Unfulfilled, click Fulfill items and confirm.

  3. Initiate a return (or exchange, if enabled) through your Loop portal to verify the full flow.


Configuration Reference

Setting

Where

Description

Global-e connection

Settings > Shipping > Shipping Services

Connect and authenticate using your MerchantGUID

Environment mode

Shipping settings

Switch between test and production

Label generation

Return policy settings

Enable Global-e labels per return policy

Handling fee

Return policy settings

Set to 100% for Global-e policies (does not apply to exchanges)

Allow refunds on multi-currency returns

Contact Loop support

Enables refunds on multi-currency returns

Allow gift cards on multi-currency returns

Contact Loop support

Enables gift cards on multi-currency returns; issued in shop currency

Reimbursements

Contact Loop support

Enables duty refunds for applicable countries

Presentment currency display

Contact Loop support

Show amounts in the shopper's purchase currency

Exchanges on Global-e orders

Contact Merchant Success Manager

Enable even exchanges (Variant and Advanced) on Global-e orders (Beta)


Limitations

  • Exchanges with a price difference — Only even (cost-for-cost) exchanges are supported. The returned and exchanged items must be the same price. Upsells and are not supported.

  • Handling fees on exchanges — Handling fees cannot be charged on exchange transactions for Global-e orders.

  • Store credit currency — Gift cards and store credit are issued in your shop's base currency, not the shopper's purchase currency (platform limitation).

  • Shopify Markets Pro — Although Shopify Markets Pro is powered by Global-e, it is a different integration and is not compatible.

  • Packing slips — Not available for Global-e return policies (Global-e provides their own).

  • Shopify Native Store Credit — Must be enabled for the Global-e integration. If you're unsure whether your shop has this enabled, contact Loop support.

  • Label billing — You pay Global-e directly for return labels. Loop does not bill for them.

  • Carrier name — The portal displays "see label for carrier" because Global-e selects the carrier.

  • Language — English only.

  • Destination override — Global-e's configured return address overrides the destination set in your Loop return policy.


Common Questions

Can shoppers exchange items on Global-e orders?

Yes, in beta. Variant Exchanges (same product, different variant) and Advanced Exchanges (different product) are supported when the exchange is cost-for-cost — the returned and exchanged items must be the same price. Exchanges with a price difference are not supported, and handling fees do not apply to exchanges. Contact your Merchant Success Manager to enable.

How do refunds work with Global-e?

Refunds are issued in the shopper's original purchase currency. Store credit and gift cards are issued in your shop's base currency. Global-e handles the payment reversal as merchant of record. If you use Loop's automatic refund features, disable refunds in Global-e to prevent double refunds.

What currencies are supported?

Refunds are processed in whatever currency the shopper paid in. Store credit is always issued in your shop's base currency. You can add transparency language in your return policy to inform shoppers about estimated presentment amounts.

Who do I contact for help?

  • Loop-side setup issues — Contact your Loop Merchant Success Manager.

  • Global-e issues (order dispatch, configuration) — Contact Global-e support at portalsupport@global-e.com.

  • Enabling exchanges — Contact your Loop Merchant Success Manager.


Please reach out to support@loopreturns.com with any additional questions.


Was this article helpful?

Sorry about that! Care to tell us more?

Thanks for the feedback!

There was an issue submitting your feedback
Please check your connection and try again.