ReturnMate logoReturnMate
Commerce integration

Shopify + ReturnMate

ReturnMate installs as a native Shopify app. Orders, line items, customers, shipping addresses, fulfillment status, and inventory flow in over the Shopify APIs; refunds, replacement draft orders, notes, and tags flow back out. Every merchant integrates with Shopify — it's not optional, it's the spine.

§ 01 — Capabilities

What the integration does.

  • Shopify OAuth install with approved scope set
  • GraphQL + REST order, customer, product, and fulfillment reads
  • Refund creation with line-item restock flag and shipping refund
  • Draft order creation for replacements, upgrades, and repair quotes
  • Order notes and tags written back for finance + support visibility
  • Mandatory GDPR webhooks (customers/data_request, customers/redact, shop/redact) honoured within Shopify's timelines
  • Shopify Billing API for plan management with test/live modes
§ 02 — Use cases

How merchants use it.

Refund with restock in one click

When an admin resolves an RMA with a refund, ReturnMate calls the Shopify Returns API (with legacy refund fallback) to issue the refund, optionally restock the items to a nominated location, and optionally charge a restocking fee. The Shopify order shows the refund + restock as a single audited event.

Replacement with Cin7-matched variants

Replacement flows generate a draft order with the replacement variant_id, so downstream systems (Cin7 Omni, etc.) see a proper order and not a free-text line. Variant ID is resolved from the original line item so inventory systems match.

Draft order invoicing for repair quotes

Out-of-warranty repair quotes become Shopify draft orders. The customer pays via standard Shopify checkout, and the paid order tags back onto the RMA with the invoice URL archived for audit.

§ 03 — Setup

Connect Shopify in minutes.

  1. 1

    Install from the Shopify App Store

    Click Install; Shopify shows the scope approval screen. Approve. The admin redirects to ReturnMate with the shop provisioned.

  2. 2

    Configure return address

    Settings → Return Locations. The address used on shipping labels. Defaults are pulled from your Shopify shop address and can be edited.

  3. 3

    Pick your plan

    Settings → Billing. Shopify Billing handles payment; ReturnMate enforces RMAs/month, locations, and staff-user caps server-side.

§ 04 — FAQ

Questions about Shopify.

What Shopify scopes does ReturnMate request?

read_orders, write_orders, read_products, write_products, read_customers, read_fulfillments, write_assigned_fulfillment_orders, read_locations, write_price_rules, read_draft_orders, write_draft_orders, read_gift_cards, write_gift_cards, read_inventory, write_inventory, read_store_credit_accounts, write_store_credit_account_transactions, read_returns, write_returns.

Does ReturnMate work with Shopify Plus multi-store?

Yes. Each store installs ReturnMate separately; the Enterprise plan consolidates them under one subscription and one admin. Location-scoped RBAC enforces data isolation between stores.

How are customer GDPR requests handled?

ReturnMate subscribes to all three Shopify mandatory webhooks (customers/data_request, customers/redact, shop/redact). On receipt we either export, redact, or fully delete the relevant records per Shopify's published SLA.

Ready to connect Shopify?

14-day free trial. No credit card required. Billed through Shopify.