VibeFox DPO for WooCommerce — Ayuda
Requisitos
WordPress: 6.2 o posterior.
WooCommerce: 8.0 o posterior, instalado y activo. El plugin se niega a activarse sin él.
PHP: 8.0 o posterior.
Cuenta DPO Pay: necesitas el Company Token y el Service Type ID de tu cuenta de comerciante DPO. DPO los emite cuando se abre tu cuenta; consíguelos con tu gestor de cuenta de DPO o en dpogroup.com. DPO también puede proporcionar una cuenta de prueba con su propio token y service type. No hay un servidor de prueba independiente: DPO usa la misma dirección de API para cuentas de prueba y en vivo, y la cuenta se elige según el token.
Moneda: la moneda de la tienda debe estar admitida por tu cuenta DPO, por ejemplo USD, EUR, ZAR, KES, UGX, TZS, RWF, GHS, NGN, ZMW, XOF o AED. DPO acepta como máximo 2 decimales, por lo que los importes de pedido con 3 decimales (por ejemplo KWD 12.345) no se pueden pagar.
Clave de licencia de VibeFox: comprada 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_dpo_pay a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > DPO Pay > Manage, o haz clic en Settings bajo el nombre del plugin en la página de plugins.
4. Introduce tu clave de licencia de VibeFox en el bloque de licencia en la parte superior de la página y haz clic en Activate.
5. Introduce el Company Token y el Service Type de prueba y/o en vivo (ver Configuración).
6. Envía la URL de notificación push que se muestra en la página de ajustes al soporte de DPO y pídeles que la configuren para tu cuenta.
7. Activa Enable/Disable. Realiza un pedido de prueba en modo de prueba, y luego desmarca Test mode para aceptar pagos reales.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > DPO Pay. Cuando la pasarela está activada pero el Company Token o el Service Type del modo seleccionado está vacío, la página advierte de que el método de pago está oculto en la finalización de compra, y al guardar se muestra el mismo error. Mientras el modo de prueba está activado, la página muestra Test mode is on: payments are created with the test account credentials.
General
Enable/Disable: Enable DPO Pay 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: DPO Pay.
Description: el texto que se muestra bajo el método de pago en la finalización de compra. Por defecto: Pay securely by card or mobile money on the DPO Pay payment page.
Credenciales de API
DPO emite un Company Token y un Service Type ID para tu cuenta de comerciante, y otros separados para una cuenta de prueba. Consíguelos con tu gestor de cuenta de DPO o en dpogroup.com.
Test mode: Use the test account credentials below. Cuando está activado, los pagos nuevos se crean con el Company Token y el Service Type de prueba. Por defecto: activado. Desmárcalo para aceptar pagos reales con las credenciales en vivo. Las comprobaciones de estado de pedidos existentes siempre usan la cuenta con la que se creó el pago.
Test Company Token: el Company Token de tu cuenta de prueba DPO.
Test Service Type: el Service Type ID numérico de tu cuenta de prueba DPO.
Live Company Token: el Company Token de tu cuenta de comerciante DPO en vivo.
Live Service Type: el Service Type ID numérico de tu cuenta de comerciante DPO en vivo.
Un Service Type debe ser un número. Cualquier otro valor no se guarda: la página muestra un error y conserva el valor anterior. Si actualizas desde la versión 1.0, las credenciales de esa versión también se copian en los campos de prueba.
Notificaciones de pago
La notificación push avisa a tu tienda de inmediato de que se ha realizado un pago, incluso si el cliente cierra el navegador después de pagar. Esta sección muestra la URL de notificación push. Tiene un formato similar a https://your-site/wc-api/dpo_pay_notify/. No se configura en un panel: pide al soporte de DPO que configure esta URL para tu cuenta.
Las notificaciones push de DPO no llevan firma, por lo que su contenido nunca es de confianza. El plugin solo las usa para localizar el pedido y luego comprueba el pago directamente con DPO. Sin la URL push, los pedidos se siguen confirmando cuando el cliente vuelve a la tienda y mediante las comprobaciones automáticas 15 minutos después de la redirección y después del límite de tiempo de pago.
Pedidos
Successful payment status: el estado del pedido tras un pago correcto verificado. El estado se establece de inmediato, sin un segundo cambio de estado.
Avanzado
Logging: Enable logging escribe las llamadas a la API y las notificaciones en WooCommerce > Status > Logs, fuente wcp_dpo_pay. Los errores siempre se registran. Los tokens se enmascaran, no se registran datos de clientes. Por defecto: desactivado.
Delete data: Delete all plugin data when the plugin is deleted. Elimina los ajustes, los datos de DPO guardados en los pedidos y los registros al desinstalar. La desactivación nunca elimina datos. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto DPO Pay) y realiza el pedido. El plugin crea una transacción DPO por el importe total del pedido en la moneda del pedido, con el número de pedido y el nombre de tu sitio como descripción, y envía al cliente a la página de pago de DPO. El nombre, correo electrónico, teléfono y dirección del cliente se envían para precargar la página. Allí el cliente paga con cualquier método habilitado en tu cuenta DPO. El enlace de pago es válido durante 5 horas.
Después de pagar, el cliente vuelve a tu tienda. El pedido se marca como pagado solo después de que DPO lo confirme: el plugin pregunta a DPO por el resultado de la transacción cuando el cliente vuelve, cuando llega una notificación push y en las comprobaciones automáticas. Cuando el pago se confirma, el cliente va a la página de pedido recibido.
Si el pago no se confirma, el cliente vuelve a la finalización de compra o a la página Pay for order con uno de estos mensajes:
Si el cliente hace clic en el botón de la página de DPO para volver a la tienda, el pedido se cancela de la forma estándar de WooCommerce y su enlace de pago DPO se cancela en DPO.
Cuando un cliente paga de nuevo por el mismo pedido, el enlace de pago DPO anterior se comprueba primero. Si se pagó, el pedido se completa sin un segundo cargo. Si todavía se está procesando, el cliente ve Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. En caso contrario, el enlace antiguo se cancela en DPO y se crea uno nuevo.
Si DPO no puede iniciar el pago, el cliente ve un mensaje breve elegido según el código de error de DPO, por ejemplo que DPO Pay no admite la moneda de este pedido, o que el importe excede el límite permitido por DPO Pay, y puede elegir otro método de pago.
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. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin solo acepta pagos únicos en la página de DPO. No tiene reembolsos desde WooCommerce, ni tarjetas guardadas, suscripciones o pagos recurrentes, campos de tarjeta en tu sitio ni captura de pagos solo autorizados.
Pedidos
Estados del pedido
Pending payment: el cliente fue enviado a DPO y aún no ha pagado, o DPO aún no ha confirmado el pago.
Processing, Completed o On hold: el pago fue verificado. El estado sigue a Successful payment status. La nota del pedido muestra el importe, la moneda, el código de aprobación y el inicio del token de transacción DPO. El ID de transacción es el token de transacción DPO.
On hold after payment: DPO confirmó un pago, pero el importe o la moneda difieren del pedido, el pago solo está autorizado y no capturado, la transacción se sobrepagó o se pagó de menos, o el pedido ya había sido cancelado. La nota del pedido explica el motivo. Comprueba la transacción en el portal de DPO. Captura o anula un pago solo autorizado en el portal de DPO y luego actualiza el pedido.
Failed: el pago fue rechazado, cancelado o se superó el límite de tiempo de pago. El cliente puede pagar de nuevo.
Cancelled: el cliente volvió a la tienda desde la página de DPO, o el pedido fue cancelado por ti o por el tiempo límite de WooCommerce para pedidos sin pagar. El enlace de pago DPO sin pagar se cancela en DPO.
Un mensaje posterior de rechazo nunca cambia un pedido ya pagado, y los resultados de enlaces de pago anteriores nunca hacen fallar el intento actual. Si DPO confirma un segundo pago correcto para un pedido que ya está pagado, el pedido recibe una nota sobre un posible pago duplicado, para que puedas reembolsarlo en el portal de DPO.
Reembolsos
Los reembolsos desde WooCommerce no están disponibles en esta versión. Reembolsa el pago en el portal de comerciante de DPO y luego marca el pedido como reembolsado en WooCommerce.
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 > DPO Pay. 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 comprobar el estado de nuevo, 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, DPO Pay no se muestra a los clientes en la finalización de compra. Si de todas formas se inicia un pago, el cliente ve This payment method is not available. Please choose another one. Los gestores de tienda con sesión iniciada siguen viendo el método de pago, marcado (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 de 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 necesitan una renovación. El estado se comprueba de nuevo automáticamente en segundo plano.
Solución de problemas
DPO Pay no aparece en la finalización de compra: comprueba que la licencia está activa, Enable/Disable está activado y el Company Token y el Service Type del modo seleccionado están configurados: los campos de prueba en modo de prueba, los campos en vivo en caso contrario. La página de ajustes muestra una advertencia cuando faltan.
El pago se realizó, pero el pedido se queda en Pending payment: probablemente la URL de notificación push no está configurada para tu cuenta DPO, y el cliente no volvió a la tienda. Pide al soporte de DPO que configure la URL mostrada en los ajustes. El pedido también se confirma mediante la comprobación automática 15 minutos después de la redirección. Activa Logging y revisa WooCommerce > Status > Logs, fuente wcp_dpo_pay.
La notificación push responde Unknown transaction: el token de transacción no pertenece a un pedido de DPO Pay de esta tienda, por ejemplo la notificación llegó de otra tienda con la misma cuenta DPO.
La notificación push responde Verification failed: no se pudo contactar con DPO para comprobar el pago. DPO repite la notificación, y la comprobación automática también confirma el pedido.
El Service Type no se guarda: debe ser el Service Type ID numérico de DPO.
El cliente ve DPO Pay is temporarily unavailable: DPO se negó a crear la transacción, por ejemplo por un Company Token o Service Type incorrecto, o un token del otro modo. El código de resultado de DPO está en WooCommerce > Status > Logs, fuente wcp_dpo_pay.
El cliente ve que DPO acepta como máximo 2 decimales: el importe del pedido tiene 3 decimales. DPO no puede cobrar tales importes.
El pedido queda en On hold después del pago: lee la nota del pedido. El importe o la moneda pagados diferían del pedido, el pago solo está autorizado, la transacción se sobrepagó o se pagó de menos, o el pedido había sido cancelado. Revisa la transacción en el portal de DPO.
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
Desactivar el plugin conserva todos los datos y solo detiene las comprobaciones de estado programadas. 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. Los ajustes, los datos de DPO guardados en los pedidos, las comprobaciones programadas y los registros se eliminan solo si Delete data estaba activado. En caso contrario, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago y los ID de transacción.
DPO Pay es una marca comercial de su respectivo propietario. Este plugin no está afiliado a DPO Pay ni cuenta con su respaldo.