VibeFox Cardcom for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 8.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
HTTPS: tu sitio debe ser accesible desde internet por HTTPS, para que Cardcom pueda enviar la notificación de pago.
Moneda: la moneda del pedido debe ser ILS, USD, EUR o GBP. Para cualquier otra moneda, el método de pago se oculta en la finalización de compra.
Cuenta de Cardcom: para los pagos reales necesitas una cuenta de comerciante de Cardcom con número de terminal, nombre de usuario de API y contraseña de API. Los pagos solo necesitan el número de terminal y el nombre de usuario de API. La contraseña de API se usa solo para los reembolsos desde WooCommerce. El modo de prueba funciona sin cuenta de Cardcom.
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_cardcom_payment_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > Cardcom > 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. Activa Enable/Disable, deja Test Mode activado y haz un pedido de prueba con la tarjeta 4580 0000 0000 0000, cualquier fecha de caducidad futura y CVV 123.
6. Para los pagos reales, desmarca Test Mode e introduce el Terminal Number, el API Username y la API Password que te haya dado Cardcom.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Cardcom. Encima de los campos, la página muestra Test mode is on. mientras el modo de prueba está activado. En modo de producción te avisa si falta el número de terminal o el nombre de usuario de API (en ese caso Cardcom queda oculto en la finalización de compra) y te recuerda que sin la contraseña de API no son posibles los reembolsos desde WooCommerce. También avisa cuando la moneda de la tienda no es compatible. Si guardas el modo de producción sin el número de terminal o el nombre de usuario de API, un mensaje de error indica que la pasarela seguirá oculta en la finalización de compra hasta que los introduzcas.
General
Enable/Disable: Enable Cardcom 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: Credit Card (Cardcom).
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely with your credit card via Cardcom.
Modo de prueba
El modo de prueba usa el terminal de prueba público de Cardcom 1000 (usuario de API CardTest1994). No se cobra dinero real y no hace falta una cuenta de Cardcom. Tarjeta de prueba: 4580 0000 0000 0000, cualquier fecha de caducidad futura y CVV 123. En modo de prueba, la finalización de compra también muestra una línea con esta tarjeta de prueba.
Test Mode: Enable test mode (terminal 1000, no real money). Por defecto: activado. Desmárcalo para aceptar pagos reales con las credenciales de producción de abajo. Los reembolsos siempre se envían con las credenciales del modo en el que se pagó el pedido.
Credenciales de producción
El número de terminal, el nombre de usuario de API y la contraseña de API los proporciona Cardcom con tu cuenta de comerciante: en el panel de Cardcom, en los ajustes de API, o a través del soporte de Cardcom. Estos campos se usan solo en modo de producción.
Terminal Number: tu número de terminal de Cardcom. Solo puede contener dígitos. Si introduces otra cosa, se muestra un error y se mantiene el valor anterior.
API Username: tu nombre de usuario de API de Cardcom (ApiName) para este terminal. Los espacios se eliminan al guardar.
API Password: tu contraseña de API de Cardcom. Solo se necesita para los reembolsos desde WooCommerce y se guarda tal como la escribes.
Página de pago
Cardcom envía las notificaciones de pago (IndicatorUrl) a la dirección que se muestra en esta sección. Tiene el aspecto de https://your-site/wc-api/cardcom_p_callback/. La dirección se pasa a Cardcom automáticamente con cada pago, junto con el ID del pedido, así que no hay nada que configurar en Cardcom. Debe ser accesible desde internet.
Operation: lo que hace Cardcom en la página de pago.
Max Installments: el número máximo de cuotas (pagos) que el cliente puede elegir en la página de Cardcom, de 1 a 36. 1 significa sin cuotas. Por defecto: 1.
Success Order Status: el estado del pedido tras un pago confirmado. 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_cardcom_payment_gateway. Los errores siempre se registran. Las credenciales, los tokens de tarjeta y los datos del titular nunca se escriben. Por defecto: desactivado.
Delete on Uninstall: Delete all plugin data when uninstalling. Si está activado, al eliminar el plugin se borran de forma permanente los ajustes, los datos de Cardcom guardados en los pedidos y los registros. Los pedidos en sí se conservan. Por defecto: desactivado.
Finalizar compra
El cliente elige el método de pago (por defecto, Credit Card (Cardcom)) y realiza el pedido. El plugin crea una página de pago de Cardcom por el total del pedido en la moneda del pedido y envía allí al cliente. La página se abre en hebreo cuando el idioma del sitio es el hebreo, y en inglés en los demás casos. Los artículos del pedido se pasan a Cardcom como nombre del producto. El cliente introduce los datos de la tarjeta y, si se permiten cuotas, elige el número de pagos.
Tras pagar, el cliente vuelve a la página de pedido recibido de tu tienda. El pedido se marca como pagado solo cuando Cardcom lo confirma. Cardcom llama a la dirección de notificación, y el plugin toma de esa llamada solo el código de la página de pago. Comprueba que ese código lo emitió tu tienda para ese pedido y después pide a Cardcom, de servidor a servidor, el resultado real. Si la notificación llega tarde, la misma comprobación se ejecuta cuando el cliente llega a la página de pedido recibido.
Si el pago no se completa, Cardcom devuelve al cliente a la finalización de compra (o a la página Pay for order), que muestra The card payment was not completed. Please try again or choose a different payment method. Un pago rechazado que confirma Cardcom marca el pedido como Fallido. El cliente puede volver a pagar un pedido no pagado, por ejemplo desde la página Pay for order. Un pago hecho en una página de pago anterior del mismo pedido sigue reconociéndose. Si el cliente cambió a otro método de pago pero pagó en la página de Cardcom, el pago se registra y el método de pago vuelve a ser Cardcom.
Si Cardcom no puede abrir la página de pago, el cliente ve un mensaje breve, por ejemplo Could not connect to Cardcom. Please try again in a moment., o un aviso de que Cardcom no pudo abrir la página de pago, junto con el código de Cardcom, y puede elegir otro método de pago.
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 con tarjeta solo en la página de Cardcom. No tiene tarjetas guardadas ni pagos con un clic, no tiene suscripciones, no cobra tokens guardados y no tiene ajustes de factura o recibo de Cardcom. Tampoco incluye Bit, Apple Pay, Google Pay ni PayPal a través de Cardcom, ni modo iframe, ni cargos con captura posterior. Las páginas de pago abandonadas no se comprueban automáticamente.
Pedidos y reembolsos
Estados del pedido
Pending payment: el cliente fue enviado a Cardcom y todavía no ha pagado, o Cardcom todavía no ha confirmado el pago.
Processing, Completed or On Hold: el pago fue confirmado. El estado sigue a Success Order Status. La nota del pedido muestra la transacción de Cardcom y, cuando Cardcom los informa, las últimas cuatro cifras de la tarjeta, el número de factura y el número de cuotas. Los pagos de prueba se marcan con Test mode — no real money was charged. El ID de transacción del pedido es el número de operación de Cardcom.
On hold after payment: Cardcom confirmó un pago que no coincide con el pedido, por ejemplo porque el total del pedido cambió después de abrir la página de pago, o porque se cobró otro importe o moneda. La nota del pedido lo explica. Compara el pago en el panel de Cardcom con el pedido y, después, tramita el pedido o reembolsa el pago.
Failed: Cardcom rechazó el pago. La nota del pedido muestra el código de respuesta de Cardcom. Un rechazo en una página de pago anterior no hace fallar un intento más reciente, y un rechazo tardío nunca cambia un pedido pagado.
Si llega un segundo pago correcto para un pedido que ya está pagado (por ejemplo, si el cliente pagó en dos pestañas del navegador), el pedido no se vuelve a modificar. Una nota advierte de que el cliente puede haber sido cobrado dos veces y te pide que hagas el reembolso en el panel de Cardcom.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Credit Card (Cardcom) (el botón muestra el título del método de pago). Se admiten reembolsos totales y parciales, y se pueden hacer varios reembolsos parciales de un mismo pedido. El reembolso se envía con las credenciales del modo en el que se pagó el pedido: los pedidos de prueba se reembolsan en el terminal de prueba de Cardcom incluso después de cambiar al modo de producción, y los pedidos reales siempre usan tus credenciales de producción. Los reembolsos reales necesitan el API Username y la API Password. Si Cardcom 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 la transacción de reembolso de Cardcom y el motivo.
Los reembolsos hechos en el panel de Cardcom 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 > Cardcom. 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, Cardcom 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
Cardcom no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado y que la moneda del pedido sea ILS, USD, EUR o GBP. En modo de producción, comprueba que Terminal Number y API Username estén rellenados. La página de ajustes muestra un aviso cuando falta algo.
El pago se realizó, pero el pedido sigue en Pendiente de pago: Cardcom no pudo llegar a tu sitio, por ejemplo por el modo de mantenimiento, un cortafuegos, la protección con contraseña o un sitio de desarrollo local. La dirección de notificación debe ser accesible desde internet por HTTPS. El pedido también se confirma cuando el cliente vuelve a la página de pedido recibido. Activa el Debug log y revisa WooCommerce > Status > Logs, origen wcp_cardcom_payment_gateway.
La notificación responde Missing or invalid lowprofilecode o Unknown lowprofilecode for this order: la llamada no traía un código de página de pago emitido por tu tienda para ese pedido. El pedido no se modifica.
La notificación responde Gateway not configured o Indicator check failed: faltan las credenciales del modo en el que se creó la página de pago, o no se pudo contactar con Cardcom para la comprobación. El pedido no se modifica y se vuelve a comprobar cuando el cliente vuelve a la tienda.
La notificación responde ReturnValue mismatch o Terminal mismatch: Cardcom informó de un pago de otro pedido o de otro terminal. El pedido no se modifica. Comprueba que Terminal Number sea el terminal de tu cuenta.
El cliente ve Payment error: this currency is not supported by Cardcom.: la moneda del pedido no es ILS, USD, EUR ni GBP.
El cliente ve Card payment is temporarily unavailable. Please choose another payment method.: el modo de producción está activado, pero falta el número de terminal o el nombre de usuario de API.
El cliente ve un error al realizar el pedido: revisa las notas del pedido o activa el Debug log y mira el registro. Los problemas de conexión y los códigos de error de Cardcom se escriben allí.
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. Tramita el pedido o reembolsa el pago.
El reembolso falla con API username and API password are required for refunds: introduce la API Password (y el API Username) en los ajustes y vuelve a intentarlo.
El reembolso falla con Could not connect to Cardcom: revisa el panel de Cardcom antes de volver a intentarlo, porque el reembolso puede o no haberse hecho.
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 describe el filtro cardcom_p_supported_currencies, que amplía la lista de monedas (añade solo las monedas habilitadas en tu terminal de Cardcom).
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 datos de Cardcom guardados en los pedidos y los registros se eliminan solo si Delete 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.
Cardcom es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Cardcom ni cuenta con su respaldo.