Skip to main content
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
TaskDetailsCommentsProvider ReplyDone
Contact Global-eContact GE either by subscribing in our partners portal: Our Global Ecosystem of Partners - Global-e or by contacting your merchant’s CSM.[ ]
Merchant Specific
TaskDetailsCommentsProvider ReplyDone
Obtain the Merchant GUIDRequired for API headers/callsGet from merchant[ ]
One shipping optionIf only one return shipping option is supported, inform the merchant and ensure correct setupPer lane in Global-e[ ]
emailsIf provider sends shopper emails, coordinate with merchant to disable Global-e notificationsOpen support ticket if needed[ ]
Communication to Global-e
TaskDetailsCommentsProvider ReplyDone
Provider CodeCommunicate your Provider Code identifierMust be recognized for API calls[ ]
Merchant GUIDUse Merchant GUID for each API call to Global-e[ ]
Implementation
TaskDetailsCommentsProvider ReplyDone
Order is operated by Global-eImplement Shopify order checks to verify that the order is Global-e operatedBefore offering returns/exchanges[ ]
Tracking NumberSave TrackingNumber returned from GetReturnDocument API call for tracking eventsRequired for event calls[ ]
Create ReturnCreate the return in Shopify after receiving Global-e documents. Include ReturnShippingFee in presentment_currency[ ]
Implement needed APIsGetReturnShippingOptions
GetReturnDocuments
GetTrackingEvents
[ ]
Perform final checksEnsure all systems function as expected before launchFinal readiness[ ]
TaskDetailsCommentsProvider ReplyDone
Order is operated by Global-eImplement Shopify order checks to verify the order is Global-e operated beforeoffering Global-e returns/exchanges[ ]
Obtain the Merchant GUID for each merchant you onboardThis is required in API headers for Global-e calls.Get it from the Merchant[ ]
Provider CodeProvider name or initials that identifies the source of the request.Examples:Loop, Redo, ParcelLabCommunicate your Provider Code identifier to Global-e so it’s recognized in API calls.[ ]
emailsIf you will send shopper emails, coordinate with merchant to disable Global-e notifications via a merchant support ticket.[ ]
One shipping optionIf 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 NumberTrackingNumber is return from the API call GetReturnDocument
It must be saved for tracking events calls
[ ]
Create ReturnCreate the return in Shopify after receiving Global-e documents.
Include ReturnShippingFee in presentment_currency.
[ ]
Perform final checksEnsure all systems are functioning as expected before launch.[ ]