Ir al contenido principal
Versión: 2.x

Pasarela de pago PayPal Reader (Zettle)

La caja envía el total del pedido a un PayPal Reader, el cliente acerca o introduce su tarjeta en el lector y la venta finaliza automáticamente cuando el lector confirma que el pago se ha completado. Esta página tiene dos partes: cobrar un pago en la caja y configurar la pasarela en WP Admin.

Función Pro

La extensión PayPal Reader necesita WCPOS Pro, tanto para instalarla desde el directorio de extensiones como para usarla en la caja.

Cobrar un pago​

Antes de empezar
  • La caja y su tienda deben estar conectadas a internet. El pago se realiza en la página de pago de su propia tienda, dentro del POS.
  • Alguien con acceso a WP Admin debe haber configurado la pasarela de pago y vinculado un lector.
  • La caja debe estar abierta si su tienda utiliza Abrir y cerrar la caja. La caja no registrará ningún pago mientras esté cerrada. Consulte Cajas.
  1. Prepare el carrito y pulse Pagar.

  2. Abra la pestaña Heredado. La página de pago de su tienda se abrirá dentro del POS. Consulte La pestaña Heredado.

  3. Seleccione PayPal Reader. Es posible que su tienda le haya dado otro nombre. El panel muestra Cargando lectores… y después Modo: prueba. Listo para iniciar el pago. (o Modo: real. cuando la tienda haya pasado a pagos reales).

  4. Seleccione el lector. Cada lector vinculado aparece como un botón con su nombre, por ejemplo, Mostrador principal (listo), y el primero ya está seleccionado. Pulse otro para utilizarlo en su lugar.

    advertencia

    MODO DE PRUEBA en la parte superior del panel es solo una etiqueta. El lector puede seguir cobrando dinero real. Consulte Modo de prueba y paso a pagos reales.

  5. Pulse Iniciar pago con el lector. El panel muestra Conectando con el lector… y después Lector listo. Solicitando el pago…, y el total completo del pedido se envía a ese lector.

  6. El cliente acerca o introduce su tarjeta en el lector. Mientras el lector procesa el pago, el panel muestra Pago en curso…, con el paso actual del lector entre corchetes.

  7. Cuando el lector confirma que el pago se ha completado, el panel muestra Pago completado. Enviando pedido… y el POS pasa al recibo.

No es necesario pulsar Procesar pago al pie de la pestaña Heredado: la venta finaliza automáticamente. Si lo pulsa antes de que el lector termine, el POS muestra Complete el pago con PayPal Reader antes de realizar el pedido.

El recuadro oscuro situado debajo de los botones guarda una línea con la hora de cada paso. Consúltelo cuando un pago se interrumpa.

El lector siempre cobra el pedido completo, por lo que no se puede combinar con otro método en una misma venta. Una vez que se ha cobrado un pago del pedido, la pestaña Heredado muestra Solo el importe total y no se puede utilizar; primero cancele ese pago.

Detener un pago​

Pulse Cancelar pago mientras el pago está en curso. Se solicita al lector que lo cancele y la caja deja de recibir sus actualizaciones; el panel muestra Pago cancelado.

Compruebe el lector antes de volver a cobrar

Tras pulsar Cancelar pago, o si la página de pago se cierra o se recarga mientras el lector está trabajando, la caja deja de recibir información del lector. Si el lector muestra que el pago se ha aprobado a pesar de ello, el cliente ya ha pagado: no vuelva a cobrarle. Registre el pago con el botón Tarjeta de la pestaña Pagos y compruébelo en su cuenta de Zettle.

Una vez que tenga la certeza de que no se ha cobrado al cliente, pulse Iniciar pago con el lector para intentarlo de nuevo, o cierre la pestaña y cobre con otro método.

Después de la venta​

El pedido se marca como pagado y su ID de transacción es el ID que Zettle asigna al pago con tarjeta, por lo que puede encontrar ese mismo pago en su cuenta de Zettle. Las notas del pedido registran cuándo se inició el pago y en qué lector (por su ID de vinculación), así como cuándo se completó, se rechazó por una discrepancia en el importe o se canceló mediante Cancelar pago.

Reembolsos​

La extensión no puede realizar reembolsos a través de Zettle, por lo que Reembolsar a PayPal Reader no está disponible.

advertencia

No entregue efectivo al cliente. El reembolso a la tarjeta se realiza en Zettle, y Reembolsar en efectivo solo lo registra en WCPOS. Si la caja está abierta, también reduce en ese mismo importe el efectivo que debería haber en el cajón. Consulte Reembolsos en efectivo y el cajón.

  1. Realice el reembolso a la tarjeta desde su cuenta de Zettle.
  2. Registre el reembolso en el pedido mediante Reembolsar en efectivo. Consulte Destino del reembolso.

