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.
What happens when you connect
- Popcorn saves your store ID and store URL.
- Popcorn asks Zid whether your prices include VAT and which payment methods the store accepts, and starts from those answers. A 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.
- 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.
- Published products are active in Popcorn. 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 comes from Zid stock levels. A product marked as infinite stock 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.
- 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 reports that the stored credentials are no longer valid, Popcorn clears them and syncs, orders and tracking stop working until you click Reconnect (or Connect) on the Zid row and authorize again.
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.- Popcorn starts from what Zid accepts. When you connect, Popcorn reads which of the three your store takes and offers only those. It also reads the cash on delivery fee Zid adds, when Zid names a single amount, and includes it in quotes.
- Your own choice wins. Once you change payment methods under Settings → Payment, a later read of Zid never overwrites them, and an order for a method you have turned off is refused. A method your Zid store has turned off is never used on an order, even when Zid still lists it.
- No method on means no order. If Zid has every payment method off, or you turn them all 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.
Shipping methods
Under Settings → Shipping, click Sync from store to open Sync shipping from your store and import your Zid delivery options. Each option arrives with its name, active status and the cities it covers. Zid does not provide fees or delivery times, so enter the fee and delivery time for each method you choose, then click Sync methods. Your agent quotes that fee as a starting price, and Zid’s checkout shows the exact total.Order tracking
When a customer asks about an order, the agent looks it up in Zid by order number, or by the customer’s phone number to find their recent orders. The 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. See plans and credits and top-ups and renewal.