VibeFox CCAvenue for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 6.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior, con la extensión OpenSSL (se usa para cifrar la solicitud y descifrar la respuesta).
Cuenta de CCAvenue: necesitas una cuenta de comerciante de CCAvenue con un Merchant ID, un Access Code y una Working Key. El Access Code y la Working Key se emiten para un dominio web, así que genéralos para el dominio de esta tienda. CCAvenue usa las mismas credenciales para el entorno de prueba; CCAvenue tiene que habilitar el acceso de prueba en tu cuenta. El plugin usa los endpoints de CCAvenue India.
Moneda: la moneda del pedido se envía a CCAvenue tal cual. Las cuentas de CCAvenue aceptan INR por defecto; otras monedas requieren el procesamiento multidivisa en tu cuenta de CCAvenue.
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_ccavenue_payment a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > CCAvenue > 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 Merchant ID, el Access Code y la Working Key de tu panel de CCAvenue y activa Enable/Disable.
6. Mantén Test mode activado mientras pruebas y, después, desactívalo para aceptar pagos reales.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > CCAvenue. Encima de los campos, la página te avisa cuando CCAvenue está activado pero falta el Merchant ID, el Access Code o la Working Key (en ese caso el método de pago queda oculto en la finalización de compra hasta que se configuren los tres), muestra CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken. mientras el modo de prueba está activado, y recuerda el procesamiento multidivisa cuando la moneda de la tienda no es INR.
General
Enable/Disable: Enable CCAvenue Payment Gateway 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: CCAvenue.
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue.
Credenciales de API
Inicia sesión en tu panel de comerciante de CCAvenue (M.A.R.S.) y abre Settings > API Keys. Genera el Access Code y la Working Key para el dominio de esta tienda. Los espacios de las credenciales se eliminan al guardar.
Merchant ID: tu ID de comerciante numérico de CCAvenue. Si contiene algo que no sean dígitos, al guardar se muestra un error y se mantiene el valor guardado antes.
Access Code: el Access Code de este sitio web.
Working Key: la Working Key (clave de cifrado) de este sitio web. Cifra la solicitud de pago y es la única forma de verificar la respuesta de CCAvenue, así que mantenla en secreto.
Test mode: Send customers to the CCAvenue test environment (test.ccavenue.com). CCAvenue usa el mismo Merchant ID, Access Code y Working Key para pruebas y para producción; CCAvenue tiene que habilitar el acceso de prueba en tu cuenta. En modo de prueba, la finalización de compra muestra TEST MODE: no real transactions will be processed. Por defecto: activado. Desactívalo para los pagos reales.
URL de retorno
CCAvenue devuelve al cliente a la dirección que se muestra en esta sección. Tiene el aspecto de https://your-site/wc-api/ccavenue_p_callback/. El plugin envía esta URL con cada pago, así que no hay nada que configurar en CCAvenue. Debe pertenecer al dominio registrado en CCAvenue.
Avanzado
Debug log: Log CCAvenue events escribe los ID de pedido, las referencias de CCAvenue y los estados en WooCommerce > Status > Logs, origen wcp_ccavenue_payment. Las claves, los datos de tarjeta y las direcciones no se registran. Por defecto: desactivado.
Delete data on uninstall: Remove the plugin settings, logs and CCAvenue order references when the plugin is deleted. Desactivar el plugin nunca borra nada. Por defecto: desactivado.
Finalizar compra
El cliente elige el método de pago (por defecto, CCAvenue) y realiza el pedido. La página Pay for order muestra Thank you for your order. You are being redirected to CCAvenue to complete the payment. y envía al cliente a la página de pago de CCAvenue. Sin JavaScript, el cliente hace clic en Pay via CCAvenue o en Cancel order. Cada intento recibe una nueva referencia de pedido de CCAvenue. El total y la moneda del pedido, los datos de facturación y de entrega y la clave del pedido se envían en la solicitud cifrada. Los nombres y las direcciones se limpian para ajustarse a los caracteres y las longitudes que acepta CCAvenue; el país y el estado o provincia se envían como nombres, y el teléfono, solo como dígitos.
Tras el pago, CCAvenue devuelve al cliente con una respuesta cifrada. El pedido se marca como pagado solo cuando CCAvenue lo confirma: la respuesta debe descifrarse con tu Working Key, pertenecer a este pedido y tener el mismo importe y la misma moneda que el pedido. Después, el cliente llega a la página de pedido recibido.
Si el pago falla, el cliente vuelve a la finalización de compra con Payment was not completed. Please try again or choose a different payment method. Si el cliente cancela en la página de CCAvenue, el mensaje es Payment was cancelled. You may try again. Si no se puede verificar la respuesta, el mensaje es We could not confirm the payment result. If your account was charged, please contact us before paying again. El cliente puede volver a pagar un pedido no pagado, por ejemplo desde la página Pay for order. Si el pago se inició desde la página Pay for order y el carrito está vacío, WooCommerce muestra el mensaje en la página del carrito; un pedido fallido se puede volver a pagar desde My account > Orders.
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 hindi.
El resultado se toma solo del regreso del cliente desde CCAvenue: no hay notificaciones de servidor a servidor ni consultas de estado. Si el cliente cierra el navegador antes de volver, el pedido sigue en Pendiente de pago. El plugin no tiene reembolsos desde WooCommerce, ni tarjetas guardadas, suscripciones o pagos recurrentes, ni iframe ni formulario de tarjeta en el sitio, y no admite CCAvenue UAE ni otras plataformas regionales.
Pedidos
Estados del pedido
Pending payment: el cliente fue enviado a CCAvenue y todavía no ha vuelto. Revisa el pago en el panel de CCAvenue si el cliente no regresa.
Processing: el pago fue confirmado (los pedidos con solo productos virtuales descargables pasan a Completado, el valor por defecto de WooCommerce). La nota del pedido muestra la referencia bancaria, el tracking ID de CCAvenue y el modo de pago. El ID de transacción del pedido es el tracking ID de CCAvenue.
On hold, diferencia de importe o moneda: CCAvenue confirmó un pago cuyo importe o moneda difiere del pedido, por ejemplo porque el pedido se editó después de que el cliente empezara a pagar o porque se aplicó una oferta de descuento de CCAvenue. La nota muestra el importe recibido y el esperado. Revisa el pago en el panel de CCAvenue y, después, completa o reembolsa el pedido.
On hold, pendiente de confirmación del banco: CCAvenue informó del pago como Awaited. El pedido nunca se marca como fallido mientras el dinero todavía pueda cobrarse. Verifícalo en el panel de CCAvenue antes de tramitarlo y cambia el estado manualmente. Una respuesta posterior con el mismo tracking ID se aplica igualmente.
On hold, pago de un pedido cancelado: el cliente pagó después de que el pedido se cancelara. Revisa el stock y tramita el pedido o reembolsa el pago.
Cancelled: el cliente abortó el pago en la página de CCAvenue.
Failed: el pago falló, o CCAvenue devolvió Invalid, Timeout u otro estado no exitoso. La nota muestra el mensaje de CCAvenue. Un fallo tardío nunca cambia un pedido pagado.
Si llega otro pago correcto para un pedido que ya está pagado (por ejemplo, desde dos pestañas del navegador), el pedido no se vuelve a modificar. Una nota te pide que reembolses el duplicado en el panel de CCAvenue.
Reembolsos: los reembolsos desde WooCommerce no se admiten. Reembolsa el pago en el panel de CCAvenue y regístralo manualmente 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 > CCAvenue. 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 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 plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, CCAvenue 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 hayan 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 clientes que vuelvan de pagos ya iniciados se siguen procesando.
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
CCAvenue no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado y que estén configuradas las tres credenciales: Merchant ID, Access Code y Working Key. La página de ajustes muestra un aviso cuando falta alguna.
El pago se realizó, pero el pedido sigue en Pendiente de pago: el cliente no volvió de CCAvenue a tu tienda, por ejemplo porque cerró el navegador. El plugin no tiene notificaciones de servidor a servidor. Revisa el pago en el panel de CCAvenue y actualiza el pedido manualmente.
Todos los pagos terminan con We could not confirm the payment result: la respuesta no se puede descifrar. La Working Key es incorrecta, pertenece a otro dominio o se copió con caracteres adicionales. Genera las claves para el dominio de esta tienda y pégalas de nuevo. Activa el Debug log y mira en WooCommerce > Status > Logs, origen wcp_ccavenue_payment.
CCAvenue muestra un error antes de la página de pago: comprueba que el Access Code y la Working Key se generaron para este dominio, que la URL de retorno pertenece al dominio registrado en CCAvenue y, en modo de prueba, que CCAvenue habilitó el acceso de prueba en tu cuenta. Para una moneda distinta de INR, el procesamiento multidivisa debe estar habilitado en tu cuenta de CCAvenue.
El cliente ve This payment method is temporarily unavailable: falta una de las credenciales.
El cliente ve Payment gateway error: encryption failed: no se pudo cifrar la solicitud. Comprueba que la extensión OpenSSL de PHP esté instalada.
El pedido está en On hold tras el pago: lee la nota del pedido. El importe o la moneda pagados no coincidían con el pedido, el pago está pendiente de confirmación del banco o el pedido se había cancelado. Verifica el pago en el panel de CCAvenue y, después, tramita el pedido o reembolsa el pago.
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 cambió la dirección del sitio, haz clic en Check now para activar la clave para el nuevo dominio. Si no se puede acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Para desarrolladores, el readme lista el filtro ccavenue_p_request_params (cambia los datos que se envían a CCAvenue, por ejemplo merchant_param2 a merchant_param5 o promo_code; no cambies amount, currency, order_id ni merchant_param1) y el filtro ccavenue_p_icon para el 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, los registros y las referencias de CCAvenue guardadas en los pedidos se eliminan solo si Delete data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago e ID de transacción.
CCAvenue es una marca comercial de su respectivo propietario. Este plugin no está afiliado a CCAvenue ni cuenta con su respaldo.