Saltar al contenido principal
Versión: 1.x

Pasarela Stripe Terminal

La pasarela Stripe Terminal permite que aceptes pagos en persona utilizando lectores de hardware de Stripe Terminal directamente en WooCommerce POS. Esta pasarela es compatible con lectores de tarjetas físicos y el modo simulador para pruebas.

Características​

Integración de Hardware

Conecta lectores físicos de Stripe Terminal mediante conexión a internet

Modo Simulador

Prueba pagos sin hardware utilizando el simulador de Stripe

Procesamiento en Tiempo Real

Procesamiento y confirmación de pagos en tiempo real

Transacciones Seguras

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

Instalación​

1

Descargar e Instalar

  1. Visita la página de lanzamientos de Stripe Terminal para WooCommerce
  2. Descarga el último archivo stripe-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 Stripe

  1. Navega a WP Admin > WooCommerce > Settings > Payments
  2. Encuentra Stripe Terminal en la lista de métodos de pago
  3. Haz clic en Stripe Terminal para acceder a los ajustes
  4. Ingresa tu Clave Secreta de Stripe (puedes obtenerla desde tu Panel de Control de Stripe)
  5. Guarda los ajustes
nota

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

3

Habilitar en WooCommerce POS

  1. Ve a WP Admin > WooCommerce POS > Settings > Checkout
  2. Encuentra la pasarela Stripe Terminal en la lista
  3. Habilita la pasarela para su uso en el POS
  4. Guarda tus ajustes

Uso​

Conectando un Lector​

Cuando selecciones la pasarela Stripe Terminal durante el pago en el POS:

  1. Elegir Método de Conexión: Puedes conectar un lector físico o usar el simulador
  2. Lector Físico: Sigue las instrucciones en pantalla para conectar tu dispositivo Stripe Terminal
  3. Simulador: Selecciona el modo simulador para probar diversos escenarios de pago sin hardware

Procesando Pagos​

  1. Agregar Artículos: Agrega productos a tu carrito en el POS
  2. Seleccionar Pasarela: Elige "Stripe Terminal" como método de pago
  3. Conectar Lector: Conecta tu lector o elige el modo simulador
  4. Procesar Pago: Sigue las indicaciones para completar la transacción
  5. Confirmación: El pedido se completará automáticamente al realizar el pago exitosamente

Pruebas con el Simulador​

El simulador te permite probar varios métodos de pago y escenarios:

  • Pagos con Tarjeta: Prueba diferentes tipos de tarjetas (Visa, Mastercard, etc.)
  • Pagos Sin Contacto: Simula transacciones de pago por acercamiento
  • Escenarios de Error: Prueba pagos rechazados y otras condiciones de error
  • Diferentes Montos: Prueba varios montos de transacción

Requisitos​

Cuenta de Stripe: Cuenta activa de Stripe con Terminal habilitado
Claves API: Clave secreta de Stripe de tu panel
WooCommerce POS: Versión gratuita o Pro instalada y activada
HTTPS: Tu sitio debe utilizar SSL/HTTPS por seguridad

Compatibilidad de Hardware​

Requisitos de Conectividad

Esta implementación utiliza el SDK de JavaScript de Stripe, lo que significa que funciona a través de aplicaciones web pero requiere terminales solo con conexión a internet. Los terminales Bluetooth no son soportados actualmente.

Terminales Soportados (Con Conexión a Internet)​

  • Stripe Reader S700 ✅ - Terminal conectado por Ethernet/WiFi
  • WisePOS E ✅ - Terminal conectado por WiFi

Terminales No Soportados (Bluetooth)​

  • BBPOS Chipper 2X BT ❌ - Solo Bluetooth
  • BBPOS WisePad 3 ❌ - Solo Bluetooth
  • Verifone P400 ❌ - Solo Bluetooth
Soporte Futuro

El soporte para terminales Bluetooth se añadirá a las aplicaciones de iOS y Android en Q1 2026. Esto permitirá soporte para todos los lectores certificados de Stripe Terminal, incluyendo el M2 y WisePad 3.

Problemas Comunes​

El lector no se conecta
  • Asegúrate de estar utilizando un terminal conectado a internet soportado (S700 o WisePOS E)
  • Verifica que el terminal esté conectado a WiFi/Ethernet y en línea
  • Comprueba que tu cuenta de Stripe tenga activado Terminal
  • Confirma que el terminal esté registrado en tu Panel de Control de Stripe
Pago rechazado
  • Verifica que tu cuenta de Stripe esté activa y en buen estado
  • Asegúrate de que la tarjeta utilizada sea válida
  • Confirma que hay fondos suficientes disponibles
Errores de certificado SSL
  • Stripe Terminal requiere HTTPS - asegúrate de que tu sitio tenga un certificado SSL válido
  • Verifica que tu certificado SSL esté correctamente configurado

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 pasarela en los ajustes de pago de WooCommerce
  • Interfaz de pago en el POS con la selección de Stripe Terminal
  • Interfaz de pruebas del simulador con varios métodos de pago