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.
Windcave Terminal requiere WCPOS Pro 2.0 o posterior y la versión 1.0 o posterior de la extensión.
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. 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.Qué no se ha probado
Aceptar un pago con tarjeta
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.
- 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.
- 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. - Para cobrar en la tarjeta solo una parte del saldo, introduzca el importe. El resto quedará pendiente para otro pago.
- 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.
- 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.

- Windcave Terminal — el mosaico, resaltado al tocarlo.
- 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.
- To pay — el importe de este pago. Introduzca uno menor para cobrar solo una parte del saldo con la tarjeta.
- Full balance — vuelve a colocar en To pay el importe total que aún se debe.
- Send … to Windcave Terminal — inicia el pago en el terminal. El botón está atenuado hasta que se elige un terminal.
- 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:
- Abra la pestaña Legacy y elija Windcave Terminal. Consulte La pestaña Legacy.
- Inicie allí el pago. Se cobrará todo el pedido en un solo pago.
- 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
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.
- En el POS, abra el reembolso del pedido. Consulte Reembolsos.
- Elija Refund to Windcave Terminal y pulse Process Refund.
- 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.
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.

- 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.
- HIT username — el que proporciona Windcave para el entorno elegido.
- HIT key — la proporciona Windcave. Una vez guardada, el campo queda vacío: déjelo así para conservar la clave guardada.
- Station IDs — uno por línea, uno para cada terminal. Windcave los proporciona; no se detectan automáticamente.
- Vendor ID — déjelo vacío hasta que Windcave proporcione uno.
- POS name — el nombre de su POS en Windcave.
WCPOSde 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.

- Windcave Terminal — la fila de la extensión en la tabla Gateways.
- 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
- 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. - 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.
- 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:
| Ajuste | Qué hace |
|---|---|
| Enable/Disable | Ofrece 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 |
| Title | El nombre del mosaico en la caja. De forma predeterminada, Windcave Terminal |
| Description | De forma predeterminada, Pay in person on the Windcave terminal. |
| Environment | UAT (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 HIT | Proporcionado por Windcave para el entorno elegido |
| HIT key | La proporciona Windcave. No se vuelve a mostrar una vez guardada; déjela vacía para conservarla |
| Station IDs | Uno por línea, uno por terminal. Se eliminan los duplicados |
| Vendor ID | Se acuerda con Windcave durante la certificación. Déjelo vacío hasta entonces |
| Nombre del POS | El 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.

- Línea de credenciales —
HIT credentials missing.en esta tienda, que aún no está configurada. En la suya debería aparecerHIT credentials configured (not verified). - View logs — abre
WooCommerce > Status > Registros, con el origenwindcave-terminal. - 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.
Documentación relacionada
- Lectores de tarjetas
- La pestaña Legado
- Reembolsos
- Ajustes de caja
- Notifique un problema en GitHub. Para cuestiones relacionadas con su cuenta, credenciales y terminales, contacte con Windcave.