Ir al contenido principal
Versión: 2.x

Pasarela de pago Windcave Terminal

Windcave Terminal envía una venta desde la caja a un terminal Windcave. El cliente paga en el terminal y la caja registra el pago cuando Windcave lo confirma.

Esta página comienza en la caja. Administradores de la tienda: Configurar Windcave Terminal explica las credenciales, los ajustes de WP Admin y cómo comprobar que funciona.

Función Pro

Windcave Terminal requiere WCPOS Pro 2.0 o posterior y la versión 1.0 o posterior de la extensión.

Aún no cuenta con la certificación de Windcave

Solo pagos de prueba: no acepte todavía la tarjeta de un cliente real en Windcave. Windcave aprueba todas las integraciones de punto de venta antes de permitir pagos reales y todavía no ha aprobado esta.

Qué no se ha probado

La extensión todavía no se ha ejecutado en un terminal Windcave físico. Sus pagos y reembolsos se han probado con un sustituto del servicio HIT de Windcave, creado a partir de su documentación. Realice una venta UAT de importe reducido y reembólsela antes de confiar en ella.

Aceptar un pago con tarjeta​

Abra primero la caja

Si Abrir y cerrar la caja está activado, la caja no registrará un pago mientras esté cerrada y tendrá que reembolsar cualquier tarjeta que ya haya cobrado. Consulte Cajas para ver el ajuste.

  1. Pulse Pagar en el carrito y toque el mosaico Windcave Terminal en la pestaña Payments. Si sus terminales solicitan una firma, use en su lugar la pestaña Legacy: consulte Cuando el terminal hace una pregunta.
  2. Mire encima del teclado. Si aparece Choose a terminal, toque el Station ID del terminal de su mostrador: el nombre que Windcave asigna a cada terminal, como DOCS-STATION-1. Si aparece Terminal: y un ID, ese es el terminal que usa esta caja; pulse Change para elegir otro. La caja recuerda su elección.
  3. Para cobrar en la tarjeta solo una parte del saldo, introduzca el importe. El resto quedará pendiente para otro pago.
  4. Pulse Send … to Windcave Terminal. La caja muestra On the terminal con cuatro pasos: Sent, On terminal, Approved y Captured, que significa que se ha cobrado el dinero.
  5. El cliente acerca, inserta o desliza la tarjeta en el terminal. Cuando se captura el pago y no queda ningún importe pendiente, se abre el recibo. Si queda algo por pagar, cóbrelo con otro mosaico.
Caja en la pestaña Payments para una venta de $45.00: mosaico Windcave Terminal seleccionado, dos Station ID bajo Choose a terminal, Full balance debajo y botón Send $45.00 to Windcave Terminal atenuado hasta elegir un terminal
  1. Windcave Terminal — el mosaico, resaltado al tocarlo.
  2. Station IDs bajo Choose a terminal — toque el del mostrador. Cuando esta caja ya tenga uno, esta fila mostrará Terminal: y su ID, junto con Change.
  3. To pay — el importe de este pago. Introduzca uno menor para cobrar solo una parte del saldo con la tarjeta.
  4. Full balance — vuelve a colocar en To pay el importe total que aún se debe.
  5. Send … to Windcave Terminal — inicia el pago en el terminal. El botón está atenuado hasta que se elige un terminal.
  6. Legacy — la otra pestaña de pago, para pasarelas con su propia página de pago. Úsela cuando el terminal solicite una firma.

Details, debajo de los cuatro pasos, abre un registro del pago e indica a qué Station se envió. El terminal no admite propinas, recargos ni retirada de efectivo.

Cuando el terminal hace una pregunta​

Un terminal puede detenerse y preguntar algo, por ejemplo, si coincide la firma del cliente. En esta versión, la pestaña Payments no muestra esas preguntas. La pestaña Legacy sí lo hace:

  1. Abra la pestaña Legacy y elija Windcave Terminal. Consulte La pestaña Legacy.
  2. Inicie allí el pago. Se cobrará todo el pedido en un solo pago.
  3. Cuando el terminal pregunte, la página de pago mostrará la pregunta con los botones propios del terminal, como YES y NO. Pulse la respuesta correspondiente.

Cancelar un pago​

Pulse Cancel on terminal antes de que pague el cliente. Solo funciona mientras el terminal ofrezca CANCEL. Si no lo ofrece, la caja indica The terminal is not offering cancel right now. Cancel on the terminal.

La cancelación es una solicitud. Si ya se ha leído la tarjeta, el pago aún puede completarse: la caja muestra Cancelling — waiting for the terminal to confirm, sigue comprobando y muestra el resultado. Espere a que termine antes de cobrar de otra forma.

