VibeFox MakeCommerce for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. Sin WooCommerce, el plugin rechaza activarse.
PHP: 8.0 o posterior.
Acceso por internet a tu sitio: MakeCommerce envía notificaciones de pago a tu tienda, por lo que el sitio debe ser accesible desde internet (se recomienda HTTPS). Un cortafuegos, el modo de mantenimiento o la autenticación básica pueden bloquearlas.
Cuenta de MakeCommerce: necesitas el Shop ID y la Secret key del Merchant Portal de MakeCommerce (Settings > API). Los entornos de pruebas y de producción tienen cuentas y claves independientes. Los métodos de pago y las monedas disponibles se definen en tu contrato de MakeCommerce (los enlaces bancarios son en EUR). Las monedas con tres decimales, como KWD o BHD, no están disponibles.
Clave de licencia de VibeFox: adquirida 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_makecommerce_payment a /wp-content/plugins/ mediante FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > MakeCommerce > 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 situado en la parte superior de la página y haz clic en Activate.
5. Introduce el Shop ID y la Secret key del entorno de pruebas y, para pagos reales, las claves de producción (consulta Configuración). No es necesario configurar nada en el Merchant Portal.
6. Activa Enable/Disable. Prueba un pago con Test mode activado y, a continuación, desmárcalo para aceptar pagos reales.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > MakeCommerce. Encima de los campos, la página muestra Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. mientras el modo de prueba está activado. Te advierte cuando el método está activado pero el Shop ID o la Secret key del entorno actual están vacíos, y cuando la moneda de la tienda no se puede cobrar con MakeCommerce. En ambos casos, el método se oculta en la finalización de compra. En la lista de métodos de pago, MakeCommerce se muestra como pendiente de configuración hasta que el entorno actual tenga sus claves. Los espacios de las claves se eliminan al guardar.
General
Enable/Disable: Enable MakeCommerce payments activa o desactiva el método de pago. Por defecto: desactivado.
Title: el nombre del método de pago que los clientes ven en la finalización de compra. Por defecto: Bank link or card (MakeCommerce).
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.
MakeCommerce account
El Shop ID y la Secret key están en el Merchant Portal de MakeCommerce en Settings > API. El portal de pruebas y el portal de producción tienen cuentas y claves independientes. La sección tiene enlaces a ambos portales y a la página de registro de MakeCommerce.
Test mode: Use the MakeCommerce test environment (no real money is charged). Los nuevos pagos se crean en el entorno seleccionado con sus claves. Cada pedido recuerda el entorno en el que se pagó: las comprobaciones de estado y los reembolsos siempre van allí. En la finalización de compra se muestra la línea TEST MODE — MakeCommerce test environment, no real money is charged. Por defecto: activado.
Test Shop ID: el Shop ID de tu cuenta de pruebas, con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Test Secret key: la Secret key de tu cuenta de pruebas.
Live Shop ID: el Shop ID de tu cuenta de producción.
Live Secret key: la Secret key de tu cuenta de producción.
Payment notifications
No es necesario configurar nada en el Merchant Portal. Cada transacción incluye sus propias URL de retorno, cancelación y notificación, basadas en la dirección mostrada en esta sección (con el formato https://your-site/wc-api/wc_mkc_payment/) con el número de pedido y la clave de pedido añadidos. MakeCommerce envía un mensaje firmado a la URL de notificación (de servidor a servidor) y mediante el navegador del cliente a la URL de retorno o cancelación. La firma se comprueba con la Secret key del entorno en el que se creó la transacción. Los mensajes sin una firma válida son rechazados.
El plugin gestiona los siguientes estados de transacción de MakeCommerce:
El pago también se confirma cuando el cliente regresa a la tienda. Si el cliente regresa sin un mensaje firmado, el plugin consulta el estado a la API de MakeCommerce.
Advanced
Debug log: Log API calls and payment notifications escribe detalles en WooCommerce > Status > Logs, origen wcp_makecommerce_payment. Los errores siempre se registran. Las claves y los datos de clientes nunca se registran. Por defecto: desactivado.
Delete data: Delete the gateway settings and logs when the plugin is deleted. Los pedidos y sus notas de pago siempre se conservan. Desactivar el plugin nunca elimina nada. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto Bank link or card (MakeCommerce)) y realiza el pedido. El plugin crea una transacción de MakeCommerce por el total del pedido en la moneda del pedido y envía al cliente a la página de pago de MakeCommerce. Allí el cliente elige un enlace bancario o una tarjeta. El correo electrónico de facturación y el país se transfieren a MakeCommerce, y la página se abre en el idioma de la tienda cuando MakeCommerce lo admite (estonio, inglés, letón, lituano, finlandés, ruso, alemán, polaco); en caso contrario, en inglés.
Tras pagar, el cliente regresa a la página de pedido recibido de tu tienda. El pedido solo se marca como pagado después de que MakeCommerce lo confirme: mediante la notificación firmada o mediante el retorno firmado del cliente, con una comprobación de la transacción a través de la API de MakeCommerce.
Si el cliente cancela en la página de MakeCommerce o el pago caduca, el cliente regresa a la finalización de compra (o a la página Pay for order) con un mensaje, por ejemplo The payment was cancelled. You can try again or choose another payment method. o The payment session expired. Please try again. Si el pago aún no se puede confirmar, el mensaje es We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. El cliente puede pagar de nuevo. Un enlace de pago anterior del mismo pedido sigue funcionando, y el pedido no se puede pagar dos veces.
Si MakeCommerce no puede iniciar el pago, el cliente ve MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. o MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. El motivo técnico se añade a las notas del pedido y al 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 banco o la tarjeta se eligen en la página de MakeCommerce, no en tu finalización de compra. El plugin no tiene tarjetas guardadas, pagos recurrentes ni WooCommerce Subscriptions, y no incluye envíos de MakeCommerce (máquinas de paquetería, etiquetas).
Pedidos y reembolsos
Estados del pedido
Pending payment: el cliente fue enviado a MakeCommerce y aún no ha pagado, o MakeCommerce todavía no ha confirmado el pago. La nota del pedido muestra la transacción de MakeCommerce, el importe y el entorno.
Processing: se confirmó el pago. Los pedidos que solo contienen productos virtuales descargables pasan a Completado, el valor predeterminado de WooCommerce. La nota del pedido muestra el importe, la transacción, el entorno y cómo se verificó (API de MakeCommerce o notificación firmada). El ID de transacción es el ID de transacción de MakeCommerce.
On hold: el importe pagado o la moneda diferían del pedido, faltaba el importe, el estado de la transacción en MakeCommerce aún no era definitivo o el pago llegó para un pedido cancelado. La nota del pedido lo explica. Dicha transacción nunca pagará el pedido más tarde. Revisa la transacción en el Merchant Portal y completa o reembolsa el pedido manualmente.
Failed: el último pago del pedido fue cancelado, caducó o falló. El cliente puede pagar de nuevo.
Si llega un segundo pago para un pedido que ya está pagado, el pedido no vuelve a modificarse. Una nota te pide que reembolses el duplicado en el Merchant Portal de MakeCommerce.
Check MakeCommerce payment status
En la pantalla del pedido, elige Check MakeCommerce payment status en las acciones del pedido. El plugin consulta a la API de MakeCommerce el estado de las transacciones del pedido (la más reciente primero), lo aplica y añade una nota con el resultado. Úsalo cuando un pedido permanezca en Pendiente de pago aunque el cliente haya pagado.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Bank link or card (MakeCommerce) (el botón muestra tu Title). Se admiten reembolsos totales y parciales. El reembolso se envía al entorno en el que se pagó el pedido (pruebas o producción), por lo que las claves de ese entorno deben estar configuradas. Si MakeCommerce no acepta el reembolso, WooCommerce muestra el error, se añade una nota y no se registra ningún reembolso. Si MakeCommerce todavía está procesando el pago, el mensaje es MakeCommerce is still processing this payment — try the refund again later. Un reembolso correcto se añade a las notas del pedido con el ID de reembolso de MakeCommerce.
Los reembolsos realizados en el Merchant Portal llegan con el estado de la transacción y se añaden a las notas del pedido. No se registran como reembolsos de WooCommerce automáticamente.
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 > MakeCommerce. 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 espacio de dominio. Libera el espacio en tu cuenta de vibefox.net.
Sin una clave activa, MakeCommerce no se muestra a los clientes en la finalización de compra. Si aun así se inicia un pago, el cliente ve This payment method is not available. Please choose another one. Los gestores de tienda conectados aún ven 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 requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
MakeCommerce no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado y que el entorno actual tenga sus claves: Test Shop ID y Test Secret key en modo de prueba, Live Shop ID y Live Secret key en modo de producción. Comprueba que la moneda de la tienda (o la moneda del pedido en la página Pay for order) tenga como máximo dos decimales. La página de ajustes muestra una advertencia para cada uno de estos problemas.
El pago se realizó, pero el pedido sigue en Pendiente de pago: las notificaciones no pudieron llegar al sitio, por ejemplo debido a un cortafuegos, al modo de mantenimiento o a la autenticación básica. Abre el pedido y ejecuta la acción de pedido Check MakeCommerce payment status. Comprueba que las claves del entorno en el que se realizó el pago estén configuradas: la notificación se comprueba con la Secret key de ese entorno, y sin ella MakeCommerce recibe un error y vuelve a intentarlo.
El pedido está En espera con una nota de MakeCommerce: el pago no coincidía con el pedido (importe, moneda, estado) o llegó para un pedido cancelado. Revisa la transacción en el Merchant Portal y completa o reembolsa el pedido manualmente.
Las notificaciones son rechazadas: un mensaje con una firma incorrecta, para otro pedido, otra tienda o una transacción no creada para el pedido es rechazado y el pedido no se modifica. Comprueba que el Shop ID y la Secret key pertenezcan a la misma cuenta y al mismo entorno de MakeCommerce.
El cliente ve un error al realizar el pedido: abre las notas del pedido o activa Debug log y consulta en WooCommerce > Status > Logs, origen wcp_makecommerce_payment. Una moneda que MakeCommerce no puede cobrar genera MakeCommerce cannot process payments in y el código de moneda.
El reembolso falla con un mensaje sobre el entorno: el pedido se pagó en el entorno de pruebas o de producción, y las claves de ese entorno no están configuradas. Introdúcelas e inténtalo de nuevo.
El reembolso falla con No MakeCommerce transaction ID found for this order: el pedido no tiene ninguna transacción de MakeCommerce. Reembólsalo en el Merchant Portal.
El bloque de licencia muestra un error: sigue las indicaciones del 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 la dirección del sitio cambió, 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 elimínalo en la página Plugins. La clave de licencia y el estado de la licencia de este plugin siempre se eliminan. Los ajustes de la pasarela y los registros solo se eliminan si Delete data estaba activado. En caso contrario, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago e ID de transacción.
MakeCommerce es una marca comercial de su respectivo propietario. Este plugin no está afiliado a MakeCommerce ni cuenta con su respaldo.