Integración Square + Medusa.js
La única integración bidireccional publicada de Square para Medusa v2. Sincronización de catálogo, inventario, pagos (Apple Pay, Google Pay), OAuth y una extensión de UI para el panel de administración — en un solo paquete npm.
Todo lo que maneja el medusa-square-plugin
Products, variants, prices, and inventory sync between Square and Medusa in both directions. Square catalog changes propagate to Medusa via webhooks. Medusa catalog changes push to Square via the Catalog API. Conflict resolution is configurable.
Square Web Payments SDK integrated into Medusa checkout. Card payments, Apple Pay, and Google Pay all handled through Square — single integration, all payment methods. Payment confirmation creates the Medusa order automatically.
Merchants connect their Square account via OAuth directly in the Medusa admin panel. The admin UI extension shows connection status, sync health, and allows manual re-sync — no engineering required for ongoing operations.
Detalles de la arquitectura del plugin
Patrón de módulo Medusa v2
El plugin sigue las convenciones de módulo de Medusa v2: patrón MedusaService, StepResponse en workflows, idempotencia en subscribers. Extiende Medusa correctamente — sin modificaciones al núcleo, con compatibilidad total para actualizaciones.
Flujo Square OAuth
El plugin implementa Square OAuth a nivel del servicio de Medusa. Los comerciantes autorizan el acceso mediante el flujo OAuth de Square; el token de acceso se almacena en GCP Secret Manager (no en la base de datos). El plugin gestiona la renovación del token de forma automática.
Procesamiento de webhooks
Los webhooks de Square para actualizaciones de catálogo, cambios de inventario y eventos de órdenes son procesados por un microservicio dedicado en Cloud Run. El microservicio valida las firmas HMAC, elimina duplicados y reenvía los eventos verificados a los subscribers de Medusa.
Soporte multi-tenant
El plugin admite múltiples cuentas de comerciante de Square en una sola instancia de Medusa — necesario para arquitecturas de marketplace donde cada vendedor tiene su propia conexión Square OAuth.
Extensión de UI para el panel de administración
Una extensión del panel de administración de Medusa construida con @medusajs/ui y @tanstack/react-query. Muestra el estado de la conexión con Square, la profundidad de la cola de sincronización, la marca de tiempo de la última sincronización y permite re-sincronizar manualmente por tipo de entidad.
Preguntas frecuentes
Preguntas comunes sobre medusa-square-plugin.
Obtener soporte de integración
Cuéntanos tu versión de Medusa, tu configuración de Square y qué necesitas que cubra el plugin.
Publicado en npm
Instala con npm install @weareseeed/medusa-square-plugin.
Patrón de módulo Medusa v2
Sin modificaciones al núcleo, compatibilidad total con actualizaciones.
Apple Pay + Google Pay incluidos
Todos los métodos del Square Web Payments SDK cubiertos.
Seeed lo mantiene
Actualizaciones continuas conforme evolucionan las APIs de Square y Medusa.
Obtener soporte de integración
Cuéntanos tu versión de Medusa, tu configuración de Square y qué necesitas que cubra el plugin.
Publicado en npm
Instala con npm install @weareseeed/medusa-square-plugin.
Patrón de módulo Medusa v2
Sin modificaciones al núcleo, compatibilidad total con actualizaciones.
Apple Pay + Google Pay incluidos
Todos los métodos del Square Web Payments SDK cubiertos.
Seeed lo mantiene
Actualizaciones continuas conforme evolucionan las APIs de Square y Medusa.
