Social Stream Ninja
English
EnglishEspañolPortuguês (Brasil)РусскийFrançaisDeutsch日本語简体中文繁體中文ItalianoPolski한국어УкраїнськаالعربيةTürkçeČeštinaไทย

Show your Shopify products and purchases.

Show products with a QR code. Get an alert when someone buys.

Show a Shopify product in 5 steps

  1. In Social Stream Ninja, open Monetization → Shopify purchases → Setup.
  2. Type your store address, like your-store.myshopify.com. No secret needed.
  3. Open Import a product, paste the product's public link, and click Load product details.
  4. Check the name, picture, price, and link. Then click Add product or link.
  5. Turn on Products & support links and click Save setup.
Imported Shopify product name, image URL, price and canonical public link in the shared product editor
The product details load into the editor so you can check them first.
Product won't load? Add a Public Storefront token (make one with Shopify's Headless channel, and publish the product there and to the Online Store). Never paste an Admin API or private token.
What the import fills in
  • It loads one product at a time.
  • The token is used for that one request, then cleared.
  • The link is Shopify's public store link, including your custom domain if Shopify gives one.
  • The price is only filled in when every variant costs the same. Otherwise it stays blank. Only add a price if it's accurate.
  • It's a snapshot. Prices and stock don't update by themselves, so check it when your store changes.
  • Unavailable products, and products without a public Online Store link, can't be imported.
  • You can always type a product in by hand instead.

Shopify Storefront authentication · Product query · Creating a public token using Headless

Get an alert when someone buys

Not switched on yet. Purchase alerts need the Shopify receiver on the SSN server, which stays off until it passes a real-store test. Until then, Save setup shows an error. Showing products still works.
  1. In Shopify, go to Settings → Notifications → Webhooks. Find the webhook signing secret. (This is not a Storefront token.)
  2. In Social Stream Ninja, open Monetization → Shopify purchases → Setup.
  3. Enter your myshopify.com address and the signing secret.
  4. Turn on Shopify purchases and click Save setup.
  5. Click Copy receiver URL.
  6. In Shopify, create a webhook. Event: Order payment. Format: JSON. URL: the receiver URL.
  7. Pick a stable API version and save. (SSN was built against 2026-07.)
  8. Keep Social Stream Ninja running.
SSApp Shopify setup with store domain, cleared signing secret, receiver URL and status
Shopify setup in the app, using an example store. Click to enlarge.
Is it working? Watch the status line: waiting, test received, event skipped, or purchase received. A receiver URL only means setup was saved.
I want to…Do this
Pause alertsTurn off Shopify purchases.
Stop for good, or switch storesClick Disconnect Shopify (deletes the receiver and waiting events). Delete the webhook in Shopify too.
Where your secret goes
  • The signing secret is stored encrypted on the SSN receiver. The box clears after you save.
  • A separate private reader key stays on this computer.
  • Neither one is ever put in OBS links or viewer QR codes.
  • The receiver checks Shopify's signature and your store name before it accepts an order.
  • Shopify has its own receiver, so you don't need the older remote API control switch.

Shopify: manually creating webhooks · Shopify: verifying deliveries

Put it in OBS

  1. Under OBS overlay for, choose Products & support links.
  2. Open Overlay link options and pick an Overlay view: Product showcase only (pictures, prices, QR codes), Support card only (a small shop link), or Activity alerts only (purchases).
  3. Click Copy OBS link. Add it to OBS as a Browser Source, starting at 800 × 600. Use one source per view.
  4. Scan the QR code with your phone at your final stream size.
Shopify purchase alert with Anonymous buyer and public product title
A purchase alert. The buyer's name stays private.
I want to…Do this
Share a product link in chatClick Copy public link next to the product.
Show only Shopify alerts in the Monetization overlaySet Alert source filter to shopify. Products & support links must be on.
Show purchases in multi-alerts or the activity feedNothing extra. They get Shopify purchases even without the product list.
Why no picture on purchase alerts? Shopify orders don't include a reliable image, so alerts are text only. They never borrow a product card's picture or QR code.
Event Flow and donation goals
  • In Event Flow, choose Event Type purchase and filter the source/type to shopify.
  • For order-value rules, compare meta.commerce.orderTotal. Check meta.commerce.currency first.
  • Purchases are not donations. They have no hasDonation or donoValue, and donation goals don't go up.
  • A product card labelled Gift doesn't change how orders are counted. Shipping to someone else doesn't make it a gift to you.

Test safely

Click Preview sample to see the look. It's not connected to your session, so it never runs Event Flow, changes totals, or checks a payment. For a full test, use a Shopify development store. Orders marked test: true show in the status only, with no alerts.

Careful with Shopify admin samples. If one isn't clearly marked as a test, don't send it to a setup that gives out rewards.
What has been tested without a real store

Tests in the real app cover signed messages (including non-English text), tampered signatures, repeat deliveries, test orders, currency rounding, oversized requests, removal of private customer data, and catching up after being offline. No real orders or merchant account were used.

Shopify CLI sample webhooks can test message handling, but not subscriptions or retries, and they still need app credentials. See Shopify CLI webhook testing limits.

Fix problems

ProblemTry this
Save setup shows an errorThe receiver isn't on at the server yet. Don't use the old session webhook URL instead.
Status stays on waitingCheck the webhook: Order payment, JSON, exact receiver URL, myshopify.com address, and secret. Custom app webhooks use the app's own secret.
Event skippedOnly fully paid orders above zero, marked test: false, and updated in the last 7 days count. Unpaid, part-paid, and cancelled orders are skipped.
SSN was off during a saleOrders wait up to 7 days. Start SSN and they come through.
An action ran twiceRepeats are blocked for 7 days, but a crash mid-action can repeat it. Add your own check for important automations.
No buyer nameOn purpose. Names, emails, addresses, notes, custom fields, checkout links, and order IDs are never shown.
A refund didn't remove the alertRefunds, cancellations, and edits don't undo alerts. This isn't bookkeeping.
How waiting and repeat orders work
  • Order times may be up to five minutes in the future (clock drift).
  • Payment is never guessed from order creation, shipping, or stock changes. A missing test flag is skipped.
  • Status and waiting orders survive a receiver restart.
  • Storage is limited. If the receiver can't safely store an order, it asks Shopify to send it again later.
  • Repeats are matched by store and order, even if Shopify's delivery IDs differ.
  • SSN saves which orders it handled before confirming them.

See the Shopify event details and the product and QR code guide.