Saltar al contenido principal
Versión: 1.x

Pasarela de Terminal Stripe

La pasarela de Terminal de Stripe te permite aceptar pagos en persona utilizando lectores de hardware Terminal de Stripe directamente dentro de WCPOS. Esta pasarela admite tanto lectores de tarjetas físicos como el modo simulador para pruebas.

Funciones​

Integración de Hardware

Conecta lectores físicos de Terminal de 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.

Pedidos por Teléfono (MOTO)

Acepta pagos con tarjeta por teléfono introduciendo los detalles en el lector.

Instalación​

1

Descargar e Instalar

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

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. Ingresa tu Clave Secreta de Stripe (puedes obtenerla desde tu Panel de Control de Stripe)
  5. Guarda la configuración
nota

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

3

Habilitar en WCPOS

  1. Ve a WP Admin > POS > Configuración > Pago
  2. Encuentra la pasarela Stripe Terminal en la lista
  3. Activa la pasarela para su uso en el POS
  4. Guarda tus configuraciones

Uso​

Conectando un Lector​

Cuando seleccionas la pasarela de Terminal de Stripe 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 de Terminal de Stripe
  3. Simulador: Selecciona el modo simulador para probar varios 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 el 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 una vez que el pago sea 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 con un toque
  • Escenarios de Error: Prueba pagos rechazados y otras condiciones de error
  • Diferentes Montos: Prueba varios montos de transacción

Pedidos por Teléfono (MOTO)​

MOTO (Pedido por Correo/Pedido Telefónico) te permite procesar pagos con tarjeta para clientes que no están físicamente presentes, por ejemplo, al tomar un pedido por teléfono. En lugar de tocar o insertar una tarjeta, el comerciante introduce los detalles de la tarjeta directamente en la pantalla del lector terminal.

Configuración​

1

Solicitar acceso MOTO de Stripe

MOTO no está habilitado por defecto. Contacta a soporte de Stripe y pídeles que habiliten los permisos MOTO para tu cuenta. Este es un proceso rápido pero requiere aprobación manual por parte de Stripe.

2

Habilitar en la configuración del plugin

  1. Navega a WP Admin > WooCommerce > Configuración > Pagos > Stripe Terminal
  2. Marca la casilla de Pedidos por Teléfono (MOTO)
  3. Guarda la configuración
3

Conectar un lector compatible

MOTO solo funciona con lectores conectados a internet compatibles que se enumeran en Terminales Soportados. El interruptor no aparecerá para otros tipos de lectores.

Tomando un Pedido por Teléfono​

  1. Conecta un lector compatible (consulta Terminales Soportados)
  2. En la pantalla de pago, activa Pedido por Teléfono
  3. Haz clic en Recoger Pago con Tarjeta — el lector mostrará una pantalla para ingresar el número de la tarjeta en lugar de solicitar un toque/insertar
  4. Introduce el número de tarjeta del cliente, fecha de vencimiento y CVV en el lector
  5. El pago se procesa normalmente a partir de ahí
consejo

Los pagos MOTO utilizan card como tipo de método de pago en lugar de card_present. Esto significa que se tratan más como transacciones en línea desde la perspectiva de Stripe, por lo que se aplican tarifas estándar de procesamiento de tarjetas en línea en lugar de tarifas en persona.

precaución

El interruptor de Pedido por Teléfono solo aparece cuando se cumplen las tres condiciones: la configuración MOTO está habilitada en la configuración del plugin, un lector compatible está conectado y el lector no es un simulador. Si no ves el interruptor, verifica estas condiciones.

Requisitos​

Cuenta de Stripe: Cuenta de Stripe activa con Terminal habilitada
Claves API: Clave secreta de Stripe desde tu panel de control
WCPOS: Se requiere versión Pro para pago en el 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 terminales conectados a internet solamente. Los terminales Bluetooth no son compatibles en este momento.

Terminales Soportados (Conectados a Internet)​

  • Stripe Reader S700/S710 ✅ - 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 iOS y Android en Q1 2026. Esto permitirá el soporte para todos los lectores certificados de Terminal de Stripe, incluyendo el M2 y el WisePad 3.

Problemas Comunes​

El lector no se conecta
  • Asegúrate de estar utilizando un terminal conectado a internet soportado
  • Verifica que el terminal esté conectado a WiFi/Ethernet y en línea
  • Comprueba que tu cuenta de Stripe tenga habilitada 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
  • Verifica que la tarjeta utilizada sea válida
  • Asegúrate de que haya fondos suficientes disponibles
Interruptor de Pedido por Teléfono no visible
  • Verifica que la configuración de Pedidos por Teléfono (MOTO) esté habilitada en WooCommerce > Configuración > Pagos > Stripe Terminal
  • Asegúrate de estar conectado a un lector compatible (consulta Terminales Soportados) — el interruptor está oculto para otros tipos de lectores
  • El interruptor no aparece al usar el simulador
El pago MOTO falla con un error
  • Confirma que Stripe ha habilitado permisos MOTO en tu cuenta — contacta a soporte de Stripe si aún no lo has hecho
  • Verifica que los detalles de la tarjeta se hayan ingresado correctamente en el lector
  • Los pagos MOTO pueden tener controles de fraude más estrictos — asegúrate de que la tarjeta sea válida y tenga fondos suficientes
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​

Las capturas de pantalla se añadirán en una actualización futura para mostrar:

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