VibeFox KOMOJU for OpenCart — Ayuda

Requisitos

OpenCart: 3.0.x (probado en 3.0.5.0) o 4.0.2 y posteriores (probado en 4.1.0.3).

PHP: 8.0 o posterior.

Cuenta de KOMOJU: necesitas la clave secreta (sk_live_... y, para el modo de prueba, sk_test_...) y el token secreto de un webhook creado en el panel de KOMOJU (consulta Configuración). La clave pública no es necesaria. KOMOJU debe poder acceder a la URL del webhook de tu tienda.

Moneda del pedido: JPY, USD, EUR, TWD, KRW, PLN, GBP, HKD, SGD, NZD, AUD, IDR, MYR, PHP, THB, CNY, BRL, CHF, CAD o VND. Para pedidos en otras monedas, el método de pago queda oculto.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un dominio.

Instalación

La descarga es un único archivo zip con los paquetes para ambas versiones de OpenCart. Descomprímelo en tu ordenador. Contiene README.txt, el paquete de OpenCart 3 wcp_komoju_payment-oc3-(version).ocmod.zip y el paquete de OpenCart 4 wcp_komoju_payment.ocmod.zip. Instala solo el paquete de tu versión de OpenCart. La clave de licencia es la misma para ambas versiones.

OpenCart 3

1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo wcp_komoju_payment-oc3-(version).ocmod.zip. La extensión no tiene modificaciones OCMOD, así que Extensions > Modifications no necesita actualizarse. En lugar del instalador, también puedes copiar el contenido de la carpeta upload de este paquete en la carpeta raíz de tu tienda.

2. Ve a Extensions > Extensions, elige el tipo Payments, busca VibeFox KOMOJU Payment y haz clic en Install (el botón verde +). Tu usuario administrador necesita el permiso para modificar la lista de extensiones de pago.

3. Haz clic en Edit (el botón de lápiz) para abrir la página de configuración. Pega tu clave de licencia de VibeFox en License key, en el bloque de licencia de la parte superior de la página, y haz clic en Activate (consulta Clave de licencia).

4. En el panel de KOMOJU, añade un webhook con la URL y los eventos que se indican en la sección Webhook URL, y copia su token secreto (consulta Configuración).

5. Introduce la clave secreta en vivo y el token secreto del webhook en vivo, así como las claves de prueba para el modo sandbox. Activa Enable/Disable y haz clic en Save.

OpenCart 4

1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo wcp_komoju_payment.ocmod.zip. No cambies el nombre del archivo: OpenCart 4 toma el código de la extensión del nombre del archivo, y un paquete renombrado no funciona.

2. El paquete aparece en la lista de extensiones instaladas en la misma página. Haz clic en Install (el botón verde +) junto a él.

3. Ve a Extensions > Extensions y elige el tipo Payments. Busca VibeFox KOMOJU Payment, haz clic en Install (el botón verde +) y luego en Edit (el botón del lápiz).

4. Introduce la clave de licencia, el webhook y las claves como en los pasos 3 a 5 de OpenCart 3. La página de configuración y sus campos son los mismos en ambas versiones. Solo la URL del webhook es distinta (consulta URL del webhook).

Una instalación nueva empieza con el método de pago desactivado y el modo sandbox desactivado.

Configuración

Todos los ajustes están en la página de la extensión: Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit. Las secciones aparecen a la izquierda; el botón Save situado debajo de la lista guarda toda la página. Encima de los ajustes, la página muestra KOMOJU Sandbox Mode is enabled. mientras el modo de prueba está activado. Avisa cuando el modo actual no tiene clave secreta (en ese caso el método de pago queda oculto en la finalización de compra) o token secreto del webhook (las notificaciones de KOMOJU se rechazan, de modo que los pagos en konbini y por transferencia nunca se confirman), y cuando KOMOJU no admite la moneda predeterminada de la tienda (en ese caso el método de pago queda oculto para pedidos en esa moneda). Sin el permiso para modificar la extensión, la página muestra los ajustes pero no permite guardarlos.

Al guardar, Title debe tener como máximo 128 caracteres, Sort Order debe ser un número entero (se permiten números negativos), Total debe ser un número igual o mayor que 0, y la zona geográfica y los estados de pedido deben existir. Si no, no se guarda nada y la página indica el campo. Las claves que faltan no impiden guardar.

Método de pago KOMOJU