Si algo sale mal​

Aún no hay lectores vinculados. Pida al administrador de la tienda que vincule uno… La cuenta de Zettle no tiene ningún lector vinculado, por lo que Iniciar pago con el lector permanece desactivado. Alguien con acceso a WP Admin debe vincular uno: consulte Vincular un lector en Configurar la pasarela.

El panel se queda en Conectando con el lector… El lector no está listo para un pago: puede estar en reposo, apagado, sin conexión u ocupado con otra tarea. Sáquelo del modo de reposo y compruebe que está en su pantalla de inicio y conectado a internet. Pulse Cancelar pago, compruebe que el lector no muestra ningún pago cobrado, como se indica en Detener un pago, y vuelva a pulsar Iniciar pago con el lector.

Pago cancelado. El pago se canceló en el lector o mediante Cancelar pago. Si pulsó Cancelar pago, compruebe primero el lector, como se indica en Detener un pago. Después, inícielo de nuevo o cobre con otro método.

El pago ha fallado. ¿Se ha cobrado a la tarjeta?​

El texto que aparece después de El pago ha fallado. indica si el cliente ha pagado y, por tanto, si puede volver a cobrarle. Busque el mensaje y siga las instrucciones del caso correspondiente:

El importe del pago no coincide: se ha cobrado; realice primero el reembolso​

Se ha cobrado a la tarjeta: sí. El panel muestra El pago ha fallado. El importe del pago no coincide. El lector ha cobrado el dinero, pero el total del pedido cambió después de iniciarse el pago, por lo que el pedido se rechaza y queda sin pagar. Reembolse ese pago en su cuenta de Zettle y después inicie un nuevo pago por el total correcto. Para evitarlo, no modifique el carrito mientras haya un pago con el lector en curso: pulse Cancelar pago, modifique el carrito y después inicie un nuevo pago.

Un motivo entre paréntesis: no se ha cobrado; inténtelo de nuevo​

Se ha cobrado a la tarjeta: no. El panel muestra El pago ha fallado. con un motivo entre paréntesis. El lector o Zettle no ha cobrado el pago; por ejemplo, se ha rechazado la tarjeta. Pulse Iniciar pago con el lector o cobre con otro método.

Solo El pago ha fallado. o un mensaje no incluido: compruebe el pago antes de intentarlo de nuevo​

Se ha cobrado a la tarjeta: no se puede determinar. El panel solo muestra El pago ha fallado. La caja ha perdido la conexión con Zettle y no puede determinar si se ha cobrado a la tarjeta. Proceda del mismo modo ante un mensaje que no figure en esta página. Compruebe el lector y la lista de pagos en su cuenta de Zettle. Si el pago aparece allí, regístrelo como se indica en Detener un pago. Vuelva a empezar solo cuando tenga la certeza de que no se ha cobrado; si no puede determinarlo, consulte a quien gestione su cuenta de Zettle antes de volver a cobrar.

La solicitud ha fallado. o algún otro mensaje incluido aquí: se ha cobrado; registre el pago​

Este caso solo se aplica a estos mensajes después de El pago ha fallado.: La solicitud ha fallado., Respuesta del servidor no válida., Solicitud no válida. y Acceso al pedido no válido. Ante cualquier otro mensaje, siga las instrucciones de Solo El pago ha fallado..

Se ha cobrado a la tarjeta: sí. El panel solo muestra estos mensajes después de que el lector haya confirmado que el pago se ha completado: el lector ha cobrado el pago, pero la tienda no ha podido registrarlo, por lo que el pedido queda sin pagar. Busque el pago en su cuenta de Zettle y regístrelo como se indica en Detener un pago. Si no aparece en su cuenta de Zettle, siga las instrucciones de Solo El pago ha fallado. y no vuelva a cobrar hasta tener la certeza.

Otros mensajes​

Las credenciales de Zettle no están configuradas. El campo ID de cliente de Zettle o Aserción de Zettle está vacío. Pida a quien configuró la pasarela que los rellene: consulte Rellenar los ajustes de la pasarela de pago en Configurar la pasarela.

Un mensaje que empieza por El intercambio OAuth de Zettle ha devuelto HTTP … Zettle ha rechazado las credenciales. Pida a quien configuró la pasarela que compruebe el ID de cliente de Zettle y la Aserción de Zettle.

El panel muestra los botones, pero nunca aparece Cargando lectores… Los scripts de la página de pago no se están cargando. Consulte La página de pago de una pasarela no se ve correctamente.

Mensajes durante la configuración

Guarde el ID de cliente de Zettle y la aserción de arriba antes de vincular un lector. La sección Lectores vinculados necesita ambas credenciales. Introdúzcalas y guarde los cambios.

