VibeFox Nets Nexi for PrestaShop — Ayuda

Requisitos

PrestaShop: 8.0 a 9.x.

PHP: 8.0 o posterior con la extensión cURL. El módulo no se instala en versiones anteriores de PHP ni sin cURL.

Cuenta de Nets: necesitas las claves secretas de tu cuenta de Nets Easy (de prueba y de 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 módulo no restringe por sí mismo las monedas ni los países. Usa las monedas habilitadas en tu cuenta de Nets; Nets informa de una moneda no compatible cuando se crea el pago. Los métodos de pago que ve el cliente dependen de tu contrato con Nets, de tu país y de tu moneda.

HTTPS para los webhooks: Nets solo llama a direcciones HTTPS públicas de como máximo 256 caracteres y sin "&", así que tu tienda necesita HTTPS y URLs amigables para recibir webhooks. En otras tiendas el pago se sigue confirmando cuando el cliente vuelve a la tienda o con la comprobación de estado en la página del pedido.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.

Instalación

1. En el back office ve a Modules > Module Manager y haz clic en Upload a module. Elige el archivo ZIP del módulo.

2. Cuando termine la carga, haz clic en Configure, o busca VibeFox Nets Nexi Gateway más adelante en la lista de módulos y haz clic en Configure.

3. Introduce tu clave de licencia de VibeFox en License key, en el bloque de licencia de la parte superior de la página Configure, y haz clic en Activate (véase Clave de licencia).

4. Copia la clave secreta de prueba del portal de pruebas de Nets Easy y pégala en Test Secret Key (véase Configuración).

5. Activa Enable/Disable, deja Test Mode activado, haz clic en Save y realiza un pedido de prueba. Después introduce la clave secreta de producción y desactiva Test Mode.

Al instalarse, el módulo crea el estado de pedido Nets payment on hold. PrestaShop vincula un módulo de pago nuevo solo a los países que estaban activos en el momento de la instalación. Revisa las monedas, los países y los grupos de clientes del módulo en Payment > Preferences.

Configuración

Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Nets Nexi Gateway > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Encima de los campos, la página te avisa si falta la clave secreta del modo seleccionado, por ejemplo Nets Nexi: enter the Test Secret Key — the payment method is hidden at checkout until the key of the selected mode is set., 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.

Nets Nexi (países nórdicos)

El título de la sección muestra TEST o LIVE según el modo seleccionado.

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 se muestra a los clientes durante el checkout. También es el nombre del método de pago guardado en el pedido. Por defecto: Nets Easy. Obligatorio: un título vacío da el error Enter a title for the payment method. y no se guarda nada.

Description: la descripción del método de pago que se muestra a los clientes durante el checkout. Por defecto: Pay securely with Nets Easy.

Claves de API

Copia las claves secretas del portal de Nets Easy en Company > Integration: el portal de pruebas (test.portal.dibspayment.eu) para la clave de prueba y el portal de producción (portal.dibspayment.eu) para la clave de producción. Las claves de checkout no son necesarias.

Test Mode: el modo de prueba usa test.api.dibspayment.eu con la clave secreta de prueba; el modo de producción usa api.dibspayment.eu con la clave secreta de producción. Los reembolsos y las capturas de un pedido siempre usan el entorno en el que se pagó. Por defecto: activado. Mientras está activado, los clientes ven Test mode: no real money will be charged. debajo del método de pago.

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 de producción de Nets.

Las claves guardadas nunca se vuelven a mostrar. El campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo.

Clear saved secrets: marca una clave y haz clic en Save para eliminarla. Un campo vacío mantiene el valor guardado.

Pago

Webhooks: las notificaciones de Nets (webhooks) se registran automáticamente con cada pago. No hay nada que configurar en el portal de Nets. La sección muestra la dirección a la que se envían. Con URLs amigables tiene este aspecto: https://your-shop/module/wcp_nets_nexi_gateway/webhook, posiblemente con un código de idioma como /en/. Si la dirección no es una dirección HTTPS pública, la sección te avisa de que la tienda no recibe webhooks; en ese caso los pagos se confirman cuando el cliente vuelve a la tienda o con Nets: check payment status and capture en la página del pedido. Se registran estos eventos:

Cada webhook debe llevar el secreto aleatorio que el módulo creó para ese pago. Los webhooks sin el secreto correcto se rechazan. El webhook solo indica al módulo qué pago ha cambiado: el pago siempre se lee de la API de Nets con la clave secreta del entorno en el que se realizó. El webhook funciona mientras la tienda está en modo de mantenimiento y no lo bloquea la restricción de países de tu tienda.

Order Status After Payment: el estado del pedido una vez que Nets ha confirmado y cobrado el pago.

Avanzado

Debug log: registra las llamadas a la API y los cambios de estado de los pagos en logs/nng_debug.log.php, dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores siempre se registran. Las claves y los datos de los clientes no se registran. Por defecto: desactivado.

Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.

Delete Data on Uninstall: elimina la configuración y los registros del módulo al desinstalarlo. Los datos de pago guardados en los pedidos siempre se conservan. Por defecto: desactivado.

Checkout

En el paso de pago, el cliente elige el método de pago (por defecto Nets Easy) y confirma. El módulo crea un pago de Nets por el total del carrito en la moneda del carrito, con los productos, el envío, el envoltorio de regalo y los descuentos como líneas del pedido, y envía al cliente a la página de pago alojada de Nets. La referencia del pago en Nets es el número del carrito. El correo electrónico, el nombre, la dirección y el teléfono del cliente se envían a Nets cuando Nets acepta su formato. El enlace a la página de términos y condiciones de tu checkout aparece en la página de Nets (si no hay ninguna configurada, aparece la página de inicio de la tienda). En este punto todavía no existe ningún pedido.

Después de pagar, el cliente vuelve a tu tienda. El pedido se marca como pagado solo después de que Nets lo confirme: el módulo lee el pago de la API de Nets, compara el importe reservado y la moneda con el carrito, cobra la reserva y solo entonces crea el pedido. Esto ocurre en el webhook o cuando el cliente regresa, lo que ocurra primero. Después, el cliente ve la página estándar de confirmación del pedido. Si el pago todavía no se ha podido confirmar (no se pudo contactar con Nets, o otra solicitud lo estaba confirmando en ese momento), una página de Payment confirmation muestra Your Nets payment is being confirmed. Your order will be created as soon as it is confirmed — please do not pay again. con los botones Check again y Back to checkout.

Si el cliente cancela en la página de Nets, vuelve al checkout con The Nets payment was cancelled. You can try again or choose another payment method. Si no se ha pagado nada, el mensaje es The payment was not completed. You can try again or choose another payment method. El carrito se conserva. En un nuevo intento, el módulo comprueba primero el pago anterior; si ya está pagado, se crea el pedido en lugar de un nuevo pago. En caso contrario, la sesión anterior de Nets se cierra antes de iniciar una nueva.

Si Nets no puede iniciar el pago, el cliente permanece en el checkout con 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., This payment method is temporarily unavailable. Please choose another payment method. o The payment service could not be reached. Please try again in a moment. Un total del carrito de cero muestra The order total must be greater than zero to pay with Nets. Los detalles se escriben en el registro.

El módulo 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

No order yet: el cliente fue enviado a Nets y no ha pagado, o el pago todavía no está confirmado. Solo existe el carrito.

Payment accepted or Delivered: Nets confirmó y cobró el pago. El estado sigue a Order Status After Payment. El pago se registra con el ID de pago de Nets como ID de transacción, y una nota muestra el ID de pago, el ID de cobro y el método de pago.

Nets payment on hold: el importe o la moneda en Nets no coinciden con el carrito (no se captura), el cobro fue rechazado, o el cliente pagó después de que el pedido se cancelara (reservado, no capturado). La nota lo explica. No se captura nada automáticamente. Tras revisar el pedido, captura con Nets: check payment status and capture, o cancela la reserva en el portal de Nets.

Canceled: se canceló la reserva de un pedido en espera, por ejemplo en el portal de Nets.

Refunded: el pago se reembolsó por completo a través del módulo.

Los webhooks repetidos y las recargas nunca cobran dos veces ni añaden notas duplicadas, y un pedido pagado nunca vuelve a cambiar por eventos de Nets. Si un enlace de pago antiguo se completa para un pedido que ya está pagado, la segunda reserva se libera automáticamente; si ya se cobró, una nota te pide reembolsarla en el portal de Nets.

Bloque de pago Nets Easy

La página del pedido muestra un bloque Nets Easy payment con el ID de pago, el ID de cobro, el entorno (con una insignia Test environment para los pagos de prueba), el estado, los importes reservados y cobrados en Nets, el total del pedido y el importe reembolsado, el historial de reembolsos y las Nets notes del pedido. Los botones del bloque funcionan para todo empleado que pueda editar pedidos; no hace falta acceso a las páginas de Modules.

Nets: check payment status and capture: visible en los pedidos que todavía no están pagados. Lee el pago de Nets y captura una reserva que coincida con el pedido, también después de una captura fallida o después de que hayas revisado un pedido en espera. Si nada cambia, una nota explica por qué, por ejemplo que el cliente aún no ha completado el pago.

Reembolsos

En el bloque Nets Easy payment introduce el importe (se rellena el importe que aún no se ha reembolsado), opcionalmente un motivo, y haz clic en Refund via Nets. Confirma la pregunta Refund this amount through Nets? This cannot be undone. Los reembolsos totales y parciales están disponibles una vez cobrado el pago; un pago que solo está reservado se puede cancelar 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, el bloque muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade al historial de reembolsos y a las notas con el ID de reembolso de Nets. Un reembolso total pone el pedido en Refunded; un reembolso parcial no cambia el estado.

El módulo no crea notas de crédito. Los botones de reembolso estándar de PrestaShop en la página del pedido no devuelven dinero a través de Nets. Los reembolsos hechos en el portal de Nets no se sincronizan; actualiza el pedido manualmente si es necesario.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Nets Nexi Gateway es el primer bloque de Modules > Module Manager > VibeFox Nets Nexi Gateway > Configure, encima de los ajustes. Introduce la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo aparecen la línea Product: presta-payment-nets-nexi y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure del módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (se incluyen el inglés y el ruso).

Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on seguido de una fecha. Después de cambiar la dirección de la tienda, o después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si el servidor de licencias no está disponible, el módulo sigue funcionando con el último estado conocido.

Una clave funciona en un solo dominio: el dominio de la tienda principal, también en una configuración multitienda. Quitar la clave de la tienda no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, Nets no se muestra a los clientes en el checkout. Si se inicia un pago de todos modos, el cliente ve This payment method is not available. Please choose another one. El front office de PrestaShop no sabe que has iniciado sesión en el back office, así que el método de pago también se oculta para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en el checkout. Aparece un aviso en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados: los pagos ya iniciados siguen confirmándose y los reembolsos funcionan.

Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días tras introducir la clave, y después una vez por semana. No hace falta ningún cron job. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.

Solución de problemas

Nets Nexi no aparece en el checkout: 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 de producción. La página de ajustes muestra un aviso cuando falta la clave. En Payment > Preferences comprueba que el módulo está permitido para la moneda del carrito, el país del cliente y el grupo del cliente.

El pago se realizó, pero no se creó ningún pedido: el webhook no llegó a tu tienda. Comprueba que la tienda usa HTTPS y URLs amigables, de modo que la dirección de Webhooks sea una dirección HTTPS pública sin "&", y que la clave secreta del entorno del pago esté configurada. El pedido también se crea cuando el cliente vuelve a la tienda después de pagar.

El webhook responde Unauthorized: el webhook no llevaba el secreto de ese pago. Los webhooks solo se aceptan con el secreto registrado con el pago.

El webhook responde Busy, retry later, Payment lookup failed o Payment not reserved yet: otra solicitud estaba confirmando el mismo carrito, no se pudo contactar con la API de Nets, o la reserva todavía no era visible. Nets reintenta el webhook automáticamente.

El webhook responde Order could not be created, retry later: no se pudo crear el pedido, por ejemplo porque el módulo está desactivado. Activa Debug log para ver el motivo.

La URL del webhook muestra Method not allowed en el navegador: es normal. La dirección solo acepta solicitudes de Nets.

El cliente ve un error al elegir Nets: activa Debug log y revisa el campo Log de la página del módulo. This payment method is temporarily unavailable. Please choose another payment method. normalmente indica una clave secreta incorrecta o que falta. Nets informa de una moneda rechazada en el registro.

El pedido está en Nets payment on hold tras el pago: lee las Nets notes del bloque. Si el cobro fue rechazado, reintenta con 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 no aparece o falla: los reembolsos solo son posibles después de cobrar el pago; el bloque entonces muestra un ID de cobro. Un reembolso usa la clave secreta del entorno en el que se pagó el pedido, así que esa clave debe estar configurada; si no, el bloque indica qué clave de entorno falta.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox Nets Nexi Gateway y elige Uninstall. La clave de licencia y el estado de la licencia de este módulo se eliminan siempre. Si Delete Data on Uninstall está activado, se eliminan la configuración del módulo y el registro. Si está desactivado, todos los ajustes se conservan para una reinstalación posterior. Los datos de pago de Nets de los pedidos (pagos, cobros y reembolsos) y el estado de pedido Nets payment on hold siempre se conservan, de modo que los pedidos pagados antes se pueden reembolsar tras una reinstalación. 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 módulo no está afiliado ni respaldado por Nets ni por Nexi.