Square Integration

---

​

Prerequisites

Before connecting Square to Jetpack, ensure you have:

• Active Square account with admin access
• Square Online Store or Square POS with online ordering enabled
• Jetpack merchant account with login credentials

---

​

Connecting Square to Jetpack

The Square integration connects through Jetpack’s App Store using OAuth authentication. This process involves two connection steps: first connecting to ShipBob’s integration infrastructure, then authorizing Square to share data with Jetpack.

---

​

Configuring Your Integration

On the configuration screen, you can configure: Setup Locations (mandatory): Select each active Square location whose data you want to sync. Data to sync: Check the boxes for Products, Orders, and Tracking Information.

• We recommend that you sync Products first and verify they import correctly before enabling Orders.

Start Shipping Date: Choose the date Jetpack will begin importing and fulfilling orders (up to 120 days in the past or a future date). When finished editing configurations, click Next.

---

​

Configuring Sync Schedule

---

​

Ship Option Mapping

Before Jetpack can fulfill orders, you must map your Square shipping methods to Jetpack ship options. This ensures orders ship using the correct carrier service based on the customer’s selection at checkout. Learn how to configure Ship Option Mapping here.

---

​

Verifying Your Integration

After installation and configuration, create a test order to verify the integration is working correctly:

---

​

What Syncs Automatically

Once connected, Square and Jetpack exchange data automatically to keep your operations running smoothly.

​

Product Syncing

When you connect Square to Jetpack, all active items in Square sync to Jetpack’s Product Catalog immediately. Product syncing includes: All synced products appear in your Product Catalog, where you can configure additional fulfillment settings as needed.

​

Order Importing

Square orders are imported to Jetpack based on your configured sync schedule (every 30 minutes, hourly, or daily). The integration captures all the information Jetpack needs to fulfill your orders: What doesn’t sync:

• In-person POS transactions without shipping
• Pickup orders
• Canceled orders

​

Inventory Syncing

Jetpack syncs available inventory back to Square based on your configured sync schedule whenever inventory levels change. Inventory updates are triggered by:

• Receiving new inventory at Jetpack
• Fulfilling orders
• Inventory adjustments
• Returns processing

​

Tracking Number Syncing

When Jetpack ships an order, tracking information syncs back to Square automatically:

• Tracking number is added to the order in Square
• Order status updates to “Fulfilled” or “Shipped”
• Square sends shipment notification email to customer with tracking link

The tracking sync includes carrier name, tracking number, and shipment date, giving your customers complete visibility into their order status.

---

​

Working with Product Variations

Square item variations (such as different sizes or colors) integrate seamlessly with Jetpack:

• Each variation is treated as a separate SKU in Jetpack
• Variation names are appended to the item name in Jetpack
• Inventory is tracked separately for each variation

This ensures accurate inventory management and fulfillment for all your product options.

---

​

Order Notes and Gift Messages

Order Notes sync from Square to Jetpack and are visible in order details, helping your fulfillment team process orders with special instructions. Gift Messages can be included on packing slips with configuration. Contact Jetpack Care if you need gift messages to appear on packing slips for your Square orders.

---

​

Handling Split Shipments

If an order ships from multiple Jetpack fulfillment centers or in multiple packages:

• Each shipment is updated in Square separately
• Each tracking number is added to the order
• Customer receives separate notifications for each shipment

This ensures customers have complete tracking information for all packages, even when orders are fulfilled from different locations.

---

​

Processing Returns

Jetpack does not automatically create return orders in Square. To process returns for Square orders:

1. Create the return order in Jetpack (manually or via API)
2. Once processed, manually create a refund in Square

Learn more about setting returns preferences in your Jetpack account.

---

​

Disabling the Integration

If you need to disconnect Square from Jetpack, you can disable the integration through the App Store.

---

​

Square Integration Features

Here’s a complete overview of what the Square integration supports:

---

​

Square Integration FAQs

What types of Square orders are imported to Jetpack?

Only online orders from Square Online Store or online ordering via Square POS are imported to Jetpack. In-person POS transactions are not imported unless they include online shipping with a delivery address.Orders with “Open” or “Unfulfilled” status are imported based on your configured sync schedule.

How do I handle multiple Square locations?

If you have multiple Square locations, Jetpack can sync inventory to a specific location. Contact Jetpack Care to configure which Square location should receive inventory updates from Jetpack’s fulfillment centers.

Why isn't my Square inventory updating?

Inventory syncs from Jetpack to Square based on your configured sync schedule (every 30 minutes, hourly, or daily). If your Square inventory isn’t updating:

• Verify the integration shows as “Connected” in your Jetpack dashboard
• Check that you’ve configured the correct Square location (if you have multiple locations)
• Verify your sync schedule is not set to “Pause”
• Contact Jetpack Care if inventory hasn’t synced after the expected time

Can I sync historical orders from Square?

The Square integration imports new orders placed after the Start Shipping Date you configured during setup. Historical orders placed before this date are not automatically imported.If you need to fulfill historical Square orders through Jetpack, you can manually create orders or use bulk order import.

How do split shipments appear in Square?

When an order ships from multiple Jetpack fulfillment centers or in multiple packages, each shipment is updated in Square separately. Each tracking number is added to the order, and your customer receives separate shipment notifications for each package.This is common when using MultiHub IQ or when inventory is split across fulfillment centers.

Can I change my sync schedule after initial setup?

Yes, you can adjust your sync schedule at any time by navigating to Integrations > App Store > Square > Connection Settings and selecting a different frequency option (every 30 minutes, hourly, daily, or pause).

---

​

Let’s Dive Deeper