# Square y Pilotiko: su cuenta de ventas conectada, sin automatismos

> Square y Pilotiko: los tres permisos OAuth solicitados, la vigencia de los tokens, lo que sigue siendo manual hoy y cómo revocar el acceso en cualquier momento.

Actualizado el 8 de noviembre de 2026 · https://app.pilotiko.com/es/integraciones/square

Pilotiko puede hoy conectar su cuenta de Square mediante OAuth con tres permisos: PAYMENTS_READ, PAYMENTS_WRITE y MERCHANT_PROFILE_READ. Todavía no lee ninguna venta y no crea ningún pago. Estado: Solo conexión de la cuenta: ninguna acción automática por ahora. Sus ventas en persona y en línea permanecen en Square.

## En resumen
- Estado: Solo conexión de la cuenta: ninguna acción automática por ahora.
- Permisos solicitados: PAYMENTS_READ, PAYMENTS_WRITE, MERCHANT_PROFILE_READ.
- Square hace expirar los tokens de acceso a los 30 días; se renuevan mediante un token de actualización.
- No están conectados ni la lectura de ventas, ni los pagos, ni los reembolsos.

## ¿Qué hace la conexión de Square en Pilotiko?

Conserva, cifrada, la autorización que usted otorga a Pilotiko sobre su cuenta de vendedor de Square. Ninguna función la utiliza todavía.

Square suele usarse para dos fines a la vez: el terminal en el mostrador y los pagos en línea. Pilotiko clasifica Square en la capacidad « Cobros » con el estado **solo conexión**: el flujo de autorización está construido, pero no hay ninguna operación sobre sus ventas. Por lo tanto, Pilotiko no verá una venta hecha en el mostrador el martes por la mañana, ni podrá reembolsarla.

Square describe cada permiso según los puntos de acceso que abre [1]. Pilotiko solicita tres, que se enumeran a continuación, con vistas al cobro y la conciliación de las ventas. Haberlos solicitado no significa que se utilicen: no se realiza ninguna llamada a la API Payments ni a la API Merchants.

Square devuelve el token en formato JSON; el código de autorización dura 5 minutos y solo se usa una vez [2]. Pilotiko no utiliza PKCE con Square: el intercambio se realiza en el servidor con el secreto de la aplicación.

- **PAYMENTS_READ**: lectura de pagos, por ejemplo ListPayments o GetPayment [1]. No se utiliza hoy.
- **PAYMENTS_WRITE**: creación, cancelación y reembolso de pagos, por ejemplo CreatePayment o RefundPayment [1]. No se utiliza hoy; cualquier uso futuro esperará la aprobación de una persona.
- **MERCHANT_PROFILE_READ**: información sobre la cuenta de vendedor y sus puntos de venta, por ejemplo ListLocations o RetrieveMerchant [1]. No se utiliza hoy.

## ¿Cómo conectar Square con Pilotiko?

La cuenta de Square que autoriza debe ser la de la empresa. Si Pilotiko aún no ha activado su aplicación de Square, la tarjeta lo indica y no muestra ningún botón.

1. **Encontrar la tarjeta de Square** — En Pilotiko, página Conexiones, grupo Cobros.
2. **Iniciar la conexión** — Haga clic en Conectar; Pilotiko prepara una solicitud de un solo uso, válida por 10 minutos, vinculada a su empresa y a usted.
3. **Leer la página de autorización de Square** — Square muestra los tres permisos solicitados; verifique que se trate de la cuenta de vendedor correcta.
4. **Autorizar** — Square lo redirige a Pilotiko con un código; Pilotiko lo intercambia por un token y lo cifra.
5. **Verificar** — La tarjeta pasa a « Conectado » e indica que no se realiza ninguna acción automática.

## ¿Qué está disponible o por venir con Square?

| Función | Estado | Detalle |
|---|---|---|
| Conectar la cuenta de vendedor de Square | Solo conexión de la cuenta: ninguna acción automática por ahora | Tres permisos solicitados, token cifrado |
| Leer las ventas en mostrador y en línea | Próximamente | Ninguna llamada a la API Payments |
| Crear un pago o reembolsar | Próximamente | Exigirá la aprobación de una persona |
| Leer sus puntos de venta (Locations) | Próximamente | Ninguna llamada a la API Merchants |
| Desconectar Square del lado de Pilotiko | Disponible | Tokens borrados, registro de auditoría |

## ¿Qué ve Pilotiko de una jornada de ventas en Square?

**Ejemplo: una peluquería con 2 puntos de venta y 41 ventas en Square un sábado**