Si la caja no obtiene respuesta, ofrece Release this payment. Liberar el pago no significa cancelarlo: púlselo solo después de que un administrador compruebe en el portal de Windcave que no hay ningún pago aprobado para el pedido. Entonces se podrá pagar el pedido de otra forma y la tienda seguirá comprobando el terminal.

Si algo sale mal​

Cuando es posible que el cliente haya pagado​

No vuelva a cobrar el pago

En estos dos casos, es posible que ya se haya cobrado la tarjeta. Un administrador debe comprobar primero el portal de Windcave, donde la venta aparece con el número de pedido.

Could not confirm the terminal result. Check Windcave before taking payment again. La caja volvió a consultar un pago que ya había enviado y Windcave dio una respuesta ambigua. Vuelva a cobrar solo después de que un administrador haya buscado la venta en el portal y confirmado que no aparece.

Payment failed: The terminal confirmed a different amount. El terminal aprobó un importe distinto del que envió la caja, por lo que esta no lo registró, pero es posible que se haya cobrado la tarjeta. No vuelva a cobrar: pida a un administrador que busque la venta en el portal por número de pedido y compare el importe cobrado por el terminal con el del pedido.

Otros mensajes​

Pago fallido: tarjeta rechazada

Pulse Try again para volver a enviarlo al terminal o Choose another way para pagar con otro mosaico.

El terminal todavía está completando una transacción anterior

La Station está ocupada con otro pago. Complételo o cancélelo en el terminal y, después, pulse Try again.

El pago falla justo después de enviarlo

La extensión espera 30 segundos a que Windcave registre un pago nuevo. Si para entonces Windcave aún no lo ha registrado, la extensión lo considera no enviado y el pago falla. Compruebe que el terminal esté encendido y conectado, y que su Station ID figure en los ajustes; después, pulse Try again.

El terminal hace una pregunta y la caja sigue esperando

La pestaña Payments no muestra las preguntas del terminal, por lo que espera hasta que finalice el pago. Pulse Cancel on terminal o cancele en el terminal y, después, realice el pago en la pestaña Legacy. Consulte Cuando el terminal hace una pregunta.

Tiempo agotado — pago cancelado

Nadie pagó en 5 minutos. Compruebe el terminal y, después, pulse Try again.

El mosaico Windcave Terminal aparece atenuado o no está disponible

Debajo de los mosaicos, la caja indica el motivo. Consulte Cuando no se puede usar un mosaico para ver todos los motivos.

  • In use by order #… — la Station está ocupada con el pago de otro pedido. Termine o cancele ese pago, o pulse Change y elija otra Station.
  • Needs a connection — la caja está sin conexión. El pago con terminal se procesa a través de la tienda; utilice otro tipo de pago o espere a que se recupere la conexión.
  • No tile at all — a la pasarela le falta HIT username, HIT key o Station IDs, o no está activada en WCPOS. Un administrador debe revisar la configuración.

Reembolsar un pago de Windcave​

El reembolso se procesa a través de Windcave en la Station que cobró la venta, por el importe total o por una parte.

  1. En el POS, abra el reembolso del pedido. Consulte Reembolsos.
  2. Elija Refund to Windcave Terminal y pulse Process Refund.
  3. La tienda espera hasta 20 segundos la respuesta de Windcave y, después, añade el resultado a las notas del pedido.

Un reembolso en WP Admin con el botón de WooCommerce Refund … via Windcave Terminal funciona del mismo modo.

Si un reembolso permanece pendiente de pago, compruébelo en el portal de Windcave antes de volver a reembolsar.

Un reembolso permanece pendiente

Windcave no respondió en 20 segundos o aprobó un importe distinto del solicitado. La tienda no vuelve a intentarlo. Busque el reembolso en el portal de Windcave: si se procesó, el cliente ya tiene el dinero; si no, vuelva a reembolsar.

No se puede reembolsar una venta cobrada con la versión 0.1

El reembolso se detiene con Configure a default Station in POS settings before refunding this sale. La versión 0.1 de la extensión no registraba qué Station cobró la venta, así que la versión 1.0 la reembolsa en una Station predeterminada para toda la tienda. Ahora cada caja elige su Station en Settings > Card readers, y WCPOS 2.0 aún no tiene un valor predeterminado para toda la tienda. Reembolse la venta en el portal de Windcave o en el terminal y, después, regístrela en WooCommerce con Refund … manually.

Configurar Windcave Terminal​

Un administrador realiza esta operación una vez por tienda en WP Admin y, después, elige una Station en cada caja. La tienda se conecta a cada terminal a través de Windcave por Internet, por lo que no es necesario emparejarlos y cualquier caja puede usar cualquiera de sus terminales.

Requisitos​

Necesita credenciales HIT, un HIT username y una HIT key, además del Station ID de cada terminal. Windcave los proporciona; WP Admin no puede consultarlos ni crearlos. Póngase en contacto con Windcave y solicite credenciales HIT de UAT y el Station ID de cada terminal, o utilice el formulario de requisitos de integración de Windcave para obtener una cuenta de desarrollo. UAT y producción tienen cada una su propio nombre de usuario y clave, y Windcave proporciona un Vendor ID cuando certifica la integración.

