Connect TikTok Shop to Square

This article walks you through connecting TikTok Shop and Square so they share product catalog, inventory, orders, and fulfillment through the app.

The app is the intermediary - there's no direct TikTok-to-Square integration. Data flows through Pipe17 in both directions.


What syncs

Data Direction Notes
Products App → Square Pushed to Square when Push product catalog updates to Square is on. The app doesn't pull products from Square.
Orders Square → App Pulled in from Square. Filterable by order type (POS, regular, or both) and status.
Order cancellations Square ↔ App Cancellations sync in both directions.
Inventory Square ↔ App Single dropdown controls direction: pull, push, or location-driven bidirectional.
Fulfillments App → Square Pushed out to Square after fulfillment.
Locations Square → App Pulled when Pull locations from Square is on. Physical locations only, unless Pull all locations is on.

On the TikTok Shop side, product, inventory, and fulfillment sync work normally - with one exception: pushing products to TikTok Shop is available only for US and UK regions. Outside those regions, maintain the TikTok Shop catalog in TikTok Shop directly.


Before you begin

Connect TikTok Shop first. See Connect TikTok to Pipe17.

Then gather the following for the Square setup:

  • The list of Square locations you intend to use, and which 3PL or warehouse each one should map to.
  • Catalog decision: Which platform is the source of truth - TikTok Shop, another connected channel, or both already populated with matching SKUs. Square can't be the catalog source, because the app doesn't pull products from Square.
  • Order decision: Whether you need POS orders (pickup or delivery), regular shipment orders, or both.

For more background, see Connect Square to Pipe17.


Step 1: Connect Square

  1. Navigate to Integrations and click Add integration. Search for Square and select it. The Connect Square pop-up opens.
  2. In Select Square environment, keep Production. Use Demo only with a Square sandbox test account.
  3. Click Connect and approve the connection in Square. The access token is populated automatically after OAuth - there are no credentials to enter manually.
  4. On Integrations, confirm the integration shows Connected with no errors.

For the full connection steps, see Connect Square to Pipe17.


Step 2: Configure TikTok Shop

If you haven't connected TikTok Shop yet, follow Connect TikTok to Pipe17 first.

  1. Open the TikTok integration. On the Settings tab, set Process product catalog updates to the option that matches your catalog source:
    • Pull products from Tiktok to Pipe17 - TikTok Shop is the catalog source. The app then pushes the catalog out to Square.
    • Push products from Pipe17 to Tiktok - another connected channel feeds TikTok Shop. US and UK only.
    • Disabled - when TikTok Shop and Square catalogs are maintained independently and you only need inventory and order sync.
  2. Click Save.
  3. Confirm both integrations show Connected with no errors.

Step 3: Choose your catalog source

The catalog source determines how product data flows between the two platforms. The Square connector only pushes products to Square, so Square can't be the source.

  • TikTok Shop as the source. Set TikTok Shop to Pull products from Tiktok to Pipe17, then turn on Push product catalog updates to Square on the Square integration to send products out to Square.
  • Both already populated. When products exist on both sides, the app matches them by SKU. Identical SKUs are linked automatically. You can leave product sync off on both integrations.
  • Another connected source. If your catalog originates from a third channel, connect that as the source and let it feed both TikTok Shop (US/UK only) and Square.

Pick one approach before pushing or pulling product data. Switching after products exist on both sides can produce duplicates or mismatched records.


Step 4: Match products by SKU

The app uses SKU as the unique identifier for product matching across channels.

  • Identical SKUs across Square and TikTok Shop are linked automatically.
  • Identical SKUs assigned to different products will be incorrectly merged. Audit your catalogs for SKU uniqueness before connecting them.
  • Square variations without a SKU will not match correctly. Set a SKU on every Square item and variation before connecting.

Map a channel SKU when it differs

If a product uses a different SKU in Square or TikTok Shop than in the app, map it on the product record. Both the Square and TikTok connectors support SKU mapping.

  1. Navigate to Products and open the product.
  2. Scroll to the Channel Options section. Each connected integration appears as a row with Integration Name, Sync to Channel, Inventory Buffer, and Channel SKU columns.
  3. In the Square row, the TikTok row, or both, enter the channel-specific SKU in the Channel SKU column.
  4. Save your changes.

The Channel SKU column is hidden on parent products with no channel SKUs set. Open a child or variant product to set values.

Optional: limit product push to specific SKUs

If you want to limit which products the app pushes to Square, use Process only products with specific SKUs on the Square integration. Only the SKUs you list will be processed.


Step 5: Set up locations

Square locations are pulled into the app through the Square connector.

  1. On the Square integration's Settings tab, turn on Pull locations from Square. To include online locations as well as physical ones, turn on Pull all locations.
  2. Click Save. Square locations appear under Inventory > Locations.
  3. For each Square-sourced location that should receive shipping requests, open it and set its 3PL Integration to the corresponding 3PL or warehouse integration. This determines where the Order Routing Engine sends orders for that location.

