Square Connection Issues
A healthy Square connection is what lets Bitship see your catalog and receive orders. Here’s how to fix the common issues.
Understanding your connection status
Section titled “Understanding your connection status”Your Account page shows your Square Integration status:
| Status | What it means |
|---|---|
| Connected | Everything is working — you’ll see your Square business name |
| Disconnected | No Square account is linked yet |
| Revoked | Access was revoked, usually from the Square side |
| Invalid token / needs reconnection | Your authorization expired or is no longer valid |
| Error | Bitship couldn’t reach Square to check status |
Anything other than Connected means Bitship can’t see your catalog or receive orders.
Reconnect Square
Section titled “Reconnect Square”- Go to your Account page.
- Click the Connect/Reconnect button next to Square Integration.
- Sign in to Square and approve the connection again.
Once the status turns green Connected, Bitship can see your catalog and receive orders again. See Connect Your Square Account.
I can’t authorize Bitship in Square
Section titled “I can’t authorize Bitship in Square”Make sure you’re signing in as the account owner or an admin allowed to authorize third-party apps for your Square business.
My Square item isn’t showing up when creating a product
Section titled “My Square item isn’t showing up when creating a product”Bitship reads your item list live from Square each time you open the product form. If an item is missing:
- Confirm your Square Integration status is Connected.
- Confirm the item exists in your Square item library (not just a draft) — the product form links directly to it.
- Refresh the page after creating a new item in Square; it should appear on the next load.
Orders aren’t triggering deliveries
Section titled “Orders aren’t triggering deliveries”If purchases aren’t producing deliveries, check:
- The purchased item has a matching product in Bitship. See Create a Product.
- Your Square Integration status is Connected.
- The order actually went through in Square (not just started).
If everything above checks out and it’s still not working, see Order Not Delivered.
I connected the wrong Square account
Section titled “I connected the wrong Square account”Go to your Account page and reconnect — signing in with the correct Square account replaces the existing connection.
Still stuck?
Section titled “Still stuck?”Email nick@bitship.app with your account email and a description of what you’re seeing.