Pasarela PayPal Reader (Zettle)
La pasarela PayPal Reader permite aceptar pagos con tarjeta en persona utilizando un terminal PayPal Reader (Zettle) directamente desde WCPOS. El navegador transmite el estado del pago en tiempo real desde el lector a través de una conexión segura con la API Reader Connect de Zettle, de modo que el cajero puede ver cada paso del pago a medida que ocurre.
Características
Pagos con tarjeta en persona
Procesamiento de pagos con chip, sin contacto y billeteras móviles en un terminal PayPal Reader (Zettle)
Estado del pago en tiempo real
El POS muestra el progreso en tiempo real: conectando, pago en curso, completado o cancelado
Monto verificado en el servidor
El monto reportado siempre se verifica contra el total del pedido antes de registrar el pedido
Emparejamiento sencillo
Vincular un lector desde la configuración de la pasarela de pago utilizando un código de emparejamiento que se muestra en el dispositivo
Requisitos
La disponibilidad de PayPal Reader / Zettle, los modelos de lector compatibles y los países admitidos están determinados por la cuenta de comerciante de Zettle, no por WCPOS. Se recomienda confirmar que el lector y la región son compatibles con PayPal/Zettle antes de realizar la compra.
Instalación
Instalar PayPal Reader para WooCommerce
Se puede instalar desde WP Admin > POS > Ajustes > Extensiones, o descargar el último archivo zip del plugin (no el zip del código fuente de GitHub ni el tarball) desde la página de versiones de GitHub y subirlo a través de Plugins > Añadir nuevo > Subir plugin. WooCommerce debe estar instalado y activo.
Configurar la pasarela de pago
- Navegar a
WP Admin > WooCommerce > Ajustes > Pagos - Buscar PayPal Reader en la lista de métodos de pago y abrir su configuración
- Dejar activada la opción Habilitar modo de prueba mientras se verifica la configuración. Se deben utilizar las credenciales de la cuenta de comerciante de desarrollador de Zettle en modo de prueba; desactivar esta opción posteriormente para aceptar pagos reales
- Introduzca su Zettle Client ID — el ID de cliente OAuth de Zettle del Portal de Desarrolladores de Zettle
- Introduzca su Zettle Assertion — la aserción OAuth de Zettle (JWT). Se trata como un secreto
- Opcionalmente, establezca el Título y la Descripción que se muestran a los clientes
- Guarde la configuración
La casilla "Habilitar PayPal Reader para el pago en línea" es solo para el proceso de pago de su tienda en línea — no es necesaria para el POS. La pasarela se habilita para el POS en un paso posterior.
Vincular el lector
- Después de guardar, desplácese hasta la sección Lectores vinculados en la parte inferior de la pantalla de configuración (aparece una vez que se han guardado el Client ID y la Assertion)
- En el dispositivo PayPal Reader, abra Configuración → Vincular con un desarrollador para que se muestre el código de vinculación
- En Vincular un nuevo lector, introduzca el Código de vinculación y, opcionalmente, un Nombre del lector (por ejemplo, "Mostrador principal")
- Haga clic en Vincular lector. El lector aparecerá en la lista de dispositivos vinculados y estará listo para aceptar pagos
Es necesario emparejar correctamente un lector antes de poder aceptar pagos. Utilice Desemparejar en la lista de dispositivos emparejados para eliminar un lector.
Activar en WCPOS
- Ir a
WP Admin > POS > Ajustes > Finalizar compra - Buscar la pasarela PayPal Reader en la lista
- Activarla para su uso en el POS
- Guardar los ajustes
Realizar un pago
- Agregar artículos al carrito en el POS y proceder a la caja
- Seleccionar PayPal Reader como método de pago
- Elegir un lector emparejado e iniciar el pago. (Si no hay ninguno emparejado, se solicitará al administrador de la tienda que empareje uno en
WooCommerce → Settings → Payments → PayPal Reader.) - El POS muestra el estado en tiempo real durante la conexión: "Conectando con el lector…", "Lector listo. Solicitando pago…", "Pago en curso…"
- El cliente acerca o inserta su tarjeta en el lector
- Si el pago es exitoso, el importe se verifica contra el total del pedido, se registra la referencia de la transacción y el pedido se realiza automáticamente
- Es posible utilizar Cancelar pago en cualquier momento para cancelar la solicitud en el lector
Pasar a producción
Una vez verificado todo en modo de prueba:
- Desactivar Habilitar modo de prueba
- Reemplazar las credenciales de prueba de Zettle con el Client ID y Assertion de producción
- Guardar — los endpoints y el flujo son idénticos; solo cambia la cuenta del comerciante
Resumen de requisitos y limitaciones
- El pedido solo se completa tras un resultado confirmado del lector. WCPOS no realizará el pedido a menos que el pago se reporte como completado.
- Protección contra discrepancia de importes. Si el importe reportado por el lector no coincide con el total del pedido, el pago se rechaza — por lo que se recomienda no modificar el total del carrito durante el proceso de pago.
- Conectividad. Los pagos en vivo dependen de que el navegador mantenga una sesión con la API Reader Connect de Zettle; se requiere una conexión a internet estable.
Solución de problemas
La sección de lectores emparejados no se muestra
Primero guarde su Zettle Client ID y Assertion. El panel de emparejamiento solo aparece una vez que ambas credenciales se han guardado. De lo contrario, se mostrará "Guarde su Zettle Client ID y Assertion arriba antes de emparejar un lector."
El lector no se empareja
- En el lector, asegúrese de haber abierto Settings → Link with a developer para obtener un código de emparejamiento nuevo
- Introduzca el código exactamente como se muestra, antes de que expire
- Confirme que su Zettle Client ID y Assertion son correctos y están guardados
- Asegúrese de que el lector y la red tengan una conexión a internet estable
El pago se rechaza por una discrepancia en el monto
El plugin verifica el monto reportado por el lector contra el total del pedido y rechaza cualquier discrepancia. No modifique el carrito ni el total del pedido mientras un pago está en curso — cancele el pago, ajuste el carrito y luego inicie un nuevo pago.
No se procesan pagos reales / aparece una advertencia de administrador sobre un 'mock reader'
Se define una constante de desarrollo/CI (PRWC_USE_MOCK_READER) en wp-config.php. Es necesario eliminar esa constante antes de aceptar pagos reales: mientras esté configurada, no se procesará ningún pago real.
Obtener ayuda
- Los problemas con la pasarela de pago pueden reportarse en el repositorio de GitHub
- Para consultas sobre la cuenta, el hardware del lector y la disponibilidad regional, es posible contactar con el soporte de PayPal/Zettle