Shopify Connection Guide
GraphQL Admin API order/product sync, inventory quantity push and signed order/refund/inventory webhooks.
What this connector can sync
Capabilities depend on the scopes and endpoints approved for your seller account. The plugin does not mark the account Connected until its Test Connection succeeds.
Required account and credentials
Connection type: Official Api
Use a seller/developer account owned by your business. Request only the scopes required for orders, products, inventory, fulfilment, returns or settlements.
OAuth callback URL:https://gstkhata.com/wp-json/agbp/v1/marketplace/oauth/callback/shopify
Webhook URL: Open Marketplace Connections, save the account, then copy its unique Webhook URL.
Step-by-step setup
- Create a Shopify custom app or authorised public app.
- Grant the required Admin API scopes for orders, products, inventory, fulfilments and returns.
- Install the app and copy the Admin API access token.
- Enter the myshopify.com domain, token, API version and default location GID.
- Run Test Connection, map SKUs, then enable webhooks and inventory push.
SKU and warehouse mapping
Match priority is seller SKU → variant SKU → barcode/EAN/UPC → platform listing ID → product SKU. Unmapped items remain quarantined and never deduct stock automatically.
- Map each marketplace facility/store to a plugin warehouse or rack.
- Set safety stock buffer and stock deduction stage.
- Confirm service/digital items as non-shippable.
- Run the first sync and inspect Stock Reservations before dispatch.
Orders, labels, returns and settlements
Official label/AWB is used when supplied by the authorised marketplace API. The built-in packing label is a fallback and is not presented as a marketplace-approved carrier label.
- Order import creates an idempotent shipment record.
- Mapped physical items reserve stock.
- Cancellation releases reservation.
- Accepted sellable return may restore stock; damaged return remains quarantined.
- Fee and payout data is sent to existing reconciliation reports when the API exposes it.
Common errors
401 / Invalid Token
Refresh/re-authorize the token and verify scopes.
403 / Access Denied
Seller account or API role is not approved for the endpoint.
Unmapped SKU
Map the seller SKU before enabling automatic stock deduction.
Webhook rejected
Check HTTPS, signature secret and duplicate/replay protection.