Skip to content

Faire wholesale

Faire wholesale connects your store to Faire, the wholesale marketplace where retailers order from brands. The screen describes the arrangement in one sentence: “Orders placed on Faire take their units out of this store’s stock, and this store’s stock is sent to Faire so retailers only order what you have.”

The screen is at /settings/integrations/faire. You reach it from Integrations until it is connected, and from the sidebar under Channels & apps after that. It needs the settings.manage permission and a CIQRA Commerce plan.

What the connection does, and what it does not

Section titled “What the connection does, and what it does not”
  • Stock flows both ways, in units. A Faire order takes its units out of your stock; your stock is sent to Faire. Stock changes in your store are sent to Faire “within a minute”, on top of the scheduled sync.
  • Products are matched by SKU. The status card counts Faire variants “matched by SKU” and those that have “no matching SKU”. A Faire variant whose SKU does not exist in your store is not linked to anything; the sync and order lists count it under Unmatched SKUs. Check SKUs on both sides before the first sync.
  • It is a stock link. The screen records Faire orders in its own Faire orders list with the units it took; it does not describe creating products on Faire for you.

The screen offers up to two ways in.

Connect with Faire (when your store offers it)

Section titled “Connect with Faire (when your store offers it)”

If the platform has its own Faire application set up, the connect card shows a Connect with Faire button above the form.

  1. Select Connect with Faire. Your browser leaves the admin for Faire.
  2. Approve the connection on Faire.
  3. Faire sends you back to the admin, to a page titled Connecting Faire that reads “Finishing the connection with Faire…”. It passes Faire’s approval to the platform once and then returns you to the Faire wholesale screen, now connected.

That return page is the address Faire sends merchants back to after approval, /settings/integrations/faire/callback. You do not open it yourself.

🔴 If the return page says “Faire could not be connected”, it shows the reason underneath and a Back to Faire settings button. The platform refuses an approval it did not start for this store — so a link reused from an earlier attempt, or opened in another store’s admin, ends here. Start again from Connect with Faire on the Faire screen.

The form: your own application or a brand token

Section titled “The form: your own application or a brand token”

The Connect Faire form works without the button above:

  1. Under Connection type, choose Faire application (OAuth) or Brand API token.
  2. For Faire application (OAuth), fill in Application ID, Application secret, Access token and, if you have one, Refresh token (optional). For Brand API token, only Access token is asked for.
  3. Optionally set Apply Faire orders created from. “Orders created before this moment are never taken out of stock. Leave blank to start from now.”
  4. Select Verify and connect.

“They are checked with Faire before anything is saved, and they are never shown again.” A wrong token is refused on the form, in the server’s words, and nothing is stored.

Choosing where orders start — the one decision to think about

Section titled “Choosing where orders start — the one decision to think about”

Apply Faire orders created from decides which Faire orders take stock. Leave it blank and only orders from now on count. Set it earlier and older orders are applied too.

Moving it earlier later has an effect, and the screen states it: “Moving this earlier applies the orders in between on the next sync.” If those orders were already deducted somewhere else — on a previous platform, or by hand — they are deducted again. Set the date once, deliberately.

The screen then shows a status card, a Schedule card, Recent syncs and Faire orders.

  • Status reads Syncing, Paused, Needs attention or Disconnected, with the last and next sync and the last stock update sent to Faire.
  • Sync now queues a sync, which “starts within a minute”. Pause and Resume stop and restart the schedule.
  • Schedule has Sync every (minutes) — “Between 15 and 1440” — and the order start date, saved with Save schedule.
  • Recent syncs lists each run with what started it (Scheduled, Sync now or Stock change), its outcome, orders applied, units taken, units short, stock updates sent and unmatched SKUs.
  • Faire orders lists each recorded Faire order with what happened to it: Taken from stock, Canceled — not taken, or Applied by the previous store for orders carried over from a store you moved from.

The status card turns to Needs attention with the heading “Faire refused this store’s credentials”: “Scheduled syncs are stopped until you reconnect. Enter a new access token below, or connect with Faire again.” The form reappears under it as Update Faire credentials. On that form, “Leave blank to keep the stored value.” applies to every secret box.

Disconnect asks first: “The credentials are removed and syncing stops. Orders already applied stay recorded, so reconnecting later never applies them twice.” That record is why disconnecting and reconnecting is safe for your stock.

  • It does not cover Faire’s own seller settings — pricing, minimums and retailer terms are set on Faire.
  • It does not promise the Connect with Faire button on every store. The button appears only where the platform’s Faire application is available; the form works either way.