Returns Provider Integration - Checklist - Global-e Docs

The Returns Provider Integration - Checklist outlines the required steps and validations for return solution providers integrating with Global-e’s returns, refunds, and exchange flows on Shopify.

Prerequisite

Task	Details	Comments	Provider Reply	Done
Contact Global-e	Contact GE either by subscribing in our partners portal: Our Global Ecosystem of Partners - Global-e or by contacting your merchant’s CSM.			[ ]

Merchant Specific

Task	Details	Comments	Provider Reply	Done
Obtain the Merchant GUID	Required for API headers/calls	Get from merchant		[ ]
One shipping option	If only one return shipping option is supported, inform the merchant and ensure correct setup	Per lane in Global-e		[ ]
emails	If provider sends shopper emails, coordinate with merchant to disable Global-e notifications	Open support ticket if needed		[ ]

Communication to Global-e

Task	Details	Comments	Provider Reply	Done
Provider Code	Communicate your Provider Code identifier	Must be recognized for API calls		[ ]
Merchant GUID	Use Merchant GUID for each API call to Global-e			[ ]

Implementation

Task	Details	Comments	Provider Reply	Done
Order is operated by Global-e	Implement Shopify order checks to verify that the order is Global-e operated	Before offering returns/exchanges		[ ]
Tracking Number	Save TrackingNumber returned from GetReturnDocument API call for tracking events	Required for event calls		[ ]
Create Return	Create the return in Shopify after receiving Global-e documents. Include ReturnShippingFee in presentment_currency			[ ]
Implement needed APIs	GetReturnShippingOptions GetReturnDocuments GetTrackingEvents			[ ]
Perform final checks	Ensure all systems function as expected before launch	Final readiness		[ ]

Task	Details	Comments	Provider Reply	Done
Order is operated by Global-e	Implement Shopify order checks to verify the order is Global-e operated before offering Global-e returns/exchanges			[ ]
Obtain the Merchant GUID for each merchant you onboard	This is required in API headers for Global-e calls.	Get it from the Merchant		[ ]
Provider Code	Provider name or initials that identifies the source of the request.Examples:Loop, Redo, ParcelLab	Communicate your Provider Code identifier to Global-e so it’s recognized in API calls.		[ ]
emails	If you will send shopper emails, coordinate with merchant to disable Global-e notifications via a merchant support ticket.			[ ]
One shipping option	If your portal supports only one return shipping option, you must: Inform the merchant Ensure they configure the correct method per lane in Global-e			[ ]
Tracking Number	`TrackingNumber` is return from the API call GetReturnDocument It must be saved for tracking events calls			[ ]
Create Return	Create the return in Shopify after receiving Global-e documents. Include ReturnShippingFee in presentment_currency.			[ ]
Perform final checks	Ensure all systems are functioning as expected before launch.			[ ]

⌘I