VibeFox Razorpay 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.
Cuenta de Razorpay: necesitas el Key ID y el Key Secret de tu cuenta de Razorpay para el modo de prueba, y para el modo real una vez activada tu cuenta. Se recomienda encarecidamente un webhook con un secreto de tu elección (consulta Configuración). Los pagos en monedas distintas de INR requieren tener activado International Payments en tu cuenta de Razorpay.
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_razorpay_payment a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > Razorpay > 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 tu Test Key ID y tu Test Key Secret, configura el webhook en el Razorpay Dashboard e introduce su secreto (consulta Configuración).
6. Activa Enable/Disable y haz un pago de prueba con Test mode activado. Cuando estés listo, introduce las claves del modo real y desmarca Test mode.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Razorpay. Encima de los campos, la página muestra avisos: faltan las claves del modo actual (en ese caso el método de pago se oculta en la finalización de compra), el Key ID no empieza por rzp_test_ en modo de prueba ni por rzp_live_ en modo real, el modo de prueba está activado, el secreto del webhook está vacío, o la moneda de la tienda no es INR y requiere International Payments en tu cuenta de Razorpay. En la lista de métodos de pago, Razorpay aparece como pendiente de configuración hasta que el modo actual tenga sus claves, y una insignia Test mode se muestra mientras el modo de prueba está activado. Los espacios pegados junto con las claves se eliminan al guardar.
General
Enable/Disable: Enable Razorpay 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: UPI, Cards, NetBanking.
Description: el texto que se muestra bajo el método de pago en la finalización de compra. Por defecto: Pay securely via UPI, Credit/Debit Card, or Internet Banking through Razorpay.
API keys
Obtén tus claves en el Razorpay Dashboard, en Account & Settings > API Keys. Cambia el Dashboard al modo de prueba para generar claves de prueba (rzp_test_...). Las claves del modo real (rzp_live_...) están disponibles una vez activada tu cuenta.
Test mode: Use the Test mode keys (no real money is charged). Por defecto: activado. Desmárcalo para aceptar pagos reales. Los pagos, las capturas y los reembolsos de un pedido siempre usan las claves del modo en el que se pagó el pedido, así que cambiar el modo más adelante no afecta a los pedidos existentes.
Test Key ID: el Key ID del Razorpay Dashboard en modo de prueba. Empieza por rzp_test_.
Test Key Secret: el Key Secret del Razorpay Dashboard en modo de prueba.
Live Key ID: el Key ID del Razorpay Dashboard en modo real. Empieza por rzp_live_.
Live Key Secret: el Key Secret del Razorpay Dashboard en modo real.
Payment
Payment Action: cuándo se cobra el dinero. Por defecto: Authorize & Capture.
Webhook
El webhook confirma los pagos incluso cuando el cliente cierra el navegador justo después de pagar, y registra los reembolsos hechos en el Razorpay Dashboard. En el Razorpay Dashboard ve a Account & Settings > Webhooks y añade un webhook en modo de prueba y otro en modo real. Usa la URL que se muestra en esta sección de la configuración. Tiene este aspecto: https://your-site/wc-api/razorpay_p_webhook/. Cópiala exactamente como aparece en la configuración. Introduce en Razorpay un secreto de tu elección y selecciona estos eventos:
Webhook Secret: el secreto que introdujiste al crear el webhook. Usa el mismo secreto para el webhook de prueba y el de modo real, porque el plugin tiene un único campo para ambos. Los webhooks sin una firma válida se rechazan. Sin el webhook, un pago solo se confirma cuando el cliente vuelve de la ventana emergente o vuelve a abrir más tarde la página de pago del pedido.
Advanced
Enable Logging: Save debug logs. El registro está en WooCommerce > Status > Logs, origen wcp_razorpay_payment. Los errores y las advertencias siempre se registran; esta opción añade los detalles de depuración. Las claves, las firmas y los datos de contacto del cliente nunca se registran. Por defecto: desactivado.
Delete Data on Uninstall: Remove the plugin settings and logs when the plugin is deleted (orders are never touched). Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto UPI, Cards, NetBanking) y realiza el pedido. El plugin crea un pedido de Razorpay por el total exacto del pedido y su moneda, y abre la página de pago del pedido. La ventana de Razorpay Checkout se abre allí automáticamente, con el nombre, el correo electrónico y el teléfono del cliente ya rellenados. Si la ventana se cierra, el cliente puede hacer clic en Pay Now para volver a abrirla o en Cancel order. En modo de prueba, la página muestra Razorpay Test mode: no real money will be charged.
Tras un pago correcto, el plugin comprueba la firma de Razorpay, obtiene el pago de la API de Razorpay y compara el importe y la moneda con el pedido. El pedido se marca como pagado solo cuando Razorpay lo confirma. Después, el cliente ve la página de pedido recibido. Si la firma es válida pero el pago no se puede obtener en ese momento, el pedido pasa a On hold y el webhook lo confirma más tarde.
Si el cliente vuelve a un pedido no pagado, el plugin reutiliza su pedido de Razorpay. Si ese pedido de Razorpay ya estaba pagado, por ejemplo porque el cliente cerró el navegador y no hay webhook, el plugin aplica el pago en lugar de pedir un segundo.
Mensajes que puede ver el cliente:
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. No tiene suscripciones ni pagos recurrentes, ni tarjetas guardadas, ni Razorpay Magic Checkout, Payment Links ni Route (pagos divididos), ni widgets de ofertas o de financiación.
Pedidos y reembolsos
Order statuses
Pending payment: se creó el pedido de Razorpay y el cliente aún no ha pagado. Cada pedido de Razorpay se añade a las notas del pedido con su importe y su modo.
Processing or Completed: el pago se capturó y se confirmó; es el estado predeterminado de WooCommerce tras el pago. La nota del pedido muestra el ID del pago de Razorpay, el importe y cómo se confirmó (devolución de llamada, webhook o comprobación al volver). El ID de transacción es el ID del pago de Razorpay (pay_...).
On hold: se aplica en estos casos, cada uno con una nota del pedido: el pago solo se autorizó (Authorize Only), el importe o la moneda pagados no coinciden con el pedido, el pago se capturó para un pedido cancelado, o el pago no se pudo verificar mediante la API de Razorpay en ese momento. Un pedido que ya está On hold también recibe la nota.
Failed: llegó el webhook payment.failed para un pedido pendiente. La nota muestra el error de Razorpay. El cliente todavía puede volver a pagar; un pedido que ya tiene un pago autorizado o capturado no se modifica.
Cancelled: el cliente hizo clic en Cancel order, o el pedido fue cancelado por ti o por el tiempo de espera de la reserva de stock de WooCommerce. Un pago que llegue más tarde no reabre el pedido automáticamente: un pago autorizado no se captura, y un pago capturado pone el pedido en On hold para tu revisión.
Si llega un pago adicional para un pedido que ya está pagado, el pedido no cambia. Una nota te pide que lo reembolses en el Razorpay Dashboard si no era intencionado.
Capture (Authorize Only)
Abre el pedido On hold, elige Capture Razorpay payment en Order actions y haz clic en el botón Actualizar. El pago se captura en el modo en el que se autorizó y el pedido pasa a pagado. Si Razorpay lo rechaza, la nota del pedido muestra Razorpay capture failed: con el motivo. Una captura hecha en el Razorpay Dashboard completa el pedido mediante el webhook.
Refunds
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via seguido del título del método de pago. Se admiten reembolsos totales y parciales. El reembolso se envía con las claves del modo en el que se hizo el pago. Si Razorpay no acepta el reembolso, WooCommerce muestra Razorpay refund failed: con el motivo, y no se registra ningún reembolso. Un reembolso correcto se añade a las notas del pedido con el ID del reembolso de Razorpay, el importe y el estado.
Los reembolsos hechos en el Razorpay Dashboard llegan mediante el webhook y se registran en el pedido como reembolsos de WooCommerce, una sola vez y sin devolver artículos al stock. Un reembolso del Dashboard en otra moneda o superior al importe reembolsable no se registra automáticamente; una nota te pide registrarlo 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 > Razorpay. 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. Quitar la clave de un sitio no libera su espacio de dominio. Libéralo en tu cuenta de vibefox.net.
Sin una clave activa, Razorpay 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. 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 siguen confirmándose y los reembolsos funcionan.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Razorpay no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado y que el modo actual tiene ambas claves: Test Key ID y Test Key Secret en modo de prueba, o Live Key ID y Live Key Secret en modo real. La página de configuración muestra un aviso cuando faltan.
El pago se realizó, pero el pedido sigue en Pending payment: el webhook no funciona. En el Razorpay Dashboard comprueba que el webhook existe en el modo que usas (de prueba o real), que su URL es exactamente la que se muestra en la configuración y que los cinco eventos están seleccionados. Comprueba que Webhook Secret es el mismo secreto que en Razorpay. El pedido también se confirma cuando el cliente vuelve a abrir la página de pago del pedido.
El webhook responde Webhook secret not configured: Webhook Secret está vacío. Introduce el secreto del webhook de Razorpay. Razorpay vuelve a enviar el evento más tarde.
El webhook responde Invalid signature o Missing signature: el secreto de la configuración no coincide con el del webhook de Razorpay. Introduce el mismo secreto en ambos sitios.
El webhook responde Retry later: el plugin no pudo confirmar una captura con la API de Razorpay, o el pedido estaba siendo actualizado por otra solicitud en ese mismo momento. Razorpay vuelve a enviar el evento automáticamente.
Un pedido está On hold: lee la nota del pedido. El pago solo se autorizó (usa Capture Razorpay payment), el importe o la moneda no coincidían con el pedido, el pago llegó para un pedido cancelado, o no se pudo verificar mediante la API de Razorpay en ese momento y espera al webhook.
El cliente ve un error al pagar: abre las notas del pedido o mira WooCommerce > Status > Logs, origen wcp_razorpay_payment. Los errores se registran incluso con Enable Logging desactivado. Las claves incorrectas muestran el mensaje de que el método de pago no está disponible en este momento. Otros motivos de Razorpay se muestran después de Razorpay could not accept this payment:.
La ventana no se abre: el script de Razorpay Checkout fue bloqueado por un bloqueador de contenido o por la conexión. El cliente ve un mensaje y puede recargar la página.
El reembolso falla: el reembolso usa las claves del modo en el que se hizo el pago. Comprueba que las claves de ese modo están configuradas y lee el motivo en el mensaje de error.
El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera un espacio 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 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 Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. Los ajustes de la pasarela y los registros (archivos de registro, incluidos los rotados, y las entradas de registro de la base de datos) solo se eliminan si Delete Data on Uninstall estaba activado. Si no, se conservan para una futura reinstalación. Los pedidos y sus datos de Razorpay nunca se borran. Los pedidos existentes conservan sus notas de pago y sus IDs de transacción.
Razorpay es una marca comercial de su respectivo propietario. Este plugin no está afiliado ni respaldado por Razorpay.