Connect TikTok Shop to Square

What syncs

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 - Square, TikTok Shop, or both already populated with matching SKUs.
• 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. Add the Square connector from the connector catalog if it isn't already under Integrations.
2. Open the Square settings. Under Select Square environment, choose Production or Demo.
3. Save the configuration.
4. Open the Connection Details tab and click Connect to authorize the app against your Square account. The access token is populated automatically after OAuth - there are no credentials to enter manually.
5. Confirm the integration shows as connected with no errors.

Step 2: Connect TikTok Shop

1. Open the TikTok Shop settings. Under Products → Process product catalog updates, pick 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 - Square (or another connected source) 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. Open the Connection Details tab and click Connect to complete OAuth.
3. Confirm both integrations show as connected with no errors.

Step 3: Choose your catalog source

The catalog source determines how product data flows between the two platforms.

• Square as the source. Enable the Square product pull setting. The app ingests the Square catalog and can push it to TikTok Shop (US and UK only).
• TikTok Shop as the source. Set TikTok Shop to Pull products from Tiktok to Pipe17, then enable Push product catalog updates to Square on the Square connector 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.
• 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 Square SKU when it differs

If a product uses a different SKU in Square than in the app, map it on the product record.

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, enter the Square-specific SKU in the Channel SKU column.
4. Save your changes.

• The Channel SKU column does not appear on the TikTok Shop row. The SKU coming in from TikTok Shop must match the app's master SKU.
• The Channel SKU column is hidden on parent products with no channel SKUs set. Open a child or variant product to set values.

Optional: scope product sync to specific SKUs

If you want to limit which Square products participate in sync, use Process only products with specific SKUs on the Square connector. 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 connector, enable the location pull setting.
2. Save the configuration. Square locations appear under Inventory → Locations.
3. Open each Square-sourced location and link it 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.

See Using Locations for more on linking locations.

Step 6: Enable sync and configure behavior

On the Square connector, configure the sync settings.

Products

• Enable the product pull setting if Square is your catalog source.
• Enable Push product catalog updates to Square if a different source (such as TikTok Shop) is feeding products to Square.
• Pick only one direction. Switching after the fact can produce duplicates.

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

• Enable Pull orders from Square to ingest Square orders into the app.
• Under Order types to pull (ordersToPull), select what to ingest:
  • POS (default) - pickup or delivery orders.
  • Regular - shipment orders.
  • Both - both types.
• Adjust the status filters if you need a different set:
  • Regular order statuses (ordersNonPosPullStatuses) - defaults to OPEN and CANCELED.
  • POS order statuses (ordersPosPullStatuses) - defaults to COMPLETED.

Fulfillments

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

TikTok Shop side

Configure location preferences on the TikTok Shop connector so orders route to the right fulfillment destination. TikTok-fulfilled orders (TTS or FBT) come in as 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.
• Link every Square location to a 3PL or warehouse before enabling order sync.
• 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
  Confirm the product pull setting is enabled on the Square connector and that items in Square have SKUs assigned. If Process only products with specific SKUs is configured, verify the missing item's SKU is in the list.
• Products aren't pushing to Square
  Confirm Push product catalog updates to Square is enabled on the Square connector. If totals or fields still look off, enable 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 SKU legitimately differs from the master SKU, map it in the Square 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 missing on the TikTok Shop row
  Expected. TikTok Shop doesn't support per-channel SKU mapping. The TikTok SKU must match the master SKU in the app.
• 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 enabled. Check that Order types to pull includes the type you expect (POS, Regular, or Both), and that the status filters cover the statuses of the missing orders.
• Square orders are routing to the wrong location
  SKU matching links product records but does not control fulfillment routing. Confirm each Square location is linked to the correct 3PL or warehouse.
• Square isn't receiving fulfillment updates
  Confirm Push fulfillments to Square is enabled. Without it, the app does not send fulfillment data back to Square.
• Square locations aren't appearing under Inventory → Locations
  Confirm the location pull setting is enabled on the Square connector.
• 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, enable Force inventory resync on the Square connector to refresh.
• Inventory is updating for the wrong products
  Check whether Process only products with specific SKUs is configured on the Square connector. If the list is set, only those products receive updates.
• A TikTok Shop order routed to the wrong location
  Review the location configuration on the TikTok Shop connector. 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 app page.
• Submit a support request with as much relevant detail as possible. Learn how to submit a request.
• For urgent issues, email us directly at support@pipe17.com.

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