Introduzca primero el código de vinculación. El campo Código de vinculación está vacío. Lea el código en el lector e introdúzcalo.

No se han podido cargar los lectores vinculados: seguido de la respuesta de Zettle. La página de ajustes no ha podido conectar con Zettle, o Zettle ha rechazado las credenciales. Compruébelas y guarde de nuevo.

Vincular lector muestra un mensaje que empieza por La API de Zettle ha devuelto HTTP … Zettle ha rechazado el código de vinculación. En el lector, abra Ajustes → Vincular con un desarrollador para obtener un código nuevo, introdúzcalo exactamente como aparece y compruebe que el lector está conectado a internet. Si sigue fallando, compruebe que el ID de cliente de Zettle y la Aserción de Zettle están guardados.

PayPal Reader: el lector simulado está activo. Hay un ajuste para desarrolladores, PRWC_USE_MOCK_READER, definido en wp-config.php. Mientras esté definido, no se cobran pagos reales. Pida a su desarrollador o proveedor de alojamiento que lo elimine.

Configurar la pasarela​

Esta parte está dirigida a quien administre WP Admin de la tienda: cinco pasos, desde instalar la extensión hasta activarla para el POS.

Instalar, introducir credenciales, vincular un lector y activarlo para el POS
1

Instalar la extensión

Abra WP Admin > POS > Ajustes > Extensiones, busque PayPal Reader for WooCommerce, haga clic en Instalar y después en Activar. Consulte Instalar una extensión.

Si no utiliza el directorio, descargue el zip del plugin (no el zip del código fuente) desde la página de versiones de GitHub y súbalo mediante Plugins > Add Plugin y después Subir plugin. WooCommerce debe estar activo.

2

Obtener sus credenciales de Zettle

En el portal para desarrolladores de Zettle, obtenga un ID de cliente y una Aserción (un JWT) para su cuenta de Zettle. Para probar la pasarela sin cobrar dinero real, utilice primero una cuenta de comerciante de desarrollo (prueba) de Zettle.

Los modelos de PayPal Reader y los países en los que puede utilizarlos dependen de su cuenta de Zettle, no de WCPOS. Consulte con PayPal antes de comprar un lector.

3

Rellenar los ajustes de la pasarela de pago

  1. Vaya a WP Admin > WooCommerce > Ajustes > Pagos y abra PayPal Reader.
  2. Deje marcada la opción Activar modo de prueba, que es el valor predeterminado, mientras lo prueba con su cuenta de prueba.
  3. Introduzca el ID de cliente de Zettle y la Aserción de Zettle.
  4. Opcional: cambie el Título que seleccionan los cajeros en la página de pago y su Descripción.
  5. Guarde los cambios.
4

Vincular un lector

  1. Desplácese hasta Lectores vinculados, al pie de la misma página de ajustes. Esta sección aparece cuando se han guardado ambas credenciales.
  2. En el PayPal Reader, abra Ajustes → Vincular con un desarrollador. El lector muestra un código de vinculación.
  3. En Vincular un nuevo lector, introduzca el Código de vinculación y un Nombre del lector, como Front counter. Si no introduce un nombre, se llamará WCPOS PayPal Reader.
  4. Haga clic en Vincular lector. La página muestra Lector vinculado. y el lector se añade a la lista.

Todas las cajas ven todos los lectores vinculados a la cuenta de Zettle y el cajero selecciona uno al cobrar. Para eliminar uno, haga clic en Desvincular junto a él y confirme.

5

Activarlo para el POS

Vaya a WP Admin > POS > Ajustes > Finalizar compra, busque PayPal Reader y active Activado. Consulte Activar una pasarela de pago.

nota

Deje sin marcar Activar PayPal Reader para el pago web (no es necesario para WCPOS). Esta opción solo hace que la pasarela aparezca en la tienda en línea; el POS la utiliza una vez activada aquí.

Modo de prueba y paso a pagos reales​

El Modo de prueba no cambia el lector a un entorno de pruebas. Zettle utiliza las mismas direcciones para los pagos de prueba y los reales; la cuenta asociada a sus credenciales determina si se mueve dinero real. El modo de prueba solo cambia las etiquetas del panel de pago: el indicador MODO DE PRUEBA y Modo: prueba. en la línea de estado.

Para pasar a pagos reales:

  1. Sustituya el ID de cliente de Zettle y la Aserción de Zettle por los de su cuenta real de Zettle.
  2. Desmarque Activar modo de prueba y guarde los cambios.
  3. Compruebe Lectores vinculados. La lista procede de la cuenta de Zettle, por lo que los lectores vinculados a la cuenta de prueba no aparecen: vuelva a vincularlos, como se indica en Vincular un lector, en Configurar la pasarela.
  4. Cobre un pago real de un importe pequeño y reembólselo en Zettle.

