VibeFox MakeCommerce for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.
Acceso a internet a tu tienda: MakeCommerce envía las notificaciones de pago a tu tienda, por lo que el sitio debe ser accesible desde internet. Un firewall o la autenticación básica pueden bloquearlas. El modo de mantenimiento y la restricción de países de tu tienda no las bloquean.
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 los define tu contrato de MakeCommerce. No se ofrecen monedas con tres decimales, como KWD o BHD.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.
Instalación
1. En el back office, ve a Modules > Module Manager y haz clic en Upload a module. Selecciona el archivo ZIP del módulo.
2. Cuando termine la subida, haz clic en Configure, o busca más tarde VibeFox MakeCommerce Payment en la lista de módulos y haz clic en Configure.
3. Introduce tu clave de licencia de VibeFox en License key, en el bloque de licencia de la parte superior de la página Configure, y haz clic en Activate (consulta Clave de licencia).
4. Introduce el Shop ID y la Secret key del entorno de pruebas y, para los pagos reales, las claves de producción (consulta Configuración). No hay que configurar nada en el Merchant Portal.
5. Activa Enable/Disable y haz clic en Save. Prueba un pago con Test mode activado y, después, desactívalo para aceptar pagos reales.
Al instalarse, el módulo crea el estado de pedido MakeCommerce payment on hold. PrestaShop ofrece el nuevo módulo de pago para todas las monedas, países y grupos de clientes. Puedes limitarlos en Payment > Preferences.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox MakeCommerce Payment > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. 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. Avisa cuando el método está activado pero el Shop ID o la Secret key del entorno actual están vacíos, y cuando MakeCommerce no puede cobrar la moneda predeterminada de la tienda. En ambos casos, el método se oculta en la finalización de compra. Al guardar, se eliminan los espacios de las claves.
MakeCommerce
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 ven los clientes en la finalización de compra. También es el nombre del método de pago que se guarda en el pedido. Por defecto: Bank link or card (MakeCommerce). Obligatorio.
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.
Cuenta de MakeCommerce
El Shop ID y la Secret key están en el Merchant Portal de MakeCommerce, en Settings > API. El portal de pruebas y el de producción tienen cuentas y claves independientes. La sección incluye enlaces a ambos portales y a la página de registro de MakeCommerce.
Test mode: usa el entorno de pruebas de MakeCommerce (no se cobra dinero real). 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í. Mientras esté activado, los clientes ven TEST MODE — MakeCommerce test environment, no real money is charged. debajo del método de pago. 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.
Las claves secretas guardadas nunca se vuelven a mostrar. El campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo.
Clear saved secret keys: marca una clave y haz clic en Save para eliminarla. Un campo vacío conserva el valor guardado.
Notificaciones de pago
No hay que configurar nada en el Merchant Portal. Callback URLs muestra, como referencia, la dirección de retorno o cancelación del cliente y la dirección para las notificaciones de pago. Cada transacción incluye sus propias URL de retorno, cancelación y notificación, basadas en estas direcciones con el número de carrito y una clave añadida. MakeCommerce envía un mensaje firmado a la URL de notificación (de servidor a servidor) y, a través del 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 se rechazan.
El módulo gestiona estos estados de transacción de MakeCommerce:
El pago también se confirma cuando el cliente vuelve a la tienda. Si el cliente regresa sin un mensaje firmado, el módulo consulta el estado a la API de MakeCommerce.
Avanzado
Debug log: registra las llamadas a la API y las notificaciones de pago en logs/wc_mkc_debug.log.php, dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores siempre se registran. Las claves y los datos de clientes nunca se registran. Por defecto: desactivado.
Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.
Delete data: si está activado, al desinstalar el módulo se eliminan sus ajustes y el registro. Los pedidos y sus datos de pago de MakeCommerce siempre se conservan. Por defecto: desactivado.
Finalización de compra
En el paso de pago, el cliente elige el método de pago (por defecto, Bank link or card (MakeCommerce)) y confirma. El módulo crea una transacción de MakeCommerce por el total del carrito en la moneda del carrito 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 y el país del cliente se transmiten 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. En este momento todavía no existe ningún pedido.
Tras pagar, el cliente vuelve a tu tienda. El pedido se marca como pagado solo cuando MakeCommerce lo confirma: mediante la notificación firmada o el retorno firmado del cliente, con una comprobación de la transacción a través de la API de MakeCommerce. Entonces se crea el pedido y el cliente ve la página estándar de confirmación del pedido con Your MakeCommerce payment has been received. Si el pedido pasó a espera para revisión, la página muestra Your MakeCommerce payment was received and is being reviewed by the shop.
Si el pago está aprobado pero aún no completado, o no se puede contactar con MakeCommerce, aparece la página Payment confirmation con el mensaje We could not confirm your payment yet. If you completed it, your order will be updated automatically — please do not pay again. y los botones Check again y Back to checkout. La notificación crea el pedido en cuanto se complete el pago.
Si el cliente cancela en la página de MakeCommerce o el pago caduca o falla, el cliente vuelve a la finalización de compra con un mensaje, por ejemplo The payment was cancelled. You can try again or choose another payment method., The payment session expired. Please try again. o The payment was not completed. Please try again or choose another payment method. El carrito se conserva y el cliente puede volver a pagar. Cada intento es una nueva transacción de MakeCommerce. Un enlace de pago anterior del mismo carrito sigue funcionando, y el carrito no se puede pagar dos veces en dos pedidos.
Si MakeCommerce no puede iniciar el pago, el cliente permanece en la finalización de compra con 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 escribe en el registro.
El banco o la tarjeta se eligen en la página de MakeCommerce, no en tu finalización de compra. El módulo no tiene tarjetas guardadas, pagos recurrentes ni suscripciones, ni envíos de MakeCommerce (máquinas de paquetería, etiquetas).
Pedidos y reembolsos
Order statuses
No order yet: el cliente fue enviado a MakeCommerce y no ha pagado, o MakeCommerce todavía no ha confirmado el pago. Solo existe el carrito.
Payment accepted: el pago fue confirmado. El pago se registra con el ID de transacción de MakeCommerce, y una nota muestra el importe, la transacción, el entorno y cómo se verificó (API de MakeCommerce o notificación firmada).
MakeCommerce payment on hold: el importe o la moneda pagados no coincidían con el carrito (por ejemplo, si el carrito se modificó después de iniciar el pago), faltaba el importe, la transacción en MakeCommerce todavía no era definitiva aunque se informó como completada, o el pago llegó después de que el pedido se hubiera cancelado. La nota lo explica. Si la moneda pagada es la del pedido, en el pedido se registra el importe realmente pagado. Una transacción con discordancia nunca paga el pedido más adelante; una transacción que aún no era definitiva completa el pedido cuando MakeCommerce la informa como completada. Comprueba la transacción en el Merchant Portal y tramita el pedido o reembolsa el pago.
Refunded: el pago se reembolsó por completo a través del módulo.
Si llega un segundo pago para un pedido que ya está pagado, el pedido no cambia. Una nota te pide que reembolses el duplicado en el Merchant Portal de MakeCommerce.
Bloque de pago de MakeCommerce
La página del pedido muestra un bloque MakeCommerce payment con todas las transacciones de MakeCommerce del carrito (fecha, ID de transacción, una insignia Test para los pagos de prueba, importe, estado y resultado de MakeCommerce), los importes pagado y reembolsado, el historial de reembolsos y las MakeCommerce notes del pedido. Los botones del bloque solo requieren el permiso para editar pedidos, no el acceso a los módulos.
Check MakeCommerce payment status: consulta a la API de MakeCommerce el estado de las transacciones del carrito (primero las más recientes), lo aplica y añade una nota con el resultado. Úsalo cuando un cliente diga que ha pagado pero el pedido no se ha completado.
Reembolsos
En el bloque MakeCommerce payment, introduce el importe (se rellena el importe que aún no se ha reembolsado), opcionalmente un motivo, y haz clic en Refund via MakeCommerce. Confirma la pregunta Refund this amount via MakeCommerce? Se admiten reembolsos totales y parciales. Los reembolsos están limitados al importe y a la moneda de la transacción de MakeCommerce, así que tras una discordancia de importes puedes reembolsar hasta lo que el cliente pagó realmente, no el total del pedido. El reembolso se envía al entorno en el que se realizó el pago (prueba o producción), por lo que las claves de ese entorno deben estar configuradas. El motivo se envía a MakeCommerce como comentario del reembolso; si no hay motivo, el comentario es Refund for order y la referencia del pedido. Si MakeCommerce no acepta el reembolso, el bloque 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 al historial de reembolsos y a las notas con el ID de reembolso de MakeCommerce. Un reembolso total cambia el estado del pedido a Refunded. Un reembolso parcial no cambia el estado. Los reembolsos están disponibles una vez que MakeCommerce ha confirmado el pago.
El módulo no crea abonos. Los botones estándar de reembolso de PrestaShop de la página del pedido no devuelven el dinero a través de MakeCommerce.
Los reembolsos hechos en el Merchant Portal llegan con el estado de la transacción y se añaden a las notas. El estado del pedido y los abonos no se cambian automáticamente.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox MakeCommerce Payment es el primer bloque de Modules > Module Manager > VibeFox MakeCommerce Payment > Configure, encima de los ajustes. Pega la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo aparecen la línea Product: presta-payment-makecommerce y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure para el módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (se incluyen inglés y ruso).
Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on seguido de una fecha. Después de cambiar la dirección de la tienda, o después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede contactar con el servidor de licencias, el módulo sigue funcionando con el último estado conocido.
Una clave funciona en un solo dominio: el dominio de la tienda principal, también en una configuración multitienda. Quitar la clave de la tienda no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, MakeCommerce 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. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que el método de pago también se oculta para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en la finalización de compra. Aparece un recordatorio en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados: los pagos ya iniciados se siguen confirmando y los reembolsos funcionan.
Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días después de introducir la clave, y después una vez a la semana. No se necesita ninguna tarea cron. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.
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 del carrito tenga como máximo dos decimales. En Payment > Preferences, comprueba que el módulo esté permitido para la moneda del carrito, el país del cliente y el grupo del cliente.
El pago se realizó, pero no se creó ningún pedido: las notificaciones no pudieron llegar a la tienda, por ejemplo por un firewall o por la autenticación básica. El pedido también se crea cuando el cliente vuelve a la tienda o hace clic en Check again. Comprueba que estén configuradas las claves del entorno en el que se realizó el pago: la notificación se verifica con la Secret key de ese entorno y, sin ella, MakeCommerce recibe un error y lo vuelve a intentar. Activa Debug log para ver las notificaciones.
El pedido está en MakeCommerce payment on hold: lee las MakeCommerce notes del bloque de la página del pedido (consulta Estados del pedido), comprueba la transacción en el Merchant Portal y, después, tramita el pedido o reembolsa el pago.
Las notificaciones se rechazan: un mensaje con una firma incorrecta, para otro carrito, otra tienda o una transacción no creada para el carrito se rechaza y no se cambia nada. 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 elegir MakeCommerce: activa Debug log y revisa el campo Log de la página del módulo. Una moneda que MakeCommerce no puede cobrar muestra MakeCommerce cannot process payments in y el código de la moneda.
El reembolso falla con un mensaje sobre el entorno: el pedido se pagó en el entorno de prueba o de producción, y las claves de ese entorno no están configuradas. Introdúcelas y vuelve a intentarlo.
El reembolso falla con No MakeCommerce transaction ID found for this order: el pedido no tiene un pago de MakeCommerce confirmado. Reembólsalo en el Merchant Portal.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox MakeCommerce Payment y elige Uninstall. La clave de licencia y el estado de la licencia de este módulo siempre se eliminan. Si Delete data está activado, se eliminan los ajustes del módulo y el registro. Si está desactivado, todos los ajustes se conservan para una reinstalación posterior. Las transacciones y los reembolsos de MakeCommerce y el estado de pedido MakeCommerce payment on hold se conservan siempre, de modo que los pedidos pagados antes pueden seguir reembolsándose tras una reinstalación. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
MakeCommerce es una marca comercial de su respectivo titular. Este módulo no está afiliado a MakeCommerce ni avalado por MakeCommerce.