Saltar al contenido principal
Versión: 1.x

Pasarela de Terminal Stripe

La pasarela de Terminal Stripe te permite aceptar pagos en persona utilizando lectores de hardware de Terminal Stripe directamente en WooCommerce POS. Esta pasarela admite tanto lectores de tarjetas físicas como modo simulador para pruebas.

Características​

Integración de Hardware

Conecta lectores físicos de Terminal Stripe a través de una 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 instantáneos

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 archivo stripe-terminal-for-woocommerce.zip
  3. En tu administración de WordPress, ve a Plugins > Añadir Nuevo > Cargar Plugin
  4. Sube el archivo zip y activa el plugin
2

Configurar la Configuración de Stripe

  1. Navega a WP Admin > WooCommerce > Configuración > Pagos
  2. Encuentra Stripe Terminal en la lista de métodos de pago
  3. Haz clic en Stripe Terminal para acceder a la configuración
  4. Introduce tu Clave Secreta de Stripe (puedes obtener esto desde tu Dashboard de Stripe)
  5. Guarda la configuración
nota

No es necesario habilitar la pasarela de Terminal Stripe en la configuración de WooCommerce. Se activará específicamente para el POS en el siguiente paso.

3

Habilitar en WooCommerce POS

  1. Ve a WP Admin > WooCommerce POS > Configuración > Pago
  2. Encuentra la pasarela Stripe Terminal en la lista
  3. Habilita la pasarela para su uso en el POS
  4. Guarda tu configuración

Uso​

Conectar un Lector​

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

  1. Elige 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 de Terminal Stripe
  3. Simulador: Selecciona el modo simulador para probar varios escenarios de pago sin hardware

Procesar 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 un pago exitoso

Pruebas con el Simulador​

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

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

Requisitos​

Cuenta de Stripe: Cuenta activa de Stripe con Terminal habilitado
Claves API: Clave secreta de Stripe desde tu dashboard
WooCommerce POS: Versión Pro requerida para el pago en POS
HTTPS: Tu sitio debe usar SSL/HTTPS para 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 solo terminales conectados a internet. Los terminales Bluetooth no son compatibles actualmente.

Terminales Soportados (Conectados 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 habilitará el soporte para todos los lectores certificados de Terminal Stripe, incluyendo el M2 y WisePad 3.

Problemas Comunes​

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

Obtener Ayuda​

Para soporte técnico:

Capturas de Pantalla​

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

  • Configuración de la pasarela en la configuración de pagos de WooCommerce
  • Interfaz de pago del POS con selección de Terminal Stripe
  • Interfaz de prueba del simulador con varios métodos de pago