Enable/Disable: Enable KOMOJU Payment Gateway activa o desactiva el método de pago. Predeterminado: desactivado.

Title: el nombre del método de pago que ve el cliente en la finalización de compra. También es el nombre del método de pago guardado en el pedido. Predeterminado: KOMOJU Payment. Si lo dejas vacío, se usa el nombre predeterminado. Máximo 128 caracteres.

Description: el texto que ve el cliente en el paso Confirm Order, encima del botón de confirmación. Predeterminado: Pay securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

Sort Order: la posición de KOMOJU entre los métodos de pago en la finalización de compra. Déjalo vacío o introduce un número entero.

Geo Zone: ofrece KOMOJU solo para direcciones de pago de la zona geográfica seleccionada. Predeterminado: All zones. Las zonas geográficas se configuran en System > Localisation > Geo Zones.

Total: el total de la compra, en la moneda predeterminada de la tienda, que un pedido debe alcanzar antes de ofrecer KOMOJU. Déjalo vacío para ofrecer KOMOJU con cualquier importe.

Claves de API en vivo

Encuentra las claves en el panel de KOMOJU (allí hay enlaces a las secciones): la clave secreta en Settings > API keys, y el token secreto del webhook en Settings > Webhooks (añade antes allí la URL del webhook que aparece en la sección Webhook URL).

Live Secret Key: tu clave secreta en vivo de KOMOJU. Empieza por sk_live_.

Live Webhook Secret Token: el token secreto del webhook en vivo. Se usa para verificar la firma de cada notificación.

Modo de prueba

KOMOJU usa la misma dirección de API para pagos de prueba y reales: la clave decide. Los pagos conservan el modo en el que se realizaron, así que los reembolsos y las consultas de estado de un pedido siempre usan la clave de ese modo.

Sandbox Mode: Enable test mode (use the test keys below, no real payments). Predeterminado: desactivado. Mientras está activado, el paso Confirm Order muestra Test mode encima de la descripción.

Sandbox Secret Key: tu clave secreta de prueba de KOMOJU. Empieza por sk_test_.

Sandbox Webhook Secret Token: el token secreto del webhook del modo de prueba.

Las claves y tokens guardados 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. Para eliminar un valor guardado, marca Clear the saved value on save debajo del campo y haz clic en Save.

URL del webhook

El webhook informa a tu tienda sobre los pagos, incluidos los pagos diferidos en konbini y por transferencia bancaria. En el panel de KOMOJU, en Settings > Webhooks, añade la URL que aparece en esta sección, tanto para el modo en vivo como para el de prueba. En OpenCart 3 tiene este formato: https://your-store/index.php?route=extension/payment/wcp_komoju_payment/webhook; en OpenCart 4: https://your-store/index.php?route=extension/wcp_komoju_payment/payment/wcp_komoju_payment.webhook. Se construye a partir de la dirección de la tienda de tu instalación de OpenCart. Copia la URL exactamente como aparece en los ajustes. Después, copia el token secreto de cada webhook en Live Webhook Secret Token o en Sandbox Webhook Secret Token.

Selecciona estos eventos (también aparecen en esta sección):

Los eventos de caducidad, cancelación y fallo solo modifican el pedido en relación con su pago actual, de modo que un pago de un intento anterior no puede cancelar un pedido que se está pagando de otra forma. Los webhooks sin una firma válida se rechazan. Los webhooks firmados con cualquiera de los dos tokens secretos se aceptan, pero solo para pagos del mismo modo. Sin el webhook, los pagos con tarjeta se siguen confirmando cuando el cliente vuelve a la tienda, pero los pagos en konbini y por transferencia bancaria nunca se confirman.

Pedidos

OpenCart crea el pedido en el paso Confirm Order sin estado (un pedido ausente). Solo recibe un estado después de que KOMOJU confirme el pago. Cada campo de abajo muestra tus estados de pedido de OpenCart.

Order Status After Payment: el pago fue capturado y se verificaron el importe y la moneda. Predeterminado: Procesando.

Awaiting KOMOJU Payment Status: el pago está autorizado: se emitió un comprobante de konbini o de transferencia bancaria, o el pago espera la captura en el panel de KOMOJU. Predeterminado: Pendiente de pago.

KOMOJU Payment On Hold Status: el importe o la moneda pagados no coinciden con el pedido, o el pago llegó después de que se cancelara el pedido. Una nota explica el motivo. Predeterminado: Pendiente de pago, porque OpenCart no tiene el estado En espera.