Referencia de ajustes​

En WP Admin > WooCommerce > Ajustes > Pagos > PayPal Reader. Los pasos anteriores explican los ajustes necesarios; abra la lista para ver todos los ajustes y sus valores predeterminados.

Los 6 ajustes y el panel de vinculación
AjusteFunción
Activar/DesactivarActivar PayPal Reader para el pago web (no es necesario para WCPOS). Muestra la pasarela en la tienda en línea. Déjelo desactivado: en línea, solo funciona en la página de pago de un pedido existente. Está desactivado de forma predeterminada. El POS tiene su propio interruptor en POS > Ajustes > Finalizar compra
TítuloEl nombre que seleccionan los cajeros en la página de pago. El valor predeterminado es PayPal Reader
DescripciónLa línea que se muestra debajo del título. El valor predeterminado es Pay in person using PayPal Reader.
Modo de pruebaActivar modo de prueba. Muestra el indicador MODO DE PRUEBA en el panel de pago. Está activado de forma predeterminada. No cambia el destino de los pagos
ID de cliente de ZettleSu ID de cliente OAuth de Zettle, obtenido en el portal para desarrolladores de Zettle
Aserción de ZettleSu aserción OAuth de Zettle (un JWT). Se mantiene oculta como una contraseña

Lectores vinculados, debajo de los ajustes, muestra cada lector por su nombre e ID de vinculación, con la opción Desvincular. Vincular un nuevo lector solicita un Código de vinculación y un Nombre del lector.

Registros​

Las notas del pedido son el primer lugar que debe consultar: en el pedido se anotan el inicio de un pago, su finalización o rechazo por el importe, y las veces que se pulsa Cancelar pago en la caja. No se anotan los rechazos de tarjeta, las cancelaciones en el lector ni las pérdidas de conexión: consulte el recuadro de registro en la página de pago.

Cuando el servicio de lectores de Zettle rechaza una solicitud o no se puede conectar con él, la extensión también lo registra en WP Admin > WooCommerce > Status > Registros, con el origen paypal-reader-for-woocommerce. Envíe ese registro y el número de pedido cuando solicite ayuda.

Requisitos​

Cuenta de Zettle: Una cuenta de comerciante de PayPal Zettle, con un ID de cliente y una aserción (JWT) del portal para desarrolladores de Zettle
Lector: Un PayPal Reader vinculado a esa cuenta. Los modelos y los países dependen de su cuenta de Zettle
Conexión: Solo con conexión a internet. La caja se comunica con el lector a través de Zettle por internet, por lo que la caja, el lector y su tienda necesitan conexión
WCPOS: WCPOS Pro
Servidor: WordPress 5.2 o posterior, WooCommerce y PHP 7.4 o posterior

Funciones no disponibles​

  • Reembolsos a través de Zettle desde WooCommerce o el POS.
  • Propinas en el lector.
  • Pagos parciales: el lector siempre cobra el pedido completo.
  • Reanudar un pago después de cerrar o recargar la página de pago.
  • El proceso de pago habitual de la tienda en línea. En línea, solo funciona en la página de pago de un pedido existente.
Cómo funciona, para desarrolladores

La tienda inicia sesión en Zettle con la concesión OAuth JWT-bearer (oauth.zettle.com) y almacena el token de acceso en caché hasta 30 segundos antes de que caduque. La vinculación, la lista de lectores y las sesiones de pago utilizan la API Reader Connect de Zettle (reader-connect.zettle.com/v1/integrator): la vinculación reclama una oferta de enlace con el código del lector, y cada lector es un enlace.

Iniciar pago con el lector solicita a la tienda que abra una sesión para el enlace seleccionado. A continuación, la página de pago abre un WebSocket con Zettle, solicita el estado del lector y envía la solicitud de pago por el total del pedido, sin propinas, cuando el lector está listo. Las actualizaciones del progreso llegan por el mismo socket. Cancelar pago envía una solicitud de cancelación a través de él.

Cuando el lector comunica COMPLETED, la página envía el resultado a la tienda, que solo lo acepta si el importe coincide con el total del pedido. Guarda el ID del pago con tarjeta de Zettle como ID de transacción y realiza el pedido. El pedido no se puede realizar hasta que se supere esa comprobación.

Para las pruebas automatizadas, PRWC_USE_MOCK_READER (o el filtro paypal_reader_for_woocommerce_use_mock_reader), junto con PRWC_MOCK_CANCEL_BEHAVIOR, sustituye Zettle por un lector simulado. Nunca se muestra en los ajustes y WP Admin muestra una advertencia mientras está activado.