Brand GuideShopify Integration

Shopify Integration

Connect your Shopify store to sync products and push DPP data back to your product pages.

Requires: Pro subscription ($199/mo)

How it works

  1. Connect — provide your Shopify store domain and Admin API access token
  2. Sync — pull products from Shopify into Pasera (SKU matching, duplicates skipped)
  3. Push DPP — after publishing a DPP, push the QR code URL to a Shopify product metafield

Step 1: Get your Shopify Admin API access token

  1. In your Shopify admin, go to Settings → Apps and sales channels → Develop apps
  2. Click Create an app → name it “Pasera DPP”
  3. Go to Configuration → Admin API access scopes
  4. Enable these scopes:
    • read_products — to sync products
    • write_products — to push DPP metafields
  5. Click Install app
  6. Copy the Admin API access token (starts with shpat_)

Step 2: Connect in Pasera

POST /addons/shopify/connect
Authorization: Bearer <your-token>
X-Organization-Id: <your-org-id>
Content-Type: application/json
 
{
  "shopDomain": "your-store.myshopify.com",
  "accessToken": "shpat_xxxxx"
}

Or use the Shopify settings page in the brand portal (coming soon in UI).

Step 3: Sync products

POST /addons/shopify/sync

This pulls all products from your Shopify store and creates matching products in Pasera. Products are matched by SKU — existing products are skipped.

What syncs:

  • Product title → name
  • First variant SKU → sku
  • First variant barcode → gtin
  • Product type → subcategory
  • Category defaults to textile_apparel (editable after sync)
  • Shopify product ID stored for push-back

Step 4: Push DPP to Shopify

After publishing a DPP, push the QR code URL to the Shopify product:

POST /addons/shopify/push-dpp/<productId>

This creates a metafield on the Shopify product:

  • Namespace: pasera
  • Key: dpp_url
  • Type: url
  • Value: https://p.pasera.app/p/{gtin}/{serial}

You can then display this URL on your Shopify product page using Liquid:

{% if product.metafields.pasera.dpp_url %}
  <a href="{{ product.metafields.pasera.dpp_url }}">
    View Product Passport
  </a>
{% endif %}

API endpoints

MethodPathDescription
POST/addons/shopify/connectConnect Shopify store
POST/addons/shopify/syncSync products from Shopify
POST/addons/shopify/push-dpp/:productIdPush DPP URL to Shopify metafield