If you share fulfillment infrastructure between Square and TikTok Shop, point the matching locations to the same 3PL or warehouse. If Square uses separate fulfillment, link each location to its dedicated 3PL. If a Square location and a location created by your 3PL integration are the same warehouse, merge them. See Merging Locations.

See Using Locations for more on linking locations.


Step 6: Enable sync and configure behavior

On the Square integration's Settings tab, configure the sync settings.

Products

  • Turn on Push product catalog updates to Square if another source (such as TikTok Shop) feeds products to Square.
  • Leave it off if you maintain the Square catalog in Square.

Inventory

Under Process inventory information, select the option that matches your setup:

  • Disabled - no inventory sync.
  • Pull inventory from Square - Square is the source of truth for stock levels.
  • Push inventory to Square - the app is the source of truth.
  • Process inventory according to location attributes - bidirectional, driven by per-location settings.

Orders

  • Turn on Pull orders from Square to ingest Square orders into the app.
  • Under Order types to pull, select what to ingest:
    • POS ('pickup' or 'delivery') (default) - pickup or delivery orders.
    • Regular - shipment orders.
    • Both - both types.
  • Adjust the status filters if you need a different set:
    • Pull regular orders with these statuses only: - defaults to Open and Canceled.
    • Pull POS orders with these statuses only: - defaults to Completed.

Fulfillments

Turn on Push fulfillments to Square if you want the app to send fulfillment data back to Square after orders ship.

TikTok Shop side

Set up routing rules in Order Routing > Routing Rules so TikTok Shop orders route to the right fulfillment location. See Creating Order Routing Rules. Orders that TikTok ships (including FBT) come in only when Pull shipped by platform orders is on in the TikTok integration. They arrive already fulfilled and don't go through the Order Routing Engine.


Best practices

  • Decide your catalog source before pushing or pulling product data.
  • Audit SKUs for uniqueness across both platforms before going live. Duplicates cause silent mismatches.
  • Set a unique SKU on every Square item and variation before connecting. Square allows SKU-less items, but the app requires SKUs for matching.
  • Set up locations and routing rules before turning on Pull orders from Square.
  • Confirm the Order types to pull and status filters match what your operations team expects to see in the app.
  • For non-US/UK TikTok Shops, manage the TikTok catalog directly in TikTok Shop.
  • Test with a few products and orders before enabling full sync.

Troubleshooting

  • Square connection fails after authorization
    Reauthorize the app against your Square account. Make sure the Square user authorizing the connection has admin access to the locations and items you want to sync.
  • Square items aren't appearing in the app
    The Square connector doesn't pull products from Square. Products come into the app from another source, such as TikTok Shop, and match Square items by SKU.
  • Products aren't pushing to Square
    Confirm Push product catalog updates to Square is on. If Process only products with specific SKUs is set, verify the product's SKU is in the list. If totals or fields still look off, turn on Force product catalog resync to refresh.
  • Products aren't pushing to TikTok Shop
    Pushing products to TikTok Shop is available only for US and UK regions. If you sell outside the US or UK, manage the TikTok Shop catalog directly in TikTok Shop.
  • Products aren't matching across channels
    Check that SKUs match exactly - including case and any leading or trailing characters. If a Square or TikTok Shop SKU legitimately differs from the master SKU, map it in that row of Channel Options.
  • The wrong product is being matched
    Two different products likely share a SKU. Update the SKU on one of them and re-map through Channel Options if needed.
  • The Channel SKU column is hidden on a parent product
    Open a child or variant product to set channel SKUs.
  • Square orders aren't ingesting
    Confirm Pull orders from Square is on. Check that Order types to pull includes the type you expect (POS, Regular, or Both), that the status filters cover the statuses of the missing orders, and that the orders were created after Exclude orders created before this date.
  • Square orders are routing to the wrong location
    SKU matching links product records but does not control fulfillment routing. Check your rules in Order Routing > Routing Rules and confirm each Square location has the correct 3PL Integration.
  • Square isn't receiving fulfillment updates
    Confirm Push fulfillments to Square is on. Without it, the app does not send fulfillment data back to Square.
  • Square locations aren't appearing under Inventory > Locations
    Confirm Pull locations from Square is on. Online locations come in only when Pull all locations is on.
  • Square inventory totals look wrong
    Verify Process inventory information is set to the direction you expect (pull, push, or location-driven). If totals still look off, turn on Force inventory resync on the Square integration to refresh.
  • Inventory is updating for the wrong products
    Check whether Process inventory information only for products with specific SKUs is set on the Square integration. If the list is set, only those products receive updates.
  • A TikTok Shop order routed to the wrong location
    Review your rules in Order Routing > Routing Rules. SKU matching does not control routing.


Need Help?

If you need additional assistance:

  • Use Ask Pippen, our AI agent, located at the top of the platform page.
  • Submit a support request with as much relevant detail as possible. Learn how to submit a request.

We’re here to help you succeed with your operations.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.

Have more questions?
Submit a request
Share it, if you like it.