Cancelled Payment Status: el pago de un pedido en espera caducó o se canceló, por ejemplo cuando el comprobante de konbini no se pagó a tiempo. Predeterminado: Cancelado.

Failed Payment Status: el pago de un pedido en espera falló. Predeterminado: Fallido.

Refunded Status: se establece cuando el pago se reembolsa por completo, desde la página del pedido o desde el panel de KOMOJU. Predeterminado: Reembolsado.

Puedes crear tus propios estados, por ejemplo Pago de KOMOJU pendiente o En espera, en System > Localisation > Order Statuses y seleccionarlos aquí.

Avanzado

Invoice Prefix: el prefijo de los números de pedido enviados a KOMOJU. El número en KOMOJU es el prefijo, el número de pedido de OpenCart y un sufijo aleatorio corto, por ejemplo OC-123-A1B2C3. Si usas varias tiendas con la misma cuenta de KOMOJU, haz que el prefijo sea único para cada tienda. Predeterminado: OC-.

Enable Logging: escribe los eventos y las llamadas a la API de KOMOJU en komoju_p_debug.log.php, en la carpeta de registros de OpenCart (storage/logs). El archivo no se puede abrir desde la web. Las claves y los datos de los clientes no se registran. Los errores y las advertencias siempre se escriben. Predeterminado: desactivado.

Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.

Delete data on uninstall: si está activado, al desinstalar la extensión se eliminan los ajustes de la pasarela y el registro. Los pedidos y las transacciones y reembolsos de KOMOJU siempre se conservan, de modo que los pedidos antiguos se pueden confirmar y reembolsar después de reinstalar. Predeterminado: desactivado.

Importar / Exportar

Export: Download JSON guarda los ajustes en un archivo JSON. Las claves secretas y los tokens de webhook no se exportan.

Import: pega un JSON exportado previamente y haz clic en Import para restaurar los ajustes. Las claves secretas guardadas se conservan.

Finalización de compra

En el paso Payment Method, el cliente elige el método de pago (por defecto, KOMOJU Payment). En el paso Confirm Order, el cliente ve tu descripción y la nota You will be redirected to the KOMOJU payment page to complete the payment. OpenCart crea el pedido en este paso, todavía sin estado. Cuando el cliente hace clic en Confirm Order, la extensión crea una sesión de pago de KOMOJU por el total del pedido en la moneda del pedido y envía al cliente a la página de pago de KOMOJU. El correo electrónico, el nombre, las direcciones de pago y de envío, y los artículos del pedido se transfieren a KOMOJU. La página se muestra en japonés, inglés o coreano, según el idioma del cliente (en inglés para los demás idiomas). Allí el cliente elige un método de pago. Los métodos disponibles dependen de tu cuenta de KOMOJU y de la moneda del pedido.

En OpenCart 4, el cliente elige el método de pago con el botón Choose del bloque del método de pago, en la ventana Payment method options, y hace clic en Confirm Order al final de la página de finalización de compra. De forma predeterminada, OpenCart 4 no pide una dirección de pago; en ese caso, la extensión envía a KOMOJU la dirección de envío como dirección de pago.

Después de pagar, el cliente vuelve a tu tienda. La extensión lee la sesión de pago desde la API de KOMOJU con la clave del modo del pago. El pedido se marca como pagado solo cuando KOMOJU lo confirma: mediante el webhook firmado o mediante la lectura de la sesión cuando el cliente regresa. Después, el pedido recibe su estado de la forma estándar de OpenCart, con los correos electrónicos habituales del pedido y la actualización del stock, y el cliente ve la página de éxito del pedido de OpenCart con Your payment with KOMOJU has been received. Si en ese momento no se puede contactar con KOMOJU, o si el pago está confirmado pero aún no se ha aplicado, aparece una página Payment confirmation con We could not confirm the payment status with KOMOJU yet. If you completed the payment, your order will be updated automatically in a few minutes. y un botón Check again.

En los pagos en konbini y por transferencia bancaria, el cliente recibe un comprobante de pago. El pedido recibe Awaiting KOMOJU Payment Status, y la página de éxito indica al cliente que el pago está autorizado y que debe completarse según las instrucciones de KOMOJU (por ejemplo, en una tienda de conveniencia o mediante transferencia bancaria). El pedido pasa a Order Status After Payment cuando el cliente paga y KOMOJU envía el webhook. Si el comprobante caduca, el pedido pasa a Cancelled Payment Status.

