VibeFox Nets Nexi for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Cuenta de Nets: necesitas las claves secretas de tu cuenta de Nets Easy (prueba y producción). Solo se usan las claves secretas. Las claves de checkout no son necesarias, porque los clientes pagan en la página de pago alojada de Nets.
Monedas y métodos de pago: el plugin no restringe monedas ni países. Usa las monedas habilitadas en tu cuenta de Nets; si Nets no admite una moneda, lo indica al crear el pago. Los métodos de pago que ve el cliente dependen de tu contrato con Nets, del país y de la moneda.
HTTPS para los webhooks: Nets solo llama a direcciones HTTPS públicas de como máximo 256 caracteres y sin "&", así que tu sitio necesita HTTPS y enlaces permanentes amigables para recibir webhooks. En otros sitios, el pago se sigue confirmando cuando el cliente vuelve a la tienda o con la acción del pedido.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un dominio.
Instalación
1. En WordPress ve a Plugins > Add New > Upload Plugin, elige el archivo ZIP del plugin y haz clic en Install Now. También puedes subir la carpeta wcp_nets_nexi_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > Nets Nexi (Nordics) > Manage, o haz clic en Settings debajo del nombre del plugin en la página Plugins.
4. Introduce tu clave de licencia de VibeFox en el bloque de licencia de la parte superior de la página y haz clic en Activate.
5. Copia la clave secreta de prueba desde el portal de prueba de Nets Easy y pégala en Test Secret Key (consulta Configuración).
6. Activa Enable/Disable, deja Test Mode activado y haz un pedido de prueba. Después introduce la clave secreta en vivo y desmarca Test Mode.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Nets Nexi (Nordics). Encima de los campos, la página te avisa si falta la clave secreta del modo seleccionado (en ese caso, el método de pago se oculta en la finalización de compra), y muestra Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged. mientras el modo de prueba está activado. En la lista de métodos de pago, Nets Nexi aparece como pendiente de configuración hasta que el modo seleccionado tenga una clave secreta.
General
Enable/Disable: Enable Nets Nexi Gateway activa o desactiva el método de pago. Por defecto: desactivado.
Title: el título del método de pago que ven los clientes en la finalización de compra. Por defecto: Nets Easy.
Description: la descripción del método de pago que ven los clientes en la finalización de compra. Por defecto: Pay securely with Nets Easy.
Claves de API
Copia las claves secretas desde el portal de Nets Easy en Company > Integration: el portal de prueba (test.portal.dibspayment.eu) para la clave de prueba y el portal en vivo (portal.dibspayment.eu) para la clave en vivo. Las claves de checkout no son necesarias.
Test Mode: Enable test mode. El modo de prueba usa test.api.dibspayment.eu con la clave secreta de prueba; el modo en vivo usa api.dibspayment.eu con la clave secreta en vivo. Las capturas y los reembolsos de un pedido siempre usan el entorno en el que se pagó. Por defecto: activado.
Test Secret Key: tu clave secreta de la API del entorno de prueba de Nets.
Live Secret Key: tu clave secreta de la API del entorno en vivo de Nets.
Pago
Las notificaciones de Nets (webhooks) se registran automáticamente con cada pago. No hay nada que configurar en el portal de Nets. Esta sección muestra la URL del webhook. Tiene este aspecto: https://your-site/wc-api/nng_nets_nexi/. Si la URL no es una dirección HTTPS pública, la sección te avisa de que el sitio no recibe webhooks; en ese caso, los pagos se confirman cuando el cliente vuelve a la tienda o con la acción del pedido Nets: check payment status and capture. Se registran estos eventos:
Cada webhook debe llevar el secreto aleatorio que el plugin creó para ese pedido. Los webhooks sin el secreto correcto se rechazan. El webhook solo indica qué pago cambió: el pago en sí siempre se lee desde la API de Nets con tu clave secreta.
Order Status After Payment: el estado del pedido cuando Nets ha confirmado y cobrado el pago. El estado se establece de una vez, para que el cliente reciba un solo correo electrónico.
Avanzado
Debug log: Enable debug logging registra las llamadas a la API y los cambios de estado de los pagos en WooCommerce > Status > Logs, origen wcp_nets_nexi_gateway. Los errores siempre se registran. Las claves y los datos de los clientes no se registran. Por defecto: desactivado.
Delete Data on Uninstall: Delete the plugin settings and logs when the plugin is deleted. Desactivar el plugin nunca borra nada. Los datos de pago guardados en los pedidos siempre se conservan. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto Nets Easy) y realiza el pedido. El plugin crea un pago de Nets con las líneas del pedido, el envío y las tasas en la moneda del pedido, y envía al cliente a la página de pago alojada de Nets. El correo electrónico, el nombre, la dirección y el teléfono del cliente se pasan a Nets cuando Nets acepta su formato; la página de tus términos y condiciones aparece enlazada en la página de Nets. En modo de prueba, la finalización de compra muestra Test mode: no real money will be charged.
El cliente paga y vuelve a la página de pedido recibido de tu tienda. El pedido solo se marca como pagado cuando Nets lo confirma: el plugin lee el pago desde la API de Nets, compara el importe y la moneda reservados con el pedido, cobra la reserva y solo entonces completa el pedido. Esto sucede en el webhook, al volver el cliente a la página de pedido recibido, o con la acción del pedido Nets: check payment status and capture.
Si el cliente cancela en la página de Nets, vuelve a la finalización de compra o a la página Pay for order con el mensaje The Nets payment was cancelled. You can try again or choose another payment method. Un cliente puede volver a pagar un pedido sin pagar. El plugin comprueba primero el pago anterior; si ya está pagado, el pedido se confirma. Si no, la sesión anterior de Nets se cierra antes de iniciar una nueva. Si un pago del pedido está retenido para tu revisión, el cliente ve A payment for this order is already being reviewed by the shop. Please contact us instead of paying again.
Si Nets no puede iniciar el pago, el cliente ve un mensaje breve, por ejemplo Nets could not start the payment with the details of this order. Please check your address and phone number, or choose another payment method. o The payment service could not be reached. Please try again in a moment. Los detalles se escriben en el registro.
El método de pago funciona en el checkout clásico, en el bloque Checkout y en la página Pay for order. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin usa solo la página de pago alojada. No tiene checkout de Nets integrado en la página, ni suscripciones o pagos recurrentes, ni tarjetas guardadas, ni cargos por factura, ni modo solo autorización, ni capturas parciales por envío.
Pedidos y reembolsos
Estados del pedido
Pending payment: el cliente fue enviado a Nets y todavía no ha pagado. La nota del pedido muestra el ID del pago de Nets, el importe y el entorno.
Processing or Completed: Nets confirmó y cobró el pago. El estado sigue a Order Status After Payment. La nota del pedido muestra el ID del pago, el ID del cobro y el método de pago. El ID de transacción es el ID del pago de Nets.
On hold: el importe o la moneda en Nets difieren del pedido (no capturado), la captura fue rechazada, o el cliente pagó después de que el pedido se hubiera cancelado (reservado, no capturado). La nota del pedido lo explica. Después de revisar el pedido, captura con la acción Nets: check payment status and capture, o cancela la reserva en el portal de Nets.
Cancelled: la reserva del último pago del pedido fue cancelada, por ejemplo en el portal de Nets.
Los webhooks y las recargas repetidas nunca cobran dos veces ni añaden notas, reducciones de stock o correos duplicados, y un pedido que se pagó, reembolsó o canceló después del pago nunca vuelve a abrirse. Si se completa un enlace de pago antiguo de un pedido que ya está pagado, la segunda reserva se libera automáticamente; si ya se cobró, una nota te pide que la reembolses en el portal de Nets.
Acción del pedido
Para los pedidos sin pagar con un pago de Nets, la lista de acciones del pedido incluye Nets: check payment status and capture. Lee el pago desde Nets y captura una reserva que coincida. Si no cambia nada, una nota explica el motivo, por ejemplo que el cliente todavía no ha completado el pago.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Nets Easy (el botón usa el título del método de pago). Se admiten reembolsos totales y parciales una vez cobrado el pago; un pago que solo está reservado puede cancelarse en el portal de Nets. El reembolso se aplica al cobro del pedido en el entorno en el que se pagó. Si Nets no acepta el reembolso, WooCommerce muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade a las notas del pedido con el ID del reembolso de Nets.
Los reembolsos hechos directamente en el portal de Nets no se convierten en reembolsos de WooCommerce. Si es necesario, crea un reembolso manual en WooCommerce sin usar Refund via Nets Easy.
Clave de licencia
El plugin funciona con una clave de licencia de VibeFox obtenida en vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Payments > Nets Nexi (Nordics). Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo la fecha hasta la que la licencia está activa y tu dominio. Usa Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.
Una clave funciona en un dominio. Eliminar la clave de un sitio no libera su espacio de dominio. Libéralo en tu cuenta de vibefox.net.
Sin una clave activa, Nets Nexi no se muestra a los clientes en la finalización de compra. Si se inicia un pago de todos modos, el cliente ve This payment method is not available. Please choose another one. Los gestores de la tienda que han iniciado sesión siguen viendo el método de pago, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar el plugin antes de comprar una clave. Aparece un aviso en la página Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los pagos ya iniciados se siguen confirmando y los reembolsos funcionan.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren renovarla. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Nets Nexi no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado y que el modo seleccionado tiene una clave secreta: Test Secret Key en modo de prueba, Live Secret Key en modo en vivo. La página de configuración muestra un aviso cuando falta la clave.
El pago se realizó, pero el pedido sigue en Pending payment: el webhook no llegó a tu tienda. Comprueba que el sitio usa HTTPS y enlaces permanentes amigables, de modo que la URL del webhook de la sección Payment sea una dirección HTTPS pública sin "&", y que la clave secreta del entorno del pago está configurada. Después usa la acción del pedido Nets: check payment status and capture. El pedido también se confirma cuando el cliente vuelve a la página de pedido recibido.
Webhook answers Unauthorized: el webhook no llevaba el secreto de ese pedido. Los webhooks solo se aceptan con el secreto registrado con el pago.
Webhook answers Busy, retry later, Payment lookup failed o Payment not reserved yet: otra solicitud estaba actualizando el pedido, no se pudo contactar con la API de Nets, o la reserva aún no era visible. Nets vuelve a intentar el webhook automáticamente.
El cliente ve un error al realizar el pedido: activa Debug log y revisa WooCommerce > Status > Logs, origen wcp_nets_nexi_gateway. This payment method is temporarily unavailable. Please choose another payment method. suele indicar una clave secreta incorrecta o inexistente. Nets indica en el registro las monedas rechazadas.
Order is On hold after payment: lee la nota del pedido. Si la captura fue rechazada, vuelve a intentarlo con la acción del pedido Nets: check payment status and capture o cóbralo en el portal de Nets. Si el importe o la moneda no coinciden, revisa el pago en el portal de Nets. Si el cliente pagó después de la cancelación, revisa el pedido y captura o cancela la reserva.
Refund via Nets Easy no aparece o falla: los reembolsos solo son posibles después de cobrar el pago. Comprueba en la nota del pedido que el cobro existe. Un reembolso usa la clave secreta del entorno en el que se pagó el pedido, así que esa clave debe estar configurada.
The license block shows an error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera un espacio en tu cuenta de vibefox.net y haz clic en Check now. Si cambió la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los datos. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. La configuración de la pasarela y los registros se eliminan solo si Delete Data on Uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
Nets, Nets Easy y Nexi son marcas comerciales de sus respectivos propietarios. Este plugin no está afiliado ni cuenta con el respaldo de Nets ni de Nexi.