Saltar al contenido principal
Versión: 1.x

Pasarela de Terminal SumUp

La pasarela de Terminal SumUp te permite aceptar pagos con tarjeta utilizando lectores de tarjetas SumUp directamente dentro de WooCommerce POS. Esta pasarela proporciona una integración fluida con el sistema de procesamiento de pagos de SumUp para transacciones en persona.

Características

Integración de Hardware

Conecta los lectores de tarjetas SumUp a tu sistema POS a través de una conexión a internet

Procesamiento en Tiempo Real

Procesamiento instantáneo de pagos y finalización de pedidos

Transacciones Seguras

Procesamiento de pagos conforme a PCI a través de SumUp

Emparejamiento Sencillo

Proceso de emparejamiento de dispositivos simple con códigos de emparejamiento

Instalación

1

Descargar e Instalar

  1. Visita la página de lanzamientos de SumUp Terminal para WooCommerce
  2. Descarga el archivo más reciente sumup-terminal-for-woocommerce.zip
  3. En tu administración de WordPress, ve a Plugins > Añadir Nuevo > Subir Plugin
  4. Sube el archivo zip y activa el plugin
2

Configurar Ajustes de SumUp

  1. Navega a WP Admin > WooCommerce > Ajustes > Pagos
  2. Encuentra SumUp Terminal en la lista de métodos de pago
  3. Haz clic en SumUp Terminal para acceder a los ajustes
  4. Introduce tu Clave API de SumUp (disponible desde tu panel de comerciantes de SumUp)
  5. Guarda los ajustes
nota

No necesitas habilitar la pasarela de Terminal SumUp en los ajustes de WooCommerce. Se habilitará específicamente para el POS en un paso posterior.

3

Empareja Tu Terminal SumUp

  1. En la misma página de ajustes, localiza la sección Emparejar Lector
  2. En tu dispositivo SumUp, navega a la pantalla de emparejamiento para mostrar el código de emparejamiento
  3. Introduce el código de emparejamiento que se muestra en tu dispositivo SumUp
  4. Haz clic en "Emparejar Lector" para establecer la conexión
  5. Espera la confirmación de que el lector ha sido emparejado con éxito
Importante

El lector debe estar emparejado con éxito antes de que puedas procesar pagos. Asegúrate de que el proceso de emparejamiento se complete antes de continuar.

4

Habilitar en WooCommerce POS

  1. Ve a WP Admin > WooCommerce POS > Ajustes > Pago
  2. Encuentra la pasarela de SumUp Terminal en la lista
  3. Habilita la pasarela para su uso en el POS
  4. Guarda tus ajustes

Uso

Procesamiento de Pagos

  1. Agregar Artículos: Añade productos a tu carrito en el POS
  2. Seleccionar Pasarela: Elige "SumUp Terminal" como método de pago
  3. Iniciar Pago: Haz clic para iniciar un nuevo pago en tu dispositivo SumUp
  4. Pago del Cliente: El cliente completa el pago en el terminal SumUp
  5. Finalización Automática: El pedido se completa automáticamente cuando se detecta el pago

Controles de Pago

Al usar la pasarela de Terminal SumUp, tienes las siguientes opciones:

  • Iniciar Nuevo Pago: Inicia una solicitud de pago en el terminal conectado
  • Cancelar Pago: Cancela un pago que actualmente se está procesando
  • Estado de Pago: Monitorea el estado actual del proceso de pago

Gestión de Pedidos

  • Actualizaciones Automáticas: Los pedidos se marcan automáticamente como completados tras un pago exitoso
  • Seguimiento de Pagos: Todos los detalles de pago se registran en las notas del pedido
  • Generación de Recibos: Se generan recibos estándar del POS después de pagos exitosos

Requisitos

Cuenta de SumUp: Cuenta comercial activa en SumUp
Acceso a API: Clave API de SumUp desde tu panel de comerciantes
Hardware Compatible: Dispositivo lector de tarjetas SumUp
WooCommerce POS: Versión Pro requerida para el pago en el POS
Conexión Estable: Conexión a internet confiable para la comunicación de la API

Compatibilidad de Hardware

Requisitos de Conectividad

Esta implementación utiliza el SDK de JavaScript de SumUp, lo que significa que funciona a través de aplicaciones web pero requiere terminales conectados a internet únicamente. Los terminales Bluetooth no son compatibles actualmente.

Terminales Compatibles (Conectados a Internet)

  • SumUp Solo ✅ - Terminal conectado por WiFi/Ethernet

Terminales No Compatibles (Bluetooth)

  • SumUp Air ❌ - Solo Bluetooth
  • SumUp 3G ❌ - Solo Bluetooth
Soporte Futuro

El soporte para terminales Bluetooth se añadirá a las aplicaciones de iOS y Android en Q1 2026. Esto permitirá el soporte para todos los terminales certificados de SumUp, incluyendo los modelos Air y 3G.

Resolución de Problemas

Problemas Comunes

El lector no se empareja
  • Asegúrate de estar utilizando un terminal compatible con conexión a internet (Solo)
  • Verifica que tu dispositivo SumUp Solo esté conectado a WiFi y en línea
  • Asegúrate de que el dispositivo esté en modo de emparejamiento y que el código de emparejamiento esté ingresado correctamente
  • Confirma que tu cuenta de SumUp tenga habilitado el acceso a la API
  • Asegúrate de tener una conexión a internet estable durante el emparejamiento
El pago no se procesa
  • Verifica que el lector esté correctamente emparejado
  • Asegúrate de que tu cuenta de SumUp esté activa y en buen estado
  • Asegúrate de que el dispositivo tenga suficiente batería y conectividad
  • Confirma que la clave de API sea correcta y esté activa
El pedido no se completa
  • Verifica la estabilidad de la conexión a internet
  • Confirma la configuración del webhook en tu cuenta de SumUp
  • Asegúrate de que el pago haya sido exitoso en el terminal SumUp
  • Revisa los registros de error de WordPress para problemas de comunicación de la API

Límites de Tasa de API

La pasarela está optimizada para reducir las llamadas a la API y evitar limitaciones de tasa:

  • El estado del pago se verifica de manera eficiente
  • Se minimizan las solicitudes innecesarias a la API
  • La lógica de reintento automático maneja fallos temporales

Obtener Ayuda

Para soporte técnico:

Capturas de Pantalla

Se agregarán capturas de pantalla en una futura actualización para mostrar:

  • Configuración de la clave API de SumUp y la interfaz de emparejamiento del dispositivo
  • Activación de la pasarela en los ajustes de WooCommerce POS
  • Flujo de trabajo de procesamiento de pagos en el pago del POS