Cuenta de Windcave: Credenciales HIT y un Station ID por terminal. Credenciales UAT hasta que Windcave certifique la integración
Terminal: Un terminal Windcave que acepte pagos HIT
WCPOS: WCPOS Pro 2.0 o posterior y la versión 1.0 o posterior de la extensión
Servidor: WooCommerce y PHP 7.4 o posterior con la extensión DOM (php-xml)

Instalar la extensión​

Abra WP Admin > POS > Ajustes > Extensiones, busque Windcave Terminal for WooCommerce, instálela y actívela. Necesita la versión 1.0 o posterior; la versión 0.1 es para WCPOS anterior a 2.0. Consulte Extensiones.

También puede subir el archivo ZIP del plugin (no el ZIP del código fuente) desde la página de versiones de GitHub, en Plugins > Add Plugin > Subir plugin.

Sin WCPOS Pro 2.0, WP Admin muestra Windcave Terminal requires WooCommerce POS Pro 2.0 or newer. y no añade la pasarela. Se rechaza la activación si PHP es anterior a 7.4 o si falta la extensión DOM: pida a su proveedor de alojamiento que habilite php-xml.

Introducir las credenciales HIT​

Vaya a WP Admin > WooCommerce > Ajustes > Pagos y abra Windcave Terminal.

WP Admin, ajustes de Windcave Terminal: Environment UAT (testing), HIT username, HIT key, Station IDs y Vendor ID vacíos, y nombre POS WCPOS
  1. Environment — déjelo en UAT (testing), el valor predeterminado. Production se usa después de que Windcave certifique la integración, con credenciales de producción.
  2. HIT username — el que proporciona Windcave para el entorno elegido.
  3. HIT key — la proporciona Windcave. Una vez guardada, el campo queda vacío: déjelo así para conservar la clave guardada.
  4. Station IDs — uno por línea, uno para cada terminal. Windcave los proporciona; no se detectan automáticamente.
  5. Vendor ID — déjelo vacío hasta que Windcave proporcione uno.
  6. POS name — el nombre de su POS en Windcave. WCPOS de forma predeterminada.

Debajo, Result notifications (FPRN) es opcional. Si se marca, Windcave también avisa a la tienda cuando hay un resultado disponible, como respaldo de las comprobaciones de la caja. Para que funcione, el sitio debe ser accesible desde Internet.

Haga clic en Save changes.

Activarlo en WCPOS​

Vaya a WP Admin > POS > Ajustes > Finalizar compra, busque Windcave Terminal en la tabla Gateways y active Enabled. Esa pantalla guarda los cambios automáticamente; no hay ningún botón para guardar.

Deje desactivado Enable/Disable en la página de ajustes de WooCommerce. El POS utiliza la pasarela cuando Enabled está activado aquí, esté marcada o no esa casilla. Consulte Ajustes de la caja.

WP Admin, ajustes de POS, Checkout: dos filas de la tabla Gateways, Vipps MobilePay activado y Windcave Terminal desactivado
  1. Windcave Terminal — la fila de la extensión en la tabla Gateways.
  2. Enabled — el interruptor junto al ID de la pasarela; actívelo. Cuando se vuelva a cargar, la caja mostrará el mosaico Windcave Terminal.

Elegir la Station de cada caja​

En cada caja, abra Settings > Card readers. Cada Station ID introducido aparece como lector en Smart readers, todos marcados como Online: la extensión no pregunta a Windcave si un terminal está encendido. Pulse Use this reader en la Station del mostrador; su fila mostrará Selected. El cajero todavía puede pulsar Change en la caja.

Si solo hay una Station, no hay nada que elegir: ya aparece Selected en todas las cajas. Consulte Elegir un lector inteligente.

Comprobar que funciona​

  1. Al volver a la página de ajustes de Windcave Terminal, la línea debajo de los ajustes muestra uat: HIT credentials configured (not verified). Esto significa que el nombre de usuario y la clave están guardados, no que Windcave los haya aceptado. HIT credentials missing. significa que falta uno.
  2. En una caja, vuelva a cargar el POS y pulse Pagar. El mosaico Windcave Terminal aparecerá entre las formas de pago. Tóquelo: los Station ID aparecerán encima del teclado, bajo Choose a terminal o como Terminal: junto al que usa esta caja.
  3. Realice una venta de importe reducido en un terminal UAT y, después, reembólsela. No hay ningún botón para probar la conexión: esta primera venta sirve para comprobar las credenciales y el Station ID.