Si el pago no se completó, el cliente vuelve a la finalización de compra con el mensaje The payment was not completed. You can try again or choose another payment method. Si el pedido ya estaba cancelado, el mensaje es The KOMOJU payment was not completed and the order has been cancelled. El carrito se conserva. En OpenCart 4 estos mensajes se muestran encima de la página de finalización de compra. Cada nuevo intento (OpenCart 3 crea un pedido nuevo cada vez que se muestra el paso Confirm Order; OpenCart 4 actualiza el pedido de la compra y paga el mismo pedido de nuevo) revisa las sesiones abiertas de KOMOJU de este pedido y de otros pedidos del mismo carrito: la sesión abierta de este pedido con un total sin cambios se reutiliza, las demás sesiones abiertas se cancelan en KOMOJU, y una sesión que se pagó entretanto confirma su pedido en lugar de crear un pago nuevo. Un cambio en el carrito, incluida una nueva cantidad, cuenta como un carrito nuevo que necesita su propio pago.

OpenCart 4 mantiene el pedido en la finalización de compra hasta que se muestra la página de éxito. Si ese pedido se ha cerrado mientras tanto (por ejemplo, caducó su comprobante de konbini, el pago falló o lo cancelaste), el cliente vuelve a la finalización de compra con Your previous order was cancelled or its payment failed. Please confirm the order again. Si el pedido ya está realizado y el carrito contiene ahora otros productos, el mensaje es Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. En ambos casos, el siguiente Confirm Order paga un nuevo pedido del carrito.

Si KOMOJU no puede iniciar el pago, el cliente permanece en el paso Confirm Order con un mensaje breve encima del botón, por ejemplo KOMOJU could not accept this payment: seguido del motivo, KOMOJU payments are temporarily unavailable. Please choose another payment method or contact us. o Payment error: Could not connect to KOMOJU. Please try again in a moment. El motivo técnico se escribe en el registro.

El webhook también funciona mientras la tienda está en modo de mantenimiento: OpenCart 3 deja pasar las solicitudes de las extensiones de pago, y en OpenCart 4 la extensión añade una acción de inicio que deja pasar el webhook y el regreso del cliente.

La extensión no tiene formulario de tarjeta en tu sitio, ni tarjetas guardadas, ni suscripciones. No restringe los métodos de pago: se eligen en la página de KOMOJU. No tiene una acción de captura manual: los pagos autorizados para captura manual deben capturarse en el panel de KOMOJU, y el pedido permanece en Awaiting KOMOJU Payment Status hasta entonces.

Pedidos y reembolsos

Estados del pedido

No status (missing order): el cliente fue enviado a KOMOJU y no ha pagado, o KOMOJU todavía no ha confirmado el pago. En Sales > Orders, estos pedidos solo se muestran con el filtro Order Status establecido en Missing Orders.

Order Status After Payment (default Processing): KOMOJU confirmó el pago. Una nota muestra el ID del pago de KOMOJU, el método de pago y cómo se confirmó (webhook o regreso a la tienda).

Awaiting KOMOJU Payment Status (default Pending): se emitió un comprobante de konbini o de transferencia bancaria y está pendiente de pago, o un pago espera la captura en el panel de KOMOJU.

KOMOJU Payment On Hold Status (default Pending): KOMOJU informó de un importe o una moneda distintos a los del pedido, o el pago se capturó después de que el pedido se hubiera cancelado. La nota lo explica. Revisa el pedido y complétalo o reembolsa el pago.

Cancelled Payment Status (default Canceled): el comprobante de pago caducó o el pago se canceló.

Failed Payment Status (default Failed): el pago de un pedido en espera falló.

Refunded Status (default Refunded): el pago fue reembolsado por completo, desde la página del pedido o desde el panel de KOMOJU.

Si se captura un segundo pago para un pedido que ya está pagado, o para otro pedido de un carrito que ya está pagado, el pedido no se modifica. Una nota te pide que lo reembolses desde el panel de KOMOJU si es un duplicado. Los pedidos reembolsados nunca se reabren.

Las notas son entradas del History del pedido que el cliente no ve.

Pestaña VibeFox KOMOJU Payment

