Square se integra de dos maneras. En iOS y Android, la app móvil entrega el cargo a la app de Square en el mismo dispositivo y regresa cuando se paga. Square Terminal conecta la tienda a tu cuenta de Square con OAuth y empareja una terminal de mostrador a cada caja con un código de dispositivo.

Square es una integración vigente y con soporte pleno que viene en dos sabores, y el menú Procesador de Tarjeta de Crédito los lista por separado:

• Square — para teléfonos y tabletas. La app móvil de PHP Point Of Sale entrega el cargo a la app Square Point of Sale instalada en el mismo dispositivo iOS o Android (con el lector Square que tenga emparejado), y regresa al punto de venta cuando el pago termina.
• Square Terminal — para mostradores. La tienda se conecta a tu cuenta de Square por OAuth, y cada caja se empareja con su propio dispositivo Square Terminal mediante un código de dispositivo. No hace falta teléfono.

Si todavía comparas opciones, empieza por elegir un procesador de pagos.

Square en iOS y Android (entrega a la app)

Configúralo

1. Date de alta como comercio en squareup.com.
2. Instala la app Square Point of Sale desde el App Store o Google Play en el dispositivo desde el que venderás, inicia sesión y empareja tu lector Square en la app de Square si usas uno (lector de chip y sin contacto, o de banda).
3. Instala la app de PHP Point Of Sale desde el App Store o Google Play e inicia sesión — mira la app móvil.
4. En el punto de venta, ve a Tiendas, haz clic en Editar junto a tu tienda y marca Activar procesamiento de tarjetas de crédito.
5. Pon el Procesador de Tarjeta de Crédito en Square.
6. Si cobras en una moneda distinta al dólar estadounidense, escribe su código en Código de moneda (por defecto USD).
7. Deja el Multiplicador para obtener el total en centavos en su valor por defecto de 100, salvo que tu moneda no use dos decimales — no lo cambies en otro caso.
8. Haz clic en Guardar.

Cobra un pago

1. Cobra la venta en la app de PHP Point Of Sale y elige el tipo de pago Tarjeta de crédito.
2. Toca Procesar tarjeta de crédito. El dispositivo cambia a la app de Square con el monto exacto.
3. Toma el pago en Square — sin contacto, chip, banda o tecleado — y el dispositivo regresa al punto de venta con el pago adjunto a la venta.

El monto con tarjeta debe ser de al menos 1.00 — Square rechaza cargos menores y la caja muestra el error de que el cobro con tarjeta falló.

Como la entrega ocurre en el dispositivo, este sabor solo funciona dentro de la app móvil en iOS o Android — no en un navegador de escritorio.

Square Terminal (dispositivo de mostrador)

Conecta la tienda a Square

1. Ve a Tiendas, haz clic en Editar junto a tu tienda y marca Activar procesamiento de tarjetas de crédito.
2. Pon el Procesador de Tarjeta de Crédito en Square Terminal.
3. Haz clic en Conectar a Square y aprueba la autorización en la ventana de Square que se abre. Una vez conectada, el botón pasa a Desconectarse de Square por si algún día necesitas desvincular la cuenta.
4. Elige la sucursal correcta en el menú Square Location ID — una cuenta de Square puede tener varias ubicaciones, y las ventas deben caer en la correcta.
5. Define el Código de moneda (por defecto USD) y deja el Multiplicador para obtener el total en centavos en 100 salvo que tu moneda no tenga dos decimales.
6. Haz clic en Guardar.

Empareja una terminal a cada caja

1. En el formulario de la tienda, busca la fila de la caja en la tabla de Cajas registradoras y haz clic en Obtener código de dispositivo Square. Se genera un código de dispositivo para esa caja.
2. En la propia Square Terminal, elige iniciar sesión con un código de dispositivo y teclea el código. La terminal queda ligada a esa caja.
3. Para reemplazar o quitar el dispositivo después, haz clic en Cancelar registro de terminal en la misma fila y empareja de nuevo.

Al vender, elegir el tipo de pago Tarjeta de crédito envía el monto exacto a la terminal emparejada de esa caja para sin contacto, chip o banda. Cada caja se empareja con su propia terminal.

Editar tiendas requiere el permiso del módulo Tiendas en tu cuenta de empleado — mira permisos y plantillas. El procesamiento integrado también requiere que el punto de venta se sirva por HTTPS.

Referencia de ajustes

• Activar procesamiento de tarjetas de crédito — interruptor maestro, apagado por defecto.
• Procesador de Tarjeta de Crédito — Square (entrega a la app móvil) o Square Terminal (dispositivo de mostrador).
• Código de moneda — por defecto USD; debe coincidir con la moneda de tu cuenta de Square.
• Multiplicador para obtener el total en centavos — por defecto 100; solo cámbialo para monedas sin dos decimales.
• Conectar a Square / Desconectarse de Square — el vínculo OAuth entre la tienda y tu cuenta de Square (solo Square Terminal).
• Square Location ID — qué ubicación de Square recibe las ventas (solo Square Terminal).
• Por caja en la tabla de Cajas registradoras: Obtener código de dispositivo Square / Cancelar registro de terminal (solo Square Terminal), y Enable Tips (habilitar propinas).

Preguntas frecuentes

¿Qué opción elijo — Square o Square Terminal? Square si vendes desde un teléfono o tableta con la app de Square y un lector Square. Square Terminal si tienes el dispositivo de mostrador independiente Square Terminal y quieres que cada caja controle el suyo.

¿Puedo usar la integración de Square desde un navegador de escritorio? El sabor de entrega a la app no — depende de cambiar a la app de Square en el mismo dispositivo móvil. El sabor Square Terminal funciona desde cualquier navegador, porque la terminal se empareja a la caja a través de la nube de Square.

Los pagos entran pero aparecen en la sucursal equivocada de Square. Define el Square Location ID correcto en el formulario de la tienda — ese menú decide cuál de tus ubicaciones de Square recibe las transacciones.

Cobro en una moneda distinta al dólar estadounidense. Escribe el código de tu moneda en Código de moneda. Deja el multiplicador de centavos en 100 salvo que tu moneda de verdad no tenga subdivisión de dos decimales — cambiarlo mal hace los cargos 100 veces mayores o menores.

El dispositivo nunca regresa al punto de venta después de que la app de Square toma el control. Ambas apps deben estar instaladas y con sesión iniciada en el mismo dispositivo, y la venta debe iniciarse desde el tipo de pago Tarjeta de crédito de la app de PHP Point Of Sale. Actualiza ambas apps si la entrega se queda en bucle.

¿Los reembolsos pasan por la integración? Con Square Terminal, sí — elimina la venta o procesa una devolución en el punto de venta y la reversión regresa a la tarjeta a través de Square. Con el sabor Square de entrega a la app, el punto de venta no puede comunicarse con Square para anular ni reembolsar: registra la devolución en el punto de venta para tus reportes y luego emite el reembolso a la tarjeta desde la app o el Dashboard de Square. Mira cobrar con tarjeta y devoluciones, cambios y artículos a cuenta.

¿Dónde veo comisiones y depósitos? En tu Square Dashboard — Square sigue siendo el comercio registrado para tarifas, comisiones y tiempos de depósito. El punto de venta registra el pago para tus propios reportes.