VibeFox Comgate 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.
HTTPS: tu sitio debe ser accesible por HTTPS desde internet, para que Comgate pueda enviar la notificación en segundo plano.
Moneda: CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK o SEK. Para otras monedas y para totales inferiores al mínimo de Comgate, el método de pago se oculta. Los pagos en HUF se redondean a forintos enteros, como exige Comgate.
Cuenta de Comgate: necesitas el ID de comerciante y el secret (la contraseña para la comunicación en segundo plano) de la conexión de tu tienda en el portal de cliente de Comgate, y la URL de notificación configurada allí (consulta Configuración). Comgate usa el mismo ID de comerciante y el mismo secret para los pagos de prueba y los reales.
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_comgate_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > Comgate > 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 y el Secret del portal de cliente de Comgate y configura allí la URL de notificación (consulta Configuración).
6. Activa Enable / Disable. Mantén Test Mode activado para un pago de prueba y, después, desactívalo.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Comgate. Encima de los campos, la página te avisa cuando Comgate está activado pero falta el Merchant ID o el secret (en ese caso el método de pago queda oculto en la finalización de compra hasta que se rellenen ambos), y cuando la moneda de la tienda no es compatible. Mientras el modo de prueba está activado, muestra Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live.
General
Enable / Disable: Enable Comgate 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: Comgate.
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely via Comgate — cards, bank transfers, wallets and more. En modo de prueba se le añade TEST MODE: no real money is charged., o se muestra solo esa línea cuando la descripción está vacía.
Conexión con Comgate
Toma el identificador de la tienda (Merchant ID) y la contraseña (secret) del portal de cliente de Comgate, en Integration > shop connection settings. En el mismo sitio, configura la URL for passing the payment result (notificación en segundo plano) con la URL que se muestra en esta sección. Tiene el aspecto de https://your-site/wc-api/comgate_payment_callback/. Comgate la llama después de cada pago; el plugin entonces vuelve a comprobar el pago con la API de estado de Comgate antes de modificar el pedido. Las URL de retorno para el cliente se envían con cada pago. Si el portal también pide URL de retorno (pagado, cancelado, pendiente), usa la segunda URL que se muestra en esta sección, que tiene el aspecto de https://your-site/wc-api/comgate_payment_return/?id=${id}&refId=${refId}.
Merchant ID: el identificador de la tienda online de Comgate (comerciante).
Secret: la contraseña para la comunicación en segundo plano (secret) de esta conexión de tienda.
Test Mode: Create test payments (no money is charged). Comgate usa el mismo Merchant ID y secret para los pagos de prueba y los reales; los pagos de prueba se marcan con test=true. Los reembolsos siempre se envían en el modo del pago original. Por defecto: activado.
Página de pago
Payment Methods: de qué métodos de pago de Comgate puede elegir el cliente. Solo se muestran los métodos activados para tu tienda en Comgate.
Language: el idioma de la página de pago de Comgate. Automatic (site language, English as fallback) (por defecto) o uno de los 26 idiomas.
Pedidos
Order Status After Payment: el estado que se asigna cuando Comgate confirma el pago. El estado se asigna de una vez, sin un segundo cambio de estado.
Avanzado
Debug Log: Log API requests and notifications escribe en WooCommerce > Status > Logs, origen wcp_comgate_gateway. El secret y los datos personales nunca se registran. Los errores siempre se registran. Por defecto: desactivado.
Delete Data on Uninstall: Remove the gateway settings and log files when the plugin is deleted. Los pedidos y sus ID de transacción de Comgate se conservan siempre. Por defecto: desactivado.
Finalizar compra
El cliente elige el método de pago (por defecto, Comgate) y realiza el pedido. El plugin crea el pago en Comgate por el total del pedido en la moneda del pedido y redirige al cliente a la página de pago de Comgate. El correo electrónico y el nombre de facturación se envían a Comgate, y el pago se identifica con el número de pedido. Es obligatoria una dirección de correo electrónico de facturación válida. En la página de Comgate, el cliente paga con uno de los métodos que permitiste.
Tras pagar, el cliente vuelve a tu tienda. El pedido se marca como pagado solo cuando Comgate lo confirma: el plugin lee el pago desde la API de estado de Comgate, tanto cuando llega la notificación en segundo plano como cuando el cliente vuelve. Si el pago todavía no está confirmado, por ejemplo una transferencia bancaria en camino, la página de pedido recibido muestra Comgate has not confirmed your payment yet. The order will be updated automatically as soon as the payment is confirmed — please do not pay again. Si el pedido se puso en espera, la página muestra Your payment is being reviewed. We will contact you if anything else is needed.
Si el pago se cancela o caduca, el cliente vuelve a la finalización de compra (o al carrito) con The Comgate payment was cancelled or has expired. You can try again or choose another payment method. Un cliente puede volver a pagar un pedido no pagado, por ejemplo desde la página Pay for order. El intento anterior se revisa primero, así que un pago que ya se completó no se cobra dos veces, y se cancela en Comgate si sigue abierto. Un pago tardío de un intento anterior sigue pagando un pedido no pagado.
Si Comgate no puede iniciar el pago, el cliente ve un mensaje breve, por ejemplo The Comgate payment could not be started. Please try again or choose another payment method., que Comgate no acepta este importe o esta moneda, o que el método de pago de Comgate seleccionado no está disponible. El motivo técnico se escribe en el 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).
El plugin acepta pagos únicos solo en la página de Comgate. No tiene pagos recurrentes, suscripciones ni tarjetas guardadas, ni finalización de compra integrada de Comgate, ni botones de Apple Pay o Google Pay en tu sitio (están disponibles en la página de Comgate), ni captura ni anulación de preautorizaciones desde WooCommerce. Sin la notificación, el estado del pago no se consulta automáticamente; solo se comprueba cuando el cliente vuelve.
Pedidos y reembolsos
Estados del pedido
Pending payment: el cliente fue enviado a Comgate y todavía no ha pagado, o Comgate informa del pago como pendiente. La nota del pedido muestra el pago de Comgate creado.
Processing or Completed: Comgate informó del pago como PAID con el mismo importe y moneda. El estado sigue a Order Status After Payment. El ID de transacción del pedido es el ID de transacción de Comgate; todos los intentos se guardan con el pedido. Los pagos de prueba reciben la nota Comgate test payment — no money was charged.
On hold: el importe o la moneda pagados difieren del pedido, se confirmó un pago de prueba mientras la tienda está en modo de producción (no se recibió dinero), o el pago solo está autorizado (preautorización en tu cuenta de Comgate). Un pago autorizado pasa a pagado automáticamente cuando lo capturas en el portal de Comgate. La nota del pedido explica el motivo.
Cancelled: el pago actual de Comgate se canceló o caducó. Si Comgate confirma el pago después de que WooCommerce cancelara el pedido no pagado (por ejemplo, una transferencia bancaria lenta), el pedido se reabre como pagado con una nota para revisar el stock antes de enviarlo.
Si Comgate informa de otro pago PAID para un pedido que ya está pagado, el pedido no se vuelve a modificar. Una nota te pide que lo revises en el portal de Comgate y reembolses el duplicado. Una confirmación reenviada nunca reabre un pedido reembolsado ni un pedido cancelado después del pago.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Comgate (el botón muestra el título del método de pago). Se admiten reembolsos totales y parciales. El reembolso se aplica a la transacción pagada de Comgate y se envía en el modo (de prueba o de producción) del pago original. Comgate solo reembolsa pagos PAID y como máximo el importe pagado; los reembolsos en HUF deben ser de forintos enteros. Si Comgate no acepta el reembolso, WooCommerce muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade a las notas del pedido con el importe, la transacción de Comgate y el motivo.
Los reembolsos hechos en el portal de Comgate no se comunican a la tienda. Si hace falta, crea un reembolso manual en WooCommerce sin usar el reembolso a través de la pasarela (Refund via).
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 > Comgate. 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, Comgate 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 pagos ya iniciados se siguen confirmando y los reembolsos funcionan.
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
Comgate no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable / Disable esté activado, que Merchant ID y Secret estén rellenados, que la moneda del pedido sea compatible y que el total del pedido no esté por debajo del mínimo de Comgate (por ejemplo, 1 CZK, 0,10 EUR o 100 HUF). La página de ajustes muestra un aviso cuando faltan las credenciales o la moneda no es compatible.
El pago se realizó, pero el pedido sigue en Pendiente de pago: Comgate no ha entregado la notificación en segundo plano. Revisa la URL for passing the payment result en el portal de Comgate, que tu sitio sea accesible por HTTPS desde internet (sin modo de mantenimiento ni protección con contraseña) y el registro (activa el Debug Log). Comgate reintenta las notificaciones no entregadas; el plugin responde con un error siempre que no ha podido procesar una, así que se volverá a intentar. El pedido también se confirma cuando el cliente vuelve a la tienda.
La notificación responde Invalid merchant or secret: el Merchant ID o el secret de los ajustes no coinciden con la conexión de la tienda en el portal de Comgate.
La notificación responde Gateway not configured: el Merchant ID o el secret están vacíos en los ajustes. Comgate lo reintenta cuando se rellenen.
La notificación responde Order not found, Unknown transaction o Reference mismatch: la notificación pertenece a un pago que no creó esta tienda para ese pedido. El pedido no se modifica.
La notificación responde Status verification failed, Status verification rejected o Busy, retry later: no se pudo contactar con la API de estado de Comgate, esta rechazó la petición, o el pedido estaba siendo procesado por otra petición en ese mismo momento. Comgate reintenta la notificación.
El cliente ve We could not verify the Comgate payment: el enlace de retorno no coincidía con el pedido. Si se cobró el dinero, la notificación igualmente confirma el pedido. Revisa el pago en el portal de Comgate antes de que el cliente vuelva a pagar.
El cliente ve The order total is below the minimum amount accepted by Comgate o A valid billing e-mail address is required for Comgate payments: el pedido no se puede pagar con Comgate tal como está.
El pedido está en On hold tras el pago: lee la nota del pedido. El importe o la moneda pagados eran distintos, llegó un pago de prueba en modo de producción, o el pago solo está autorizado. Revisa el pago en el portal de Comgate y completa o reembolsa el pedido manualmente.
El reembolso falla: lee el mensaje. Comgate rejected the refund: the amount exceeds the refundable amount. significa que el importe es mayor que lo que queda por reembolsar; un pago en un estado distinto de PAID no se puede reembolsar. Comgate could not be reached. The refund was not made — please try again later. significa un problema de conexión.
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.
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 archivos de registro se eliminan solo si Delete Data on Uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos y sus datos de Comgate se conservan siempre. Los pedidos existentes conservan sus notas de pago e ID de transacción.
Comgate es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Comgate ni cuenta con su respaldo.