VibeFox ePayco for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Moneda de la tienda: peso colombiano (COP) o dólar estadounidense (USD). Con otras monedas el método de pago no se muestra en la finalización de compra.
Cuenta de ePayco: necesitas las cuatro claves de tu cuenta de ePayco: P_CUST_ID_CLIENTE, P_KEY, PUBLIC_KEY y PRIVATE_KEY. Están en el panel de ePayco, en Integrations, API keys. Las mismas claves funcionan en modo de prueba y en modo de producción. Los métodos de pago que puede usar el cliente (tarjetas, PSE, redes de pago en efectivo, monederos) son los que tengas habilitados en tu cuenta de ePayco.
Sitio público: la URL de confirmación de tu tienda debe ser accesible desde internet, sin que la bloqueen el modo de mantenimiento, un cortafuegos o la autenticación básica.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo 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_epayco_payment a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > ePayco > Manage, o haz clic en Settings debajo del nombre del plugin en la página de 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 las cuatro claves de ePayco y elige el tipo de finalización de compra (consulta Configuración).
6. Activa Enable/Disable. Prueba un pago en Test Mode con las tarjetas de prueba de ePayco y luego desmarca Test Mode.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > ePayco. Encima de los campos, la página te avisa cuando no se han introducido las cuatro claves (en ese caso el método de pago no se muestra en la finalización de compra), cuando la moneda de la tienda no es COP ni USD, y muestra Test mode is on: customers pay with ePayco test cards and no real money is charged. mientras el modo de prueba esté activado. En la lista de métodos de pago, ePayco aparece como pendiente de configuración hasta que se introducen las cuatro claves.
General
Enable/Disable: Enable ePayco Payment 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: ePayco.
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely with ePayco.
Claves de la cuenta de ePayco
Encuentra las cuatro claves en el panel de ePayco, en Integrations, API keys. P_CUST_ID_CLIENTE y P_KEY verifican las confirmaciones de pago; PUBLIC_KEY y PRIVATE_KEY crean las sesiones de finalización de compra. Las mismas claves funcionan en modo de prueba y en modo de producción.
Customer ID (P_CUST_ID_CLIENTE): tu ID de cliente de ePayco (numérico).
Secret Key (P_KEY): se usa para verificar la firma de las confirmaciones de pago de ePayco. Mantenla en secreto.
Public Key (PUBLIC_KEY): tu clave pública de API de ePayco.
Private Key (PRIVATE_KEY): tu clave privada de API de ePayco. Mantenla en secreto.
Test Mode: Enable test mode crea las sesiones de finalización de compra como transacciones de prueba. Los clientes pagan con tarjetas de prueba de ePayco y no se cobra dinero real. Las transacciones de prueba nunca pagan pedidos creados en modo de producción. Por defecto: desactivado.
Finalización de compra
Checkout Type: cómo se abre la finalización de compra de ePayco.
URL de confirmación
La URL de confirmación indica a tu tienda el resultado de un pago. Se envía a ePayco automáticamente con cada pago, así que no hay nada que configurar en el panel de ePayco. La sección muestra la URL. Tiene este aspecto: https://your-site/wc-api/epc_p/. Debe ser accesible desde internet, sin que la bloqueen el modo de mantenimiento, un cortafuegos o la autenticación básica.
Cada confirmación debe llevar una firma válida hecha con tu P_CUST_ID_CLIENTE y tu P_KEY. Las confirmaciones sin firma válida se rechazan y no cambian el pedido. Sin la confirmación, el pedido solo se actualiza cuando el cliente vuelve a la tienda después de pagar.
Avanzado
Logging: Enable logging escribe en el registro los errores de la API y las confirmaciones de pago en WooCommerce > Status > Logs, origen wcp_epayco_payment. Las claves y los datos de los clientes no se registran. Por defecto: desactivado.
Delete Data on Uninstall: Remove the gateway settings and logs when the plugin is deleted. Desactivar el plugin nunca borra nada. Los datos de ePayco guardados en los pedidos se conservan. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto ePayco) y realiza el pedido. El plugin crea una sesión de finalización de compra de ePayco por el total del pedido en la moneda del pedido, con los impuestos del pedido, el número de pedido y el nombre, la dirección, el correo electrónico y el teléfono de facturación. El idioma de la finalización de compra es español o inglés, según el idioma del sitio. Después el cliente llega a la página de pago del pedido, que muestra Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. La finalización de compra de ePayco se abre como ventana emergente o como redirección, según Checkout Type. La página también tiene el botón Pay with ePayco y el enlace Choose another payment method. En modo de prueba, la página y la finalización de compra muestran TEST MODE — use ePayco test cards, no real money is charged.
En la finalización de compra de ePayco, el cliente paga con uno de los métodos habilitados en tu cuenta de ePayco. Después, ePayco envía la confirmación a tu tienda y devuelve al cliente. El pedido solo se marca como pagado cuando ePayco lo confirma: mediante la confirmación firmada o mediante una solicitud desde el servidor a ePayco cuando el cliente regresa. El regreso del cliente por sí solo nunca paga un pedido.
Si el pago todavía no está confirmado, la página de pedido recibido muestra We are waiting for ePayco to confirm your payment. This page does not need to stay open. Para un pago pendiente (por ejemplo PSE o efectivo) muestra Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved.
Si el pago fue rechazado, el cliente vuelve a la página Pay for order con el mensaje Your ePayco payment was declined or could not be completed. You can try again or choose another payment method. Si el cliente vuelve sin haber pagado, el mensaje es The ePayco payment was not completed. If you already paid, the order will be updated as soon as ePayco confirms it; otherwise you can try again.
Si ePayco no puede iniciar el pago, el cliente ve un mensaje breve, por ejemplo We could not connect to ePayco. Please try again in a moment or choose another payment method. El motivo se añade a las notas del pedido y al registro.
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 el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS). Los textos que ve el cliente están traducidos al español.
El plugin solo admite pagos únicos. No hay reembolsos desde WooCommerce, ni tarjetas guardadas, suscripciones o pagos divididos, y no consulta a ePayco las transacciones pendientes: los pedidos se actualizan con la confirmación de ePayco y con el regreso del cliente.
Pedidos
Estados del pedido
Pending payment: el cliente fue enviado a ePayco y aún no ha pagado, o ePayco todavía no ha confirmado el pago.
Processing: el pago fue aceptado (los pedidos con solo productos virtuales descargables pasan a Completado, el valor predeterminado de WooCommerce). La nota del pedido muestra la referencia de ePayco, el estado, el importe, el método de pago y el código de aprobación. El ID de transacción del pedido es la referencia de ePayco (ref_payco).
On hold, payment pending: ePayco informó de que el pago está pendiente o retenido, por ejemplo una transferencia PSE o un pago en efectivo. El pedido cambia automáticamente cuando ePayco lo confirma o lo rechaza.
On hold, amount/currency mismatch: ePayco aprobó un pago cuyo importe o moneda no coincide con el pedido. No envíes el pedido antes de comprobar la transacción en el panel de ePayco.
On hold, payment for a cancelled order: ePayco aprobó un pago después de que el pedido se hubiera cancelado. Restaura el pedido o reembolsa el pago en ePayco.
Failed: el pago fue rechazado, falló, caducó, fue abandonado, cancelado o detenido por el antifraude. La nota muestra el motivo de ePayco. El cliente puede volver a intentarlo. Un fallo tardío nunca cambia un pedido pagado.
Refunded: ePayco revirtió el pago de este pedido.
Si ePayco informa de otro pago aprobado para un pedido que ya está pagado, el estado no cambia. Una nota te pide que compruebes si hay un cobro duplicado y que lo reembolses en ePayco si hace falta. Una transacción de prueba para un pedido realizado en modo de producción, y una transacción que ya pertenece a otro pedido, se ignoran con una nota.
Reembolsos: los reembolsos desde WooCommerce no son compatibles. Reembolsa el pago en el panel de ePayco y, después, registra el reembolso en WooCommerce con Refund manually.
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 > ePayco. 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 solo dominio. Quitar la clave de un sitio no libera su cupo de dominio. Libéralo en tu cuenta de vibefox.net.
Sin una clave activa, ePayco no se muestra a los clientes en la finalización de compra. Si de todos modos se inicia un pago, 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. Un aviso aparece 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 requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
ePayco no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que se han introducido las cuatro claves y que la moneda de la tienda es COP o USD. En la página Pay for order se comprueba la moneda del pedido. La página de ajustes muestra un aviso cuando falta algo.
El pago se realizó, pero el pedido sigue en Pending payment: la confirmación de ePayco no llega a tu tienda. Comprueba que la URL de confirmación que aparece en los ajustes se abre desde internet y que no la bloquean el modo de mantenimiento, un cortafuegos, un plugin de seguridad o la autenticación básica. Activa Logging y revisa WooCommerce > Status > Logs, origen wcp_epayco_payment. El pedido también se actualiza cuando el cliente vuelve a la tienda después de pagar.
La confirmación responde Invalid signature: Customer ID (P_CUST_ID_CLIENTE) o Secret Key (P_KEY) no coincide con la cuenta de ePayco que recibió el pago. Cópialos de nuevo desde el panel de ePayco.
La confirmación responde Gateway not configured: P_CUST_ID_CLIENTE o P_KEY está vacío. Introdúcelos en los ajustes.
La confirmación responde Busy, retry later: otra solicitud estaba actualizando el pedido en ese mismo momento. ePayco vuelve a intentar la confirmación.
El cliente ve We could not connect to ePayco: ePayco rechazó PUBLIC_KEY y PRIVATE_KEY. La nota del pedido muestra la respuesta de ePayco. Vuelve a copiar ambas claves.
El cliente ve ePayco could not start the payment: ePayco no creó la sesión de finalización de compra. Lee la nota del pedido para ver el error de ePayco.
La finalización de compra de ePayco no se abre: el cliente ve The ePayco checkout could not be loaded. Please reload the page or choose another payment method. No se pudo cargar el script de finalización de compra de ePayco en la página de pago del pedido. El cliente puede recargar la página o usar Choose another payment method.
Un pago de prueba no pagó el pedido: las transacciones de prueba nunca pagan pedidos realizados en modo de producción. Realiza el pedido de prueba con Test Mode activado.
El pedido está On hold: lee la nota del pedido. ePayco informó de que el pago estaba pendiente, el importe o la moneda aprobados no coincidían con el pedido, o el pago llegó después de que el pedido se cancelara. Comprueba la transacción en el panel de ePayco antes de enviar el pedido.
El bloque de licencia muestra un error: sigue el mensaje que aparece en el bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera un cupo 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 conectar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Para desarrolladores, la documentación del plugin enumera los filtros epc_p_supported_currencies (monedas para las que se ofrece el método), epc_p_session_payload (datos enviados a ePayco) y epc_p_icon (icono de la finalización de compra).
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. Los ajustes de la pasarela de pago y los registros solo se eliminan si Delete Data on Uninstall estaba activado. En caso contrario, se conservan para una futura reinstalación. Los datos de ePayco guardados en los pedidos siempre se conservan. Los pedidos existentes mantienen sus notas de pago y sus IDs de transacción.
ePayco es una marca comercial de su respectivo titular. Este plugin no está afiliado a ePayco ni avalado por ePayco.