Integrate an external fulfillment service with Shopify Markets Pro
On this page
Get your globally unique identifier for Markets Pro (GUID)
When you onboard to Shopify Markets Pro, you're given a globally unique identifier (GUID). If you're already using Markets Pro for live orders, then you can find your GUID in your Shopify admin by going to Settings > Markets > Preferences.
If you aren’t an existing Markets Pro user, then contact your sales representative to locate your GUID.
A GUID isn't the same thing as a merchant ID, a merchant account ID, or a merchant card processor account. If you need to provide one of these identifiers to a third party, then you can use your store ID instead. To get your store ID, contact Shopify Support.
Distinguish Markets Pro orders from domestic orders
Your fulfillment service must distinguish between domestic orders and international orders managed by Markets Pro. This is so domestic fulfillments are uninterrupted and international fulfillments will use the correct shipping and customs information.
You can correctly identify international orders managed by Markets Pro using the merchant_of_record_api_client_id. This attribute is available on the Shopify Order object. It can be accessed via Shopify webhooks, RESTful GET Orders calls or GraphQL queries. Version 2022-10 or later of the Shopify API is required for this field to be present. When Shopify Markets Pro is responsible for an order, this value will be set to 2745565185.
It's important that this attribute is set on every international order. Orders that don't have this set won't be managed by Shopify Markets Pro.
Fulfill Markets Pro orders with the correct label and customs information
All order information is available through Shopify’s first party Orders API. Shipping labels and customs information need to be retrieved using Global-e’s Shipping APIs. How to retrieve the correct shipping label and customs information can be found in this documentation.
It’s important that international orders use the correct shipping label and customs information. Incorrect labels can result in disruption to your payouts and a poor customer experience.
Management of existing orders
If your fulfillment service can cancel and recreate orders, then it must be created with the correct merchant_of_record_api_client_id so that the right label and customs information can be generated.