En Sales > Orders, abre un pedido pagado con KOMOJU. En la parte inferior de la página del pedido, junto a History y Additional, la pestaña VibeFox KOMOJU Payment muestra el ID del pago de KOMOJU (con un enlace al pago en el panel de KOMOJU), una etiqueta Test mode para los pagos de prueba, el método de pago, la sesión, el número de pedido en KOMOJU, el estado, los importes Paid / refunded, el formulario de reembolso, el historial de reembolsos (desde OpenCart o desde el panel de KOMOJU) y las KOMOJU notes del pedido. La pestaña se muestra a los usuarios que tienen acceso a la extensión.

Reembolsos

En la pestaña VibeFox KOMOJU Payment introduce el Amount (el importe que aún no se ha reembolsado se rellena automáticamente), opcionalmente un Reason (optional), y haz clic en Refund via KOMOJU. Confirma la pregunta Refund this amount through KOMOJU? This cannot be undone. Se admiten reembolsos totales y parciales. Necesitas el permiso para modificar la extensión (se configura en System > Users > User Groups). Los reembolsos se limitan al importe que KOMOJU cobró realmente, así que tras una diferencia de importe puedes reembolsar hasta lo que pagó el cliente, no el total del pedido. El reembolso se envía con la clave del modo en el que se realizó el pago, por lo que esa clave secreta debe estar configurada. La extensión primero comprueba el pago en KOMOJU y rechaza los reembolsos por encima del importe que aún se puede reembolsar. Si KOMOJU no puede reembolsar un pago automáticamente (algunos métodos, por ejemplo konbini, necesitan los datos bancarios del cliente), se muestra el mensaje de error de KOMOJU y no se registra nada: gestiona esos reembolsos desde el panel de KOMOJU. Un reembolso solo se considera hecho cuando KOMOJU lo confirma. Un reembolso correcto se añade al historial de reembolsos y a las notas. Un reembolso total establece el pedido en Refunded Status sin devolver productos al stock, como un cambio manual de estado. Un reembolso parcial no cambia el estado. Los reembolsos están disponibles cuando KOMOJU ha capturado el pago.

En los pagos que KOMOJU convirtió a otra moneda (por ejemplo, konbini en JPY para un pedido en EUR), desde OpenCart solo es posible un reembolso total. Haz los reembolsos parciales desde el panel de KOMOJU.

Las devoluciones de productos en Sales > Returns no devuelven dinero a través de KOMOJU.