Actualizar desde la versión 0.1​

  • Actualice primero WCPOS, WCPOS Pro y la aplicación a 2.0 y, después, la extensión.
  • Los pagos en curso durante la actualización se conservan. No se cobra nada dos veces.
  • Un pago que la versión 0.1 dejó apartado se conserva si el pedido sigue sin pagar. De lo contrario, se añade una nota al pedido: Windcave TxnRef … was set aside before the 1.0.0 upgrade and is no longer followed automatically. Compruebe ese pago en el portal de Windcave: si se aprobó, reembólselo allí o regístrelo manualmente en el pedido.
  • Estos ajustes de la versión 0.1 han desaparecido: Default Station ID, Lock terminal selection, Checkout logs y Log level. Ahora cada caja elige su Station en Settings > Card readers.
  • La opción de apartar pagos también ha desaparecido, y el texto del recibo del terminal ya no se añade al pedido como nota privada.
  • Para reembolsar una venta cobrada con la versión 0.1, consulte Reembolsar un pago de Windcave.

Referencia de ajustes​

En WP Admin > WooCommerce > Ajustes > Pagos > Windcave Terminal:

AjusteQué hace
Enable/DisableOfrece la pasarela en la caja de su tienda en línea. Déjela desactivada; el POS tiene su propio interruptor en POS > Ajustes > Finalizar compra
TitleEl nombre del mosaico en la caja. De forma predeterminada, Windcave Terminal
DescriptionDe forma predeterminada, Pay in person on the Windcave terminal.
EnvironmentUAT (testing) (predeterminado) o Production. Cada uno tiene sus propias credenciales HIT; Production requiere la certificación de Windcave. Los pagos iniciados en un entorno siempre se comprueban en ese mismo entorno
Nombre de usuario HITProporcionado por Windcave para el entorno elegido
HIT keyLa proporciona Windcave. No se vuelve a mostrar una vez guardada; déjela vacía para conservarla
Station IDsUno por línea, uno por terminal. Se eliminan los duplicados
Vendor IDSe acuerda con Windcave durante la certificación. Déjelo vacío hasta entonces
Nombre del POSEl nombre con el que Windcave identifica su POS. El valor predeterminado es WCPOS
Notificaciones de resultados (FPRN)Windcave también avisa a su tienda cuando hay un resultado, como respaldo a las comprobaciones de la caja. Desactivadas de forma predeterminada

Registros y paquete de soporte​

Al final de la página de ajustes aparecen el paquete de soporte, la línea de credenciales y un enlace a los registros.

WP Admin, parte inferior de los ajustes de Windcave Terminal en una tienda aún no configurada: paquete de soporte con su botón Download support bundle, línea uat: HIT credentials missing y View logs
  1. Línea de credenciales — HIT credentials missing. en esta tienda, que aún no está configurada. En la suya debería aparecer HIT credentials configured (not verified).
  2. View logs — abre WooCommerce > Status > Registros, con el origen windcave-terminal.
  3. Download support bundle — un archivo para el equipo de soporte de WCPOS.

Los registros guardan cada solicitud enviada a Windcave y su respuesta, con la HIT key y los números de tarjeta ocultos.

Si un pago falla, haga clic en Download support bundle y envíe el archivo al equipo de soporte de WCPOS junto con el número de pedido. WCPOS Pro añade este botón: el paquete incluye todos los proveedores de pago del POS en su sitio, con los secretos y los números de tarjeta eliminados.

Funciones no disponibles​

  • Pagos reales, hasta que Windcave certifique la integración.
  • Propinas, recargos, retirada de efectivo o autorización ahora y captura posterior.
  • Responder a las preguntas del terminal en la pestaña Payments. Use la pestaña Legacy.
  • Detección automática de terminales: debe introducir cada ID de estación.
  • Comprobar las credenciales HIT antes del primer pago.
Cómo funciona, para desarrolladores

La pasarela utiliza Windcave HIT (Host Initiated Transaction) a través de HTTPS: uat.windcave.com para UAT y sec.windcave.com para producción. Cada terminal se identifica mediante su Station ID.

El pago envía una Purchase por el importe de la caja, con Order # y el número de pedido como referencia del comercio; después, WCPOS Pro comprueba su estado hasta que se completa. Si la caja vuelve a preguntar, la extensión consulta primero la misma referencia de transacción en lugar de iniciar otra Purchase. Una Purchase que Windcave no haya registrado en 30 segundos se considera no enviada.

Con Result notifications (FPRN) activado, cada Purchase pide a Windcave que llame al webhook de pagos de WCPOS de su tienda, wp-json/wcpos/v2/payments/webhook con provider=windcave y la referencia de transacción. La llamada solo sirve de aviso: después, la tienda consulta directamente el resultado a Windcave.

Un reembolso es un Refund HIT asociado a la transacción original de Windcave, por el importe que introduzca. La tienda comprueba su estado cada 2 segundos durante un máximo de 20 segundos.