VibeFox Ozow for WooCommerce — Ayuda
Requisitos
WordPress: 6.2 o posterior.
WooCommerce: 8.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Moneda: rand sudafricano (ZAR). El método de pago se oculta con otras monedas. Ozow cobra céntimos enteros, por lo que WooCommerce debe usar 2 decimales.
Cuenta de Ozow: una cuenta de comerciante de Ozow con el Site Code y la Private Key de tu sitio de Ozow, obtenidos en tu panel de comerciante de Ozow. La API Key es opcional, pero recomendable. Ozow usa el mismo Site Code y las mismas claves para pagos de prueba y reales.
Sitio accesible: tu sitio debe ser accesible desde Internet, sin modo de mantenimiento, protección con contraseña ni un cortafuegos que bloquee a Ozow, para que lleguen las notificaciones de Ozow.
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_ozow_pay a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > Ozow > 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. Introduce el Site Code y la Private Key y, preferiblemente, la API Key de tu panel de comerciante de Ozow.
6. Activa Enable/Disable. Haz un pago de prueba con Test mode activado y luego desactiva el modo de prueba para aceptar pagos reales.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Ozow. Encima de los campos, la página te avisa cuando falta el Site Code o la Private Key (Ozow se oculta entonces en la finalización de compra), cuando la moneda de la tienda no es ZAR y cuando WooCommerce usa más de 2 decimales, y muestra Test mode is on: no real payments are accepted. Do not ship orders paid in test mode. mientras el modo de prueba está activado. En la lista de métodos de pago, Ozow aparece como pendiente de configurar hasta que se rellenan el Site Code y la Private Key.
General
Enable/Disable: Enable Ozow payments activa o desactiva el método de pago. Por defecto: desactivado.
Title: el nombre del método de pago que ven los clientes en la finalización de compra. Por defecto: Instant EFT (Ozow).
Description: el texto que se muestra bajo el método de pago en la finalización de compra. Por defecto: Pay instantly and securely from your South African bank account. You will be redirected to Ozow to choose your bank and approve the payment. En modo de prueba se añade debajo la línea TEST MODE: no money will be charged.
Credenciales de Ozow
Copia el Site Code, la Private Key y la API Key de tu panel de comerciante de Ozow (Merchant details / Sites). La sección enlaza con la documentación de integración de Ozow en hub.ozow.com.
Site Code: el Site Code del sitio de Ozow que recibe los pagos. Las respuestas para otro Site Code se rechazan.
Private Key: firma cada solicitud de pago y verifica cada respuesta de Ozow. Mantenla en privado. Sin ella, el método de pago se oculta y no se acepta ninguna respuesta de Ozow.
API Key (recommended): opcional. Con una API Key, cada pago correcto se confirma además con la API GetTransaction de Ozow antes de marcar el pedido como pagado. La API debe informar del pago como completado, para este pedido, con el mismo importe, moneda y Site Code.
Test mode: Enable Ozow test mode. Ozow usa el mismo Site Code y las mismas claves para las pruebas: los pagos se crean con IsTest=true y no se mueve dinero. Los pedidos pagados en modo de prueba reciben una nota en el pedido; no los envíes. Desactiva el modo de prueba para aceptar pagos reales. Un pago de prueba nunca paga un pedido en modo real. Por defecto: activado.
Notificaciones de pago
Las URL de notificación, éxito, cancelación y error se envían a Ozow con cada pago, así que no hay que configurar nada en el panel de Ozow, salvo que tu sitio de Ozow esté configurado con URL fijas. La sección muestra la URL de notificación. Tiene este aspecto: https://your-site/wc-api/ozow_pay/?ozow_notify=1. Si tu sitio de Ozow usa URL fijas, cópiala exactamente como la muestran los ajustes.
Avanzado
Debug log: Log payment requests and Ozow responses escribe los detalles en WooCommerce > Status > Logs, origen wcp_ozow_pay. Los errores y avisos se registran siempre. Las claves, los hashes y los datos de clientes nunca se registran. Por defecto: desactivado.
Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Ozow data saved on orders is kept). Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto Instant EFT (Ozow)) y realiza el pedido. El plugin envía al cliente a la página de pago alojada de Ozow con una solicitud firmada por el total del pedido en ZAR. La referencia del extracto bancario es Order y el número de pedido (hasta 20 letras latinas, dígitos, espacios y guiones). El nombre del cliente se transmite a Ozow. En la página de Ozow, el cliente elige un banco sudafricano y aprueba el pago en la app de su banco.
Después, Ozow notifica a la tienda y devuelve al cliente. Ambos llevan la misma respuesta firmada y ambos se procesan de la misma forma, de modo que el pedido se actualiza aunque uno de ellos se pierda. El pedido solo se marca como pagado después de que Ozow lo confirme: el hash debe verificarse con tu Private Key, el Site Code debe ser el tuyo, la respuesta debe contener la clave de este pedido, y el importe y la moneda deben coincidir con el pedido. Con una API Key, el pago también se comprueba con la API GetTransaction.
Tras un pago correcto, el cliente llega a la página de pedido recibido. Si Ozow aún no ha confirmado el pago, la página dice We are waiting for Ozow to confirm your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Si el pedido está en espera, dice Your Ozow payment was received and is being reviewed by the store. We will contact you if anything is needed.
Si el cliente cancela en la página de Ozow o el pago falla, el pedido pasa a Fallido y el cliente vuelve a la página Pay for order con The Ozow payment was cancelled. You can try again or choose another payment method. o The Ozow payment was not completed. You can try again or choose another payment method. El cliente puede volver a pagar el mismo pedido.
El método de pago funciona en la finalización de compra clásica, en el bloque de Finalizar compra y en la página Pay for order (solo para pedidos en ZAR). Es compatible con el almacenamiento de pedidos de alto rendimiento (HPOS) de WooCommerce.
El plugin solo acepta pagos únicos en ZAR. No permite reembolsos desde WooCommerce, no admite suscripciones, cuentas bancarias guardadas ni tokenización, y no envía enlaces de pago desde la administración.
Pedidos
Estados del pedido
Pending payment: el cliente fue enviado a Ozow y aún no ha pagado, o Ozow todavía no ha confirmado el pago.
Processing: el pago se ha confirmado. Es el estado estándar de WooCommerce después del pago; los pedidos que solo contienen productos virtuales descargables pasan a Completado. La nota del pedido muestra el importe y el ID de transacción de Ozow, e indica si el pago se confirmó con la API GetTransaction. El ID de transacción del pedido es el TransactionId de Ozow. Un pago de prueba recibe la nota TEST MODE — no money was received, do not ship this order.
On hold: la nota del pedido indica el motivo. Ozow o el banco están investigando el pago (el pedido se actualiza cuando Ozow envía el estado final); el importe o la moneda pagados no coinciden con el pedido; llegó un pago para un pedido que ya estaba cancelado; o, con una API Key, la API GetTransaction aún no ha podido confirmar el pago o lo contradice. Comprueba el pago en tu panel de Ozow y cambia el estado del pedido. Si la API no pudo responder, la siguiente notificación de Ozow completa el pedido.
Failed: el cliente canceló el pago, el pago se abandonó u Ozow informó de un error. El cliente puede volver a pagar desde el pedido.
Un pedido ya pagado nunca vuelve a un estado anterior, y un pedido cancelado o reembolsado nunca se vuelve a abrir. Si llega un segundo pago para un pedido ya pagado, una nota te pide que reembolses el duplicado en tu panel de Ozow. Si un pedido está en espera por otro motivo, por ejemplo porque lo pusiste tú, un pago posterior solo añade una nota y tú mismo cambias el pedido a Procesando.
Reembolsos
Los reembolsos desde WooCommerce no son compatibles. Reembolsa el pago en tu panel de comerciante de Ozow y registra el reembolso en WooCommerce manualmente.
Clave de licencia
El plugin funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Payments > Ozow. 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 quitarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.
Una clave funciona en un dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, Ozow no se muestra a los clientes en la finalización de compra. Si aun así se inicia un pago, el cliente ve This payment method is not available. Please choose another one. Los gestores de la tienda con sesión iniciada 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 recordatorio 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.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Ozow no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que el Site Code y la Private Key están rellenados y que la moneda de la tienda o del pedido es ZAR. La página de ajustes muestra un aviso cuando falta algo.
El pago se realizó, pero el pedido sigue en Pendiente de pago: la notificación de Ozow no llegó a la tienda y el cliente no volvió. Comprueba que tu sitio es accesible desde Internet (sin modo de mantenimiento, protección con contraseña ni cortafuegos que bloquee a Ozow). Si tu sitio de Ozow está configurado con URL fijas, comprueba que la URL de notificación es exactamente la que se muestra en los ajustes. Activa Debug log y consulta WooCommerce > Status > Logs, origen wcp_ozow_pay.
La notificación responde Invalid hash: la Private Key de los ajustes no pertenece al sitio de Ozow que envió la respuesta. Cópiala de nuevo desde el panel de comerciante de Ozow.
La notificación responde Unknown site: la respuesta procede de otro sitio de Ozow. Comprueba el Site Code.
La notificación responde Order mismatch u Order not found: la respuesta no pertenece a un pedido de esta tienda. No se cambia nada.
La notificación responde Gateway not configured: falta el Site Code o la Private Key. Rellénalos; Ozow puede volver a intentarlo.
La notificación responde Order busy: en ese mismo momento se estaba procesando otra respuesta de Ozow para el mismo pedido. La respuesta no se aplica; la aplica la siguiente notificación o el regreso del cliente.
La notificación responde Payment not confirmed yet: con una API Key, la API GetTransaction no pudo confirmar el pago. El pedido queda en espera y la siguiente notificación lo completa. Si sigue en espera, comprueba la API Key y el pago en tu panel de Ozow.
El cliente ve Ozow accepts payments in South African rand (ZAR) only: el pedido está en otra moneda. Ozow no se puede usar para él.
Un pago de prueba no pagó el pedido: la pasarela está en modo real. Los pagos de prueba nunca pagan un pedido en modo real; una nota en el pedido lo indica.
El pedido está En espera después del pago: lee la nota del pedido y comprueba el pago en tu panel de Ozow; después cambia el pedido a Procesando o reembolsa el pago en Ozow.
El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera una plaza en tu cuenta de vibefox.net y haz clic en Check now. Si la dirección del sitio cambió, haz clic en Check now para activar la clave para el nuevo dominio. Si no se puede contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Al desactivar el plugin se conservan todos los datos. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de la licencia de este plugin se eliminan siempre. Los ajustes de la pasarela, las demás opciones del plugin y sus registros solo se eliminan si Delete data on uninstall estaba activado. De lo contrario, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago e ID de transacción.
Ozow es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Ozow ni respaldado por Ozow.