Returns Provider Integration - Checklist
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 | [ ] | |||
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:
| [ ] | ||
Tracking Number |
| [ ] | ||
Create Return | Create the return in Shopify after receiving Global-e documents.
| [ ] | ||
Perform final checks | Ensure all systems are functioning as expected before launch. | [ ] |