Todifit
Back to Help

Todifit Retailer Documentation

Square integration guide

Square OAuth lets a retailer connect their item catalog and inventory so Todifit stock stays aligned with their POS.

Data accessed

  • Square item catalog data, including item names, variations, prices, and option details needed for Todifit products.
  • Inventory counts needed to show accurate stock to shoppers.
  • Merchant location information needed to apply inventory changes to the right location where available.

OAuth scopes

Todifit requests Square scopes MERCHANT_PROFILE_READ, INVENTORY_READ, INVENTORY_WRITE, ITEMS_READ, and ITEMS_WRITE.

  • MERCHANT_PROFILE_READ: read merchant/location information for inventory operations.
  • INVENTORY_READ: read current inventory counts.
  • INVENTORY_WRITE: push inventory deductions and restocks.
  • ITEMS_READ: import catalog items and variations.
  • ITEMS_WRITE: maintain catalog mappings and compatible item updates where needed.

How retailers connect and use it

  1. Open Stock & POS in the retailer dashboard.
  2. Choose Square.
  3. Approve the requested permissions on Square-hosted OAuth screens.
  4. Return to Todifit and sync the catalog.
  5. Use Square as the ongoing source for catalog and stock updates.

Functional implementation overview

Todifit stores a retailer-specific Square OAuth token server-side and uses the Square adapter in the integrations service. Full sync imports mapped item variations into Todifit, scheduled syncs reconcile stale variants, and sale/refund stock changes are pushed back through Square inventory APIs.