Los reembolsos hechos en el panel de KOMOJU llegan mediante webhook y se añaden al historial de reembolsos con una nota. Cuando se reembolsa el pago completo, el pedido pasa a Refunded Status. Los reembolsos parciales hechos en el panel para pagos convertidos a otra moneda solo se anotan en el pedido: registra manualmente en OpenCart el importe correspondiente.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox obtenida en vibefox.net. El bloque de licencia License — VibeFox KOMOJU Payment es el primer bloque de Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit, 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 verificar el estado de nuevo, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo aparecen la línea Product: opencart-payment-komoju y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios administradores con el permiso Modify para la extensión pueden cambiar la clave. Los textos del bloque siguen el idioma del panel de administración (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 de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede acceder al servidor de licencias, la extensión sigue funcionando con el último estado conocido.

Una clave funciona en un dominio: la dirección de la tienda de la configuración de OpenCart. Eliminar la clave de la tienda no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, KOMOJU no se muestra a los clientes en la finalización de compra. Si un pago se inicia de todos modos, el cliente ve This payment method is not available. Please choose another one. Un usuario administrador que haya iniciado sesión en el panel en el mismo navegador sigue viendo el método de pago en la tienda, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar la extensión antes de comprar una clave. En OpenCart 4 esta vista previa no está disponible: la tienda no ve el inicio de sesión del administrador, así que, sin una clave activa, el método de pago se oculta para todos. Después de abrir la página Edit una vez, aparece un recordatorio en el Dashboard del panel. Ciérralo con × para ocultarlo durante 7 días. Los pedidos existentes no se ven afectados: los pagos ya iniciados siguen confirmándose y los reembolsos funcionan.

Cuando una licencia caduca, la extensión sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente al abrir el Dashboard o la página Edit del panel: una vez al día durante los primeros 14 días después de introducir la clave, y después una vez por semana. No hace falta ningún cron job. Desinstalar la extensión siempre elimina la clave de licencia y el estado de la licencia.

Solución de problemas

KOMOJU 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 una clave secreta: Sandbox Secret Key en modo de prueba, Live Secret Key en modo en vivo. El cliente debe pagar en una moneda admitida por KOMOJU. La página de ajustes muestra una advertencia cuando falta algo. Comprueba también que la dirección de pago esté en la Geo Zone seleccionada y que el pedido alcance el Total configurado.

El pago se realizó, pero el pedido sigue sin estado: el webhook no funciona. En el panel de KOMOJU, comprueba que el webhook existe para el modo que usas, que su URL es exactamente la que aparece en la sección Webhook URL y que los eventos están seleccionados. Comprueba que su token secreto está en el campo correspondiente (Live Webhook Secret Token o Sandbox Webhook Secret Token), y revisa el campo Log de la página de la extensión. Los pagos con tarjeta también se confirman cuando el cliente vuelve a tu tienda, pero los pagos en konbini y por transferencia bancaria solo se confirman mediante el webhook.

El webhook responde Failed to verify KOMOJU webhook signature.: falta el token secreto o pertenece a otro webhook. KOMOJU reintenta la notificación.

El webhook responde Mode mismatch, ignored.: el webhook se firmó con el token secreto del otro modo distinto al del pago. Usa webhooks y tokens separados para el modo en vivo y para el de prueba, y comprueba que no estén intercambiados.

El webhook responde Order not found.: el pago no pertenece a un pedido de esta tienda, por ejemplo porque lo hizo otra tienda con la misma cuenta de KOMOJU. El evento se ignora.

El webhook responde Order is busy, retry later. o Temporary error, retry later.: otra solicitud estaba actualizando el pedido, o el pago no pudo procesarse en ese momento. KOMOJU reintenta la notificación. El motivo está en el registro.

La URL del webhook muestra un error en el navegador: es normal. La URL solo acepta solicitudes firmadas de KOMOJU.

El pedido está en un estado en espera o retenido: lee las KOMOJU notes en la pestaña del pedido. Hay un comprobante pendiente de pago, un pago que espera la captura en el panel de KOMOJU, el importe o la moneda no coincidían, o el pago llegó después de que se cancelara el pedido.

No hay formulario de reembolso en la pestaña: la pestaña indica el motivo: KOMOJU todavía no ha capturado el pago, está reembolsado por completo, tu grupo de usuarios no tiene permiso para modificar la extensión, o la clave secreta del modo del pago no está configurada.

El reembolso falla: lee el mensaje. Puede que falte la clave secreta del modo en el que se realizó el pago, que el pago no se pueda reembolsar automáticamente (reembólsalo desde el panel de KOMOJU), que KOMOJU no reconozca el pago con la clave configurada, o que solo sea posible un reembolso total en un pago convertido.

Para desarrolladores: la extensión dispara los eventos de OpenCart komoju_p_supported_currencies (para cambiar la lista de monedas) y komoju_p_session_params (para cambiar la sesión de pago, por ejemplo los métodos de pago).

Desinstalación

Ve a Extensions > Extensions, elige el tipo Payments y haz clic en Uninstall (el botón rojo −) junto a VibeFox KOMOJU Payment. La clave de licencia y el estado de la licencia de esta extensión siempre se eliminan. OpenCart siempre elimina sus propios ajustes de la extensión: Enable/Disable, Sort Order, Geo Zone, Total y los estados de pedido de la sección Orders, que vuelven a sus valores predeterminados al reinstalar. El evento de OpenCart de la extensión también se elimina (en OpenCart 4, también sus eventos y su acción de inicio, que deja pasar el webhook y el regreso del cliente en modo de mantenimiento). Si Delete data on uninstall está activado, se eliminan los demás ajustes de la pasarela (título, descripción, claves, tokens de webhook, modo de prueba, prefijo de factura, registro) y el registro. Si está desactivado, se conservan para una reinstalación posterior. Las transacciones y reembolsos de KOMOJU siempre se conservan, de modo que los pedidos antiguos se pueden confirmar y reembolsar después de reinstalar. Los pedidos existentes conservan sus notas de pago.

En OpenCart 4, para eliminar también los archivos de la extensión, ve a Extensions > Installer después de la desinstalación y haz clic en Uninstall (el botón naranja −) junto a VibeFox KOMOJU Payment en la lista de extensiones instaladas; después, haz clic en Delete (el botón rojo de papelera) para eliminar el paquete subido.

KOMOJU es una marca comercial de su titular. Esta extensión no está afiliada ni respaldada por KOMOJU.