Skip to main content

Documentation Portal

Migrating Global-e to Native App

If you are presently running live on the legacy version of Global-e’s Shopify integration, a.k.a the “hosted checkout”, you must migrate to the latest version where Global-e is natively integrated into Shopify’s checkout.

These are the key changes to Shopify order data:

  • Order transaction is no longer per B2B transaction in a single currency, but per customer B2C transaction instead with presentment currency and shop currency. The B2B VAT is no longer reflected in Shopify.

  • Order id – Shopify order_name no longer starts with ‘GE’ (e.g, GE2034304US). Orders name is now assigned by Shopify same as for domestic orders (eg., #1234). The Global-e order id is available, see below “From the “Additional Details” section in order data”

  • Shipping lines/code is now standardized by Shopify as explained in the previous section.

  • Shipment confirmation emails no longer come from Global-e but instead are managed by Shopify/merchant.

  • Fraud approval no changes to this flow, still relying on the payment status “pending” (before fraud check) and a subsequent update to “paid” status upon fraud approval with the addition of an order tag “Globale::Approved”

  • Payment gateway no longer shows ‘globale’, instead:

    • Global-e Payment (INT) when installing the Global-e payment method in production mode.

    • Global-e Payments when installing the Global-e payment method in test mode.

From the “Additional Details” section in order data

The Global-e order is still available in Shopify, however not upon initial order creation and only as a note_attribute, which is updated by the Global-e Shopify app a few seconds post-order creation.

Example

"order": {
 "id": 4525092405308,
 "name": "#1976",
 "note_attributes": [
 {
 "name": "GEOrderId",
 "value": "GE10071428326US"
 }