VibeFox Netopia for WooCommerce — Ayuda

Requisitos

WordPress: 6.0 o posterior.

WooCommerce: 7.0 o posterior, instalado y activo.

PHP: 8.0 o posterior con las extensiones OpenSSL y DOM.

Moneda: la moneda de la tienda o del pedido debe ser RON, EUR, USD o GBP. EUR, USD y GBP deben estar habilitadas en tu cuenta de Netopia. Para otras monedas, el método de pago no aparece en la finalización de compra.

Cuenta de Netopia: necesitas una cuenta de vendedor de Netopia Payments con un punto de venta. De su configuración técnica necesitas la firma de la cuenta y, para cada entorno que uses (sandbox y en vivo), el certificado público (.cer) y la clave privada (.key). No hay que configurar nada en Netopia: la dirección de la IPN se envía con cada solicitud de pago.

Sitio público: la URL de la IPN (confirmación) debe ser accesible desde internet, sin estar detrás de un inicio de sesión, de autenticación básica o de una página de mantenimiento. Los pedidos solo se actualizan mediante la IPN de Netopia.

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_netopia_gateway a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Payments > Netopia Payments > 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. En el panel de administración de Netopia, abre tu punto de venta, copia la firma de la cuenta y descarga el certificado y la clave privada del entorno sandbox y del entorno en vivo. Pega la firma y el contenido completo de los archivos en la configuración (consulta Configuración).

6. Activa Enable/Disable. Prueba un pago en modo sandbox y, después, desmarca Test mode para aceptar pagos reales.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Netopia Payments. Encima de los campos, la página te avisa cuando falta la firma de la cuenta, el certificado o la clave privada del entorno activo (en ese caso, el método de pago no aparece en la finalización de compra), y muestra Test mode is on: payments go to the Netopia sandbox and no real money is charged. mientras el modo de prueba está activado. En la lista de métodos de pago, Netopia aparece como pendiente de configuración hasta que el entorno activo esté completo. Al guardar, un certificado o una clave privada no válidos se rechazan con un error y se mantiene el valor anterior.

IPN (confirm) URL

Se muestra en modo de solo lectura en la parte superior de la configuración. Tiene este aspecto: https://your-site/wc-api/netopia_payment_callback/. Se envía con cada solicitud de pago como URL de confirmación, así que no necesitas introducirla en el panel de Netopia. Netopia envía la IPN a esta URL; el plugin la descifra con la clave privada del entorno activo y comprueba la firma de tu cuenta y la solicitud de pago. Netopia informa de estas acciones:

Una notificación con un código de error de Netopia (por ejemplo, una tarjeta rechazada) marca como fallido un pedido sin pagar. Las notificaciones que no se pueden descifrar, que llevan otra firma de cuenta o que no responden a una solicitud de pago de ese pedido se rechazan y no cambian nada.

Finalización de compra

Enable/Disable: Enable Netopia Payments activa o desactiva el método de pago. Por defecto: desactivado.

Title: el título del método de pago que se muestra en la finalización de compra. Por defecto: Card Payment (Netopia).

Description: la descripción del método de pago que se muestra en la finalización de compra. Por defecto: Pay securely with your credit or debit card via Netopia.

Cuenta de Netopia

En el panel de Netopia ve a Seller accounts > your point of sale > Technical settings: copia la firma de la cuenta y descarga el certificado público (.cer) y la clave privada (.key) de cada entorno. Abre los archivos en un editor de texto y pega su contenido completo, incluidas las líneas BEGIN/END.

Account signature: la firma de la cuenta de vendedor (formato XXXX-XXXX-XXXX-XXXX-XXXX), la misma para sandbox y en vivo.

Test mode: Use the Netopia sandbox (sandboxsecure.mobilpay.ro) and the sandbox keys. Cambia la página de pago y el par de claves. Por defecto: activado. Desactívalo para aceptar pagos reales con las claves en vivo.

Sandbox public certificate (.cer): el contenido del archivo del certificado público de sandbox. Se usa para cifrar la solicitud de pago.

Sandbox private key (.key): el contenido del archivo de la clave privada de sandbox. Se usa para descifrar la IPN. Nunca se vuelve a mostrar después de guardar; el campo muestra A private key is saved. Déjalo vacío para mantener la clave guardada, o pega una clave nueva para sustituirla.

Live public certificate (.cer): el contenido del archivo del certificado público en vivo.

Live private key (.key): el contenido del archivo de la clave privada en vivo. Nunca se vuelve a mostrar después de guardar; déjalo vacío para mantener la clave guardada.

Pedidos

Order status after payment: el estado de un pedido pagado que requiere envío. Los pedidos con solo artículos virtuales o descargables los completa WooCommerce de todos modos. El estado se establece con un único cambio de estado y un único correo electrónico al cliente.

Avanzado

Debug log: Log requests and IPN processing escribe en WooCommerce > Status > Logs, origen wcp_netopia_gateway. Los datos de la tarjeta, las claves y los datos de los clientes no se registran. Los errores, por ejemplo las IPN rechazadas, siempre se registran, incluso con la opción desactivada. Por defecto: desactivado.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted (orders are kept). Por defecto: desactivado.

Finalización de compra

El cliente elige el método de pago (por defecto Card Payment (Netopia)) y realiza el pedido. La página siguiente muestra Redirecting you to Netopia for secure payment… y envía automáticamente al cliente a la página de pago de Netopia, con los botones Proceed to payment y Cancel order como alternativa. La solicitud de pago se cifra con tu certificado de Netopia y contiene el total del pedido en su moneda, Order # con el número del pedido, y los datos de facturación y envío. En modo sandbox, la solicitud se envía al sandbox de Netopia.