La peluquería cobra en el mostrador con Square en sus dos sucursales y recibe algunos anticipos en línea. Square está conectado a Pilotiko desde hace una semana.

- Ventas en mostrador (2 sucursales) : 35
- Anticipos pagados en línea : 6
- Ventas leídas por Pilotiko : 0
- Puntos de venta leídos por Pilotiko : 0 de 2
- Reembolsos hechos por Pilotiko : 0
- **= Las 41 ventas permanecen en Square; en Pilotiko, las citas del día no se marcan automáticamente como « pagadas ».**

## ¿Cómo se protegen sus datos de Square (Loi 25)?

El token de Square se cifra en reposo (AES-256-GCM) y nunca se muestra, ni en la interfaz ni en los registros. Según la ley quebequense sobre el sector privado, toda empresa es responsable de los datos personales que posee, y la persona con la más alta autoridad vela por el cumplimiento de la ley [3]. Hoy Pilotiko no recopila ningún dato de ventas de Square: no hay nada más que proteger aparte del propio token.

El día en que se lean las ventas, contendrán información sobre sus clientes; la ley prevé entonces un derecho de acceso, con una copia en un formato estructurado y de uso común si se solicita [3]. La CAI recuerda que este derecho a la portabilidad se aplica desde el 22 de septiembre de 2024 [4]. Detalles: [sus derechos](/vos-droits) y [subencargados](/sous-traitants).

Revocación: en Pilotiko, Desconectar borra el token y registra la acción en el registro de auditoría. En Square, el vendedor puede revocar el acceso de la aplicación, lo que invalida sus tokens [2].

## ¿Cuáles son los límites propios de Square?

Square hace expirar sus tokens de acceso a los 30 días [2]. Una conexión sin uso durante mucho tiempo deberá renovarse con el token de actualización o, de lo contrario, volver a conectarse. La aplicación OAuth de Pilotiko para Square aún no está registrada.

Si solo necesita cobro en línea, compare con [Stripe](https://app.pilotiko.com/es/integraciones/stripe); para un terminal de otra marca, vea [Clover](https://app.pilotiko.com/es/integraciones/clover). Todas las conexiones están en la página de [Integraciones](https://app.pilotiko.com/es/integraciones), y sus citas ya pueden provenir de [Acuity Scheduling](https://app.pilotiko.com/es/integraciones/acuity-scheduling) mediante migración.

## Preguntas frecuentes

### ¿Pilotiko ve las ventas hechas en mi terminal Square?

No, todavía no. Se solicita el permiso de lectura, pero no hay ninguna lectura programada. Sus ventas solo son visibles en Square.

### ¿Por qué Pilotiko solicita PAYMENTS_WRITE si no crea pagos?

Para que el cobro pueda conectarse más adelante sin volver a pedirle acceso. Hoy no se crea ningún pago, y cualquier pago futuro esperará la aprobación de una persona.

### ¿Cuánto dura la autorización de Square?

Square hace expirar el token de acceso a los 30 días y proporciona un token de actualización para obtener uno nuevo. Si la renovación falla, la tarjeta pasa a « por reconectar ».

### ¿Puedo conectar varias sucursales de Square?

La conexión se hace a nivel de la cuenta de vendedor, que agrupa sus puntos de venta. Pilotiko todavía no lee la lista de esos puntos de venta.

### ¿Cómo cortar el acceso de Pilotiko a Square?

Haga clic en Desconectar en Pilotiko para borrar el token. También puede revocar la aplicación en Square, lo que invalida sus tokens.

### ¿Mis clientes verán algún cambio en la caja?

No. Nada cambia en Square: ni en el mostrador, ni en sus enlaces de pago en línea.

## Fuentes

1. Square Developer, « OAuth permissions reference », https://developer.squareup.com/docs/oauth-api/square-permissions (consultado el 2026-10-15)
2. Square Developer, « OAuth API overview », https://developer.squareup.com/docs/oauth-api/overview (consultado el 2026-10-15)
3. LégisQuébec, « Loi sur la protection des renseignements personnels dans le secteur privé (RLRQ, c. P-39.1) », https://www.legisquebec.gouv.qc.ca/fr/document/lc/P-39.1 (consultado el 2026-10-15)
4. Commission d'accès à l'information du Québec, « Principaux changements apportés par la Loi 25 », https://www.cai.gouv.qc.ca/protection-renseignements-personnels/sujets-et-domaines-dinteret/principaux-changements-loi-25 (consultado el 2026-10-15)
