VibeFox CorvusPay for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Moneda: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK o USD. En cualquier otra moneda, el método de pago se oculta en la finalización de compra. Los importes se envían con 2 decimales; un total con más decimales (por ejemplo, en una tienda con BHD de 3 decimales) se rechaza en lugar de redondearse.
Cuenta de CorvusPay: necesitas una cuenta de comerciante de CorvusPay. CorvusPay emite un Store ID y una Secret Key para cada tienda, por separado para la tienda de prueba y la de producción; se muestran en el CorvusPay Merchant Center. Allí hay que introducir la Success URL y la Cancel URL del plugin (consulta Configuración).
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_corvuspay_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > CorvusPay > 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 Store ID y la Secret Key de tu tienda de prueba de CorvusPay (y de la tienda de producción para los pagos reales). Copia la Success URL y la Cancel URL que se muestran en la página de ajustes en el CorvusPay Merchant Center, para la tienda de prueba y la de producción.
6. Activa Enable/Disable, haz un pedido de prueba y desmarca Test Mode para pasar a producción.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > CorvusPay. Sobre los campos, la página muestra Test mode is on. mientras el modo de prueba está activado, y te avisa cuando la pasarela está activada pero el Store ID o la Secret Key del modo actual están vacíos (en ese caso se oculta en la finalización de compra hasta que se rellenen) y cuando CorvusPay no admite la moneda de la tienda.
General
Enable/Disable: Enable CorvusPay 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: Credit/Debit Card (CorvusPay).
Description: el texto que se muestra bajo el método de pago en la finalización de compra. Por defecto: Pay securely with your credit or debit card via CorvusPay. En modo de prueba se le añade (Test mode — no real payment is taken.).
Credenciales de la tienda
El Store ID y la Secret Key los emite CorvusPay para cada tienda (la de prueba y la de producción por separado) y se muestran en el CorvusPay Merchant Center.
Test Mode: Enable test mode usa el entorno de pruebas de CorvusPay (wallet.test.corvuspay.com) y el Store ID y la Secret Key de prueba. Por defecto: activado.
Test Store ID: el Store ID numérico de tu tienda de prueba de CorvusPay.
Test Secret Key: la Secret Key de tu tienda de prueba de CorvusPay, que se usa para las firmas HMAC-SHA256.
Live Store ID: el Store ID numérico de tu tienda de producción de CorvusPay.
Live Secret Key: la Secret Key de tu tienda de producción de CorvusPay, que se usa para las firmas HMAC-SHA256.
Un Store ID solo puede contener dígitos. Si introduces cualquier otra cosa, se muestra un error y se conserva el valor anterior. Un pago siempre se verifica con la Secret Key de la tienda en la que se hizo, así que mantén rellenada la clave de prueba mientras haya pedidos de prueba abiertos.
Success URL y Cancel URL
Copia las dos direcciones que se muestran en esta sección en el CorvusPay Merchant Center, para la tienda de prueba y la de producción. CorvusPay devuelve al cliente a ellas después del pago.
Pago
Transaction Type: cómo se cobra la tarjeta.
Payment Page Language: el idioma de la página de pago de CorvusPay. Site language (por defecto) usa el idioma actual de tu sitio cuando CorvusPay lo admite y, si no, inglés. También puedes elegir croata, inglés, alemán, italiano, serbio o esloveno.
Order Status After Payment: el estado del pedido después de un pago Sale correcto. El estado se establece de inmediato, sin un segundo cambio de estado.
Avanzado
Logging: Enable debug logging escribe en WooCommerce > Status > Logs, fuente wcp_corvuspay_gateway. Los errores siempre se registran; los secretos y los datos de clientes, nunca. Por defecto: desactivado.
Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled). La desactivación nunca borra nada. Los datos de pago guardados en los pedidos se conservan siempre. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto Credit/Debit Card (CorvusPay)) y realiza el pedido. El pedido queda en Pendiente de pago, y la página Pay for order muestra Redirecting to CorvusPay for payment. Please wait... y envía el formulario firmado a la página de pago de CorvusPay. Si la redirección no se inicia, el cliente hace clic en Pay via CorvusPay. Se envían el total del pedido, la moneda, una breve descripción del carrito y los datos de facturación (para rellenar previamente la página de pago). El mismo número de pedido de CorvusPay se reutiliza mientras el importe no cambie, y CorvusPay no acepta un segundo pago para él.
Tras pagar, CorvusPay devuelve al cliente a la Success URL. El pedido se marca como pagado solo cuando CorvusPay lo confirma: el número de pedido de CorvusPay debe haberse emitido para este pedido, la firma debe coincidir con la Secret Key de la tienda en la que se hizo el pago, y el importe y la moneda deben coincidir con el pedido. Después el cliente llega a la página de pedido recibido. El stock se reduce cuando se confirma el pago, y el carrito se vacía en la página de pedido recibido.
Si el cliente cancela en la página de CorvusPay, el pedido sin pagar se cancela y el cliente vuelve a la finalización de compra con el carrito intacto y The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. Si el pago se inició desde la página Pay for order y el carrito está vacío, WooCommerce muestra The CorvusPay payment was cancelled and the order was not paid. en la página del carrito. Si la solicitud a la Success URL no se puede verificar, el cliente ve We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again. y el pedido no se modifica.
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 (HPOS) de WooCommerce. Los textos están traducidos al croata.
El pedido solo se confirma cuando CorvusPay devuelve al cliente a la Success URL; no hay notificaciones de servidor a servidor. Si el cliente cierra el navegador justo después de pagar, el pedido queda en Pendiente de pago. El plugin no ofrece reembolsos, capturas ni anulaciones desde WooCommerce (la API de servidor de CorvusPay exige un certificado de cliente), ni tarjetas guardadas, suscripciones, pagos a plazos, IBAN / PIS ni CorvusWallet.
Pedidos
Estados de los pedidos
Pending payment: el cliente fue enviado a CorvusPay y todavía no ha vuelto. Si el cliente pagó pero no volvió, comprueba el pago en el CorvusPay Merchant Center y completa el pedido manualmente.
Processing, Completed o On Hold: el pago Sale se confirmó. El estado depende de Order Status After Payment. La nota del pedido muestra el número de pedido de CorvusPay, el código de aprobación y el tipo de tarjeta. El ID de transacción del pedido es el ID de transacción de CorvusPay o, si CorvusPay no envía ninguno, el número de pedido de CorvusPay, con el que se puede encontrar el pago en el Merchant Center.
On hold, autorizado: está seleccionado Authorize only. Captura el pago en el CorvusPay Merchant Center y después pasa el pedido a Procesando.
On hold, importe/moneda no coinciden: el importe o la moneda pagados no coinciden con el pedido. No lo envíes antes de verificar el pago en el CorvusPay Merchant Center.
On hold, pago de un pedido cancelado: llegó un pago correcto después de que el pedido se hubiera cancelado, por ejemplo por el tiempo límite de los pedidos sin pagar. Tramita el pedido o reembolsa el pago en el CorvusPay Merchant Center.
Cancelled: el cliente canceló el pago en la página de CorvusPay.
Si llega otro pago correcto distinto para un pedido que ya está pagado o cerrado, el pedido no se modifica. Una nota te pide que revises el CorvusPay Merchant Center y reembolses el pago duplicado si hace falta.
Reembolsos: no se admiten reembolsos, capturas ni anulaciones desde WooCommerce. Hazlos en el CorvusPay Merchant Center 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 > CorvusPay. 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, CorvusPay 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 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 aviso en la página de Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los clientes que vuelven 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
CorvusPay no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado, que el Store ID y la Secret Key del modo actual estén rellenados (Test Store ID y Test Secret Key en modo de prueba, Live Store ID y Live Secret Key en modo de producción) y que CorvusPay admita la moneda de la tienda. La página de ajustes muestra un aviso en cada caso.
El pago se realizó, pero el pedido sigue en Pendiente de pago: probablemente la Success URL no está introducida en el CorvusPay Merchant Center, o la Secret Key de WooCommerce no coincide con la tienda. Activa Logging y busca INVALID signature en WooCommerce > Status > Logs, fuente wcp_corvuspay_gateway. El pedido también sigue pendiente si el cliente cerró el navegador antes de volver; en ese caso, comprueba el pago en el Merchant Center y completa el pedido manualmente.
El cliente ve We could not confirm this CorvusPay payment: la solicitud a la Success URL fue rechazada: faltaban campos obligatorios, el número de pedido de CorvusPay no se emitió para el pedido, la Secret Key de esa tienda está vacía o la firma no coincidía. El pedido no se modifica. El registro muestra el motivo.
El cliente ve This order total cannot be paid via CorvusPay: el total es cero o tiene más de 2 decimales.
El cliente ve CorvusPay is not configured o CorvusPay does not accept payments in …: falta el Store ID o la Secret Key del modo actual, o la moneda del pedido no está admitida.
El pedido está On hold: lee la nota del pedido. Está seleccionado Authorize only, el importe o la moneda pagados no coincidían con el pedido, o el pago llegó después de que el pedido se cancelara.
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. Para eliminarlo, desactívalo y bórralo en la página de Plugins. La clave de licencia y el estado de la licencia de este plugin siempre se eliminan. Los ajustes de la pasarela y los archivos de registro solo se eliminan si Delete Data estaba activado. De lo contrario, se conservan para una reinstalación posterior. Los datos de pago guardados en los pedidos se conservan siempre. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
CorvusPay es una marca comercial de su respectivo propietario. Este plugin no está afiliado a CorvusPay ni cuenta con su respaldo.