El cliente paga con tarjeta en la página de Netopia y vuelve a la página de pedido recibido de tu tienda. La vuelta en sí no marca el pedido como pagado. El pedido solo se marca como pagado cuando Netopia lo confirma mediante la IPN. Hasta entonces, la página de pedido recibido muestra Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. En un pedido en espera muestra Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. Si el pago se canceló, muestra The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time.

Si la tarjeta es rechazada, el pedido se marca como fallido y el cliente puede volver a pagarlo desde la página del pedido. Si el plugin no está bien configurado, la página de pago muestra Netopia gateway is not configured properly. Please contact the store administrator.

El método de pago funciona en la finalización de compra clásica, en el bloque Checkout y en la página Pay for order. Es compatible con WooCommerce High-Performance Order Storage (HPOS).

El plugin solo acepta pagos con tarjeta mediante el protocolo de tarjeta Netopia v1. No ofrece reembolsos ni capturas desde WooCommerce, ni tarjetas guardadas ni pagos con un clic, ni suscripciones, pagos a plazos, SMS, transferencias bancarias ni criptomonedas, y tampoco Netopia API v2.

Pedidos y reembolsos

Estados del pedido

Pending payment: el cliente fue enviado a Netopia, o Netopia todavía no ha enviado la IPN.

Processing or Completed: Netopia confirmó el pago. El estado sigue a Order status after payment. La nota del pedido muestra el importe, el número de tarjeta enmascarado y la transacción de Netopia; los pagos de sandbox se marcan como [sandbox]. El ID de transacción es el de Netopia.

On hold: el pago es una preautorización a la espera de captura en el panel de Netopia, o está en revisión en Netopia. El pedido se marca como pagado cuando Netopia lo confirma. Un pedido también queda en espera cuando el importe o la moneda de la factura no coinciden con el pedido, cuando solo se ha capturado una parte del pago, o cuando Netopia confirma el pago de un pedido cancelado. La nota del pedido lo explica. Revisa la transacción en el panel de Netopia y completa o reembolsa el pedido manualmente.

Failed: Netopia informó de un error, por ejemplo una tarjeta rechazada. El cliente puede volver a pagar.

Cancelled: Netopia canceló el pago, o el cliente hizo clic en Cancel order antes de ir a Netopia.

Las notificaciones tardías nunca degradan un pedido pagado. Si Netopia confirma otro pago de un pedido que ya está pagado, una nota te pide que reembolses el duplicado en el panel de Netopia.

Reembolsos

Los reembolsos no se hacen desde WooCommerce: el protocolo de tarjeta Netopia v1 no tiene una llamada de reembolso, así que no hay botón Refund via. Reembolsa la transacción en el panel de Netopia. Netopia envía entonces una IPN de crédito, y el plugin registra el reembolso en el pedido automáticamente con el motivo Refund initiated by Netopia. Los reembolsos parciales mantienen el estado del pedido; cuando no queda nada por reembolsar, WooCommerce marca el pedido como Refunded. En los pedidos en EUR, USD y GBP, el importe reembolsado, que Netopia informa en RON, se convierte de nuevo a la moneda del pedido. Un reembolso nunca se registra dos veces ni por más del importe restante. El stock no se repone automáticamente.

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 > Netopia Payments. 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, Netopia 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 hechos en el panel de Netopia se siguen registrando.

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

Netopia no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que el entorno activo está completo (Account signature más el certificado y la clave privada de sandbox en modo de prueba, o los de en vivo en modo real) y que la moneda de la tienda o del pedido es RON, EUR, USD o GBP. La página de configuración muestra un aviso cuando falta algo.

El pago se realizó, pero el pedido sigue en Pending payment: la IPN no llegó a tu tienda o fue rechazada. Comprueba que la URL de IPN (confirmación) de la configuración es accesible desde internet (sin modo de mantenimiento, autenticación básica ni cortafuegos). Activa Debug log y busca las líneas de IPN en WooCommerce > Status > Logs, origen wcp_netopia_gateway. El regreso del cliente por sí solo nunca marca el pedido como pagado.

Log shows failed decrypting data: la clave privada no coincide con el certificado del entorno que usó Netopia. La IPN se descifra con la clave del entorno activo y, para los pagos iniciados antes de cambiar el modo de prueba, con la clave del otro entorno. Netopia la reintenta.

Log shows signature mismatch: la Account signature no coincide con el punto de venta que envió la IPN. Cópiala de nuevo desde el panel de Netopia.

Log shows unknown payment request: la IPN no responde a una solicitud de pago que tu tienda hizo para ese pedido en ese entorno (sandbox o en vivo). No se cambia nada.

Log shows gateway not configured: falta la clave privada o la firma de la cuenta. Netopia reintenta la IPN, y el pago se registra una vez completada la configuración.

Error on save about the certificate or private key: el texto pegado no es un certificado o una clave válidos. Pega el contenido completo del archivo, incluidas las líneas BEGIN/END. Se mantuvo el valor anterior.

Order is On hold after payment: lee la nota del pedido. El pago puede ser una preautorización o estar en revisión, el importe o la moneda eran diferentes, solo se capturó una parte, el pedido se había cancelado o se confirmó un pago de sandbox mientras la tienda estaba en modo real (no se recibió dinero real). Revisa la transacción en el panel de Netopia.

A refund made in Netopia does not appear on the order: la IPN de crédito no llegó a la tienda o fue rechazada. Revisa el registro. Si es necesario, crea un reembolso manual en WooCommerce.

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, incluidas las claves guardadas, y los registros solo se eliminan 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.

Netopia Payments y mobilPay son marcas comerciales de sus respectivos propietarios. Este plugin no está afiliado a Netopia Payments ni cuenta con su respaldo.