Skip to main content
Connect Zid so your AI agent sells from your live Zid catalog, creates orders in Zid with cash on delivery, bank transfer or a payment link, tracks orders with shipping details, and keeps your customer list current. If you buy Popcorn through the Zid App Market, the subscription is applied to this workspace through the same connection.

Before you start

  • A Zid store you can sign in to.
  • A Popcorn role that can manage integrations (Owner or Admin).
  • Allow pop-ups for Popcorn: the authorization opens in a pop-up window.

Connect from Popcorn

1

Open Integrations

Go to Integrations and click Connect on the Zid row.
2

Approve access

A pop-up opens on Zid. Sign in and approve the access request.
3

Wait for confirmation

The pop-up closes on its own. Popcorn shows Zid connected and the row reads Connected. If the pop-up closes without connecting, you see Couldn’t connect to Zid. Try again. Click Connect again.

Connect from the Zid App Market

Installing Popcorn from the Zid App Market brings you to a Popcorn page titled Connect your Zid store (“Link your Zid store so your agent can answer questions about your products and orders.”). If you are not signed in, Popcorn asks you to sign in first.
1

Click Connect Zid

A pop-up opens on Zid and the page reads Waiting for Zid (“Finish signing in to Zid in the window that opened.”). Approve the connection in Zid, and the pop-up closes by itself. Keep the page open until you’re done.
2

Wait for confirmation

On success the page shows Zid connected and takes you to Integrations (“After connecting, we’ll take you to Integrations.”). If it shows Zid isn’t connected yet, read the reason under it, such as “The window closed before Zid finished connecting. Try again and approve the connection in Zid.”, and click Connect Zid again, or use Go to integrations and connect from the Zid row.
If your browser blocks the pop-up, the page says “Your browser blocked the Zid window. Allow pop-ups for this site and try again.” The page also lists what to try under If nothing happens, and Contact support under Need help?

What happens when you connect

  • Popcorn saves your store ID and store URL.
  • Popcorn asks Zid whether your prices include VAT and starts from that answer on a first connect. A VAT choice you made yourself is never overwritten by a later read.
  • Popcorn subscribes to Zid notifications for product creation, updates, publishing and deletion, for new orders and order status and payment changes, and for customer creation and updates. Once a day Popcorn re-checks the order notifications it uses to keep stock current and restores any that are missing.
  • A full product import and a full customer import start in the background. The row shows Resyncing products… until the product import finishes.
  • Popcorn reads your Zid delivery options and payment methods, and reads them again every hour. See Checkout and payment and Shipping methods.
  • Any Zid App Market subscription events received before the store was connected are applied now.
  • Active automated campaigns get their Zid triggers re-registered, so Reconnect also repairs campaigns that stopped firing.

What syncs

Products
  • Name, description, images, product link, keywords, price and sale price. A sale price is used only while its sale period is active.
  • Every product needs a SKU. Products without a SKU are skipped and do not appear in Popcorn.
  • A published product is active in Popcorn only when Zid lists it at a location that sells on your website, whatever the quantity there. This doesn’t depend on Product quantities. A product listed only at locations that sell through Zid Cashier (your branch tills) or on marketplaces stays inactive, because shoppers can’t buy it on your website. A variant is judged by its own locations. If Popcorn can’t read where your locations sell, products are saved as Zid lists them.
  • A parent product with variants is not sellable itself; its variants are the sellable products, and they inherit the parent’s images and link when they have none of their own.
  • Stock is the quantity at locations that sell on your website. Stock marked as infinite is treated as always available.
  • Zid custom option fields and custom user input fields become product custom options, so the agent asks for them during checkout. See the synced catalog.
Customers
  • Name, mobile number, email, city and country, and tags.
  • Each imported customer shows Zid as its source on the customer profile. See customers.

VAT for Zid prices

Popcorn stores final customer prices, so it needs to know whether the prices in Zid already include VAT. Zid tells it, and you can say otherwise. Click the gear icon on the Zid row to open Zid settings (“Zid tells your agent whether your prices include VAT.”). The gear shows only to roles that can edit settings. Popcorn asks Zid every time the dialog opens (“Checking with Zid”), then shows one of these: To choose yourself, click Not right? Choose it yourself. Under Prices in Zid, choose Include VAT (your agent quotes each price as it is in Zid) or Don’t include VAT (your agent adds the VAT rate when it quotes a price), and for the second enter the VAT rate (%), for example 15 (“A number, like 15.”). Click Save. You see VAT saved, or VAT saved. Prices in your catalog are being updated. when the change affects prices; Popcorn reprices your catalog in the background. Settings → General also has a VAT panel. With Zid connected it says “VAT is set in your Zid settings” and Open Zid settings takes you to this dialog.

Ongoing updates

Zid access tokens are refreshed automatically. If Zid stops renewing or accepting Popcorn’s access, the Zid row shows Connection lost, your Owners and Admins get one email, product, stock, delivery and payment updates stop, and the agent hands order questions to your team. Click Reconnect on the Zid row and authorize again. See When a store’s connection is lost. Zid also checks the permissions of the Zid user who connected the store, whatever the app was approved for. If that user lacks one, such as permission to view orders, Zid refuses those requests: for example, products sync but the agent can’t look up orders. Store health then shows Store account lacks permission, and View details says what Zid refused (for a sync, which permission is missing). Click Reconnect on the Zid row and approve with the store owner’s Zid account, or give the user that connected the store the permission in Zid. See Store health.

Checkout and payment

When the agent completes a sale, Popcorn creates the order in Zid using the payment method the customer chose: Cash on delivery, Bank transfer or Payment link (Zid Pay). Each is matched to the corresponding payment method in your Zid store, and a method counts only when Zid has it turned on. A Zid payment link created by Popcorn expires 24 hours after it is created.
  • Payment methods come from Zid. Settings → Payment shows Payment link, Cash on delivery and Bank transfer as your Zid store has them, read when you connect and every hour after. Change them in Zid, or click Check now to read them at once. A method off in Zid reads Off in Zid and is never offered.
  • Cash on delivery is offered only where one of your Zid delivery zones takes it, with the zone’s cash on delivery fee.
  • Bank transfer needs the account customers pay into. When it is on in Zid, add the account details under Bank transfer in Settings → Payment and save; until then the agent doesn’t offer it.
  • No method on means no order. If Zid has every payment method off, the agent doesn’t create the order: it tells the customer your team will confirm how they can pay, and hands the conversation over.
  • Fees as Zid charges them. When your Zid checkout adds VAT on top of a delivery fee or a cash on delivery fee, the agent quotes the fee with that VAT, so the summary matches what the customer pays. Popcorn takes this from your Zid tax settings; if it can’t read them, it learns the VAT from the first Zid order that uses the fee, so that first quote can be short of it.
When the customer taps Confirm order, Popcorn checks each product in Zid again, including that it still has stock for your website. If one is no longer for sale, the order isn’t created and the customer is told their cart changed and gets a fresh summary. Zid prices the order when it is created: any automatic (store-wide) discount that the cart qualifies for is applied, and a discount code the customer gave is applied on top. The confirmation message gives the customer Zid’s own order number and the total Zid reports. The order in Popcorn shows that total, with the delivery and cash on delivery fees as Zid charged them, so it can be lower than the summary the customer confirmed; a fully discounted order shows a total of 0. See shipping and payment and orders.

Shipping methods

Your delivery comes from Zid. Settings → Shipping shows Delivery from Zid, read when you connect and every hour after; change delivery options, zones and fees in Zid, or click Check now to read them at once. Zid prices each delivery option by zone, so a delivery option with several zones is listed once per zone, each with:
  • the cities the zone covers,
  • the fee Zid sets for the zone (a zone priced by weight shows “Priced by Zid at checkout” or its first price with “Up to N kg; heavier costs more”),
  • the zone’s cash on delivery terms: Cash on delivery fee with the amount, Cash on delivery, no fee, or No cash on delivery,
  • its delivery time when Zid names one.
A zone you turn off or remove in Zid is shown as Off in Zid, and the agent stops offering it. A delivery option Popcorn couldn’t read this time keeps what it had. You can set one Free delivery amount in Popcorn: orders at or over it get free delivery with every delivery option. At checkout the agent charges the zone’s own fees, and won’t take a cash on delivery order for a zone that doesn’t accept it: it offers the delivery options to that city that do, or another payment method. When a zone has a note in Zid, the agent reads it and picks the option that fits the customer. Cities are matched by Zid’s own city list, so a town Zid writes with its governorate still matches. See how the agent uses shipping.

Order tracking

When a customer asks about an order, the agent looks it up in Zid by order number (Zid’s, or Popcorn’s own “P” number from Orders) and checks that the customer’s phone number matches the order; a mismatch is refused. If the number finds none of that customer’s orders, the agent looks up the orders on their phone number instead. With only a phone number, it finds the customer’s five most recent orders. Either way, each order’s answer can include the order status, shipping method, estimated delivery, tracking number and tracking link, delivery status and the order’s history. Switch on Track orders on the agent’s Actions tab to use this; see agent capabilities.

Events for automated campaigns

These Zid events are available as triggers when you create an automated campaign: For abandoned-cart messages, Popcorn checks whether that customer has placed an order since the cart was abandoned and skips the message if they have.

Subscription through the Zid App Market

If you buy a Popcorn plan in the Zid App Market, Zid notifies Popcorn and the plan is applied to the workspace whose connected Zid store matches. Popcorn recognises the Cheese plan (monthly and yearly) and plans named Salt or Cheese; a plan it does not recognise is treated as the free plan. If you subscribe before connecting the store in Popcorn, the subscription is held and applied as soon as you connect. While Zid bills your plan, Plan and billing says Billed through Zid: renew, change or cancel the plan in Zid. Credits you top up in Popcorn are still charged to your card. When the plan has run out, Renew in Zid opens your store’s sign-in for Popcorn AI, and the plan turns back on once Zid confirms it. See plans and credits and top-ups and renewal.