VibeFox Viva Wallet for OpenCart — Ayuda

Requisitos

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

PHP: 8.0 o posterior.

Cuenta de Viva: una cuenta de comerciante de Viva. Puedes usar una cuenta de demo (demo.vivapayments.com) para las pruebas y una cuenta real (www.vivapayments.com) para los pagos reales. Cada cuenta tiene sus propias credenciales. Para los pagos necesitas las credenciales de Smart Checkout (Client ID y Client Secret) y el Source Code de una fuente de pago. El Merchant ID y la API Key son opcionales: solo se usan para responder a la verificación de la URL del webhook de Viva.

Moneda: EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK o CHF. La moneda que el cliente ha seleccionado en la tienda debe ser una de ellas; en otras monedas el método de pago se oculta en la compra.

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_viva_gateway-oc3-(version).ocmod.zip y el paquete de OpenCart 4 wcp_viva_gateway.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_viva_gateway-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 y elige el tipo Payments. Busca VibeFox Viva Wallet Gateway y haz clic en Install (el botón verde +). Tu usuario de administración necesita el permiso para modificar la lista de extensiones de pago.

3. Haz clic en Edit (el botón del lápiz) para abrir la página de ajustes. 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 (véase License key).

4. Introduce las credenciales de la cuenta de demo y/o de la cuenta real de Viva, y configura la fuente de pago y el webhook en tu cuenta de Viva (véase Configuration).

5. Activa Enable/Disable y haz clic en Save. Haz un pago de demo con una tarjeta de demo de Viva mientras Test Mode está activado, y después desactiva Test Mode para pasar a producción.

OpenCart 4

1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo wcp_viva_gateway.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 de 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 Viva Wallet Gateway, haz clic en Install (el botón verde +) y después en Edit (el botón del lápiz).

4. Introduce la clave de licencia, las credenciales de Viva, la fuente de pago y el webhook como en los pasos 3 a 5 de OpenCart 3. La página de ajustes y sus campos son los mismos en ambas versiones. Solo cambian las direcciones de la cuenta de Viva (véase Configuration).

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

Configuración

Todos los ajustes están en la página de la extensión: Extensions > Extensions > Payments > VibeFox Viva Wallet Gateway > Edit. Las secciones aparecen a la izquierda; el botón Save situado bajo la lista guarda toda la página. Encima de los ajustes, la página te avisa si el modo actual no tiene Client ID, Client Secret o Source Code (Viva Wallet is hidden at checkout until the Demo Client ID, Client Secret and Source Code are entered., o Live en modo real) y si la moneda predeterminada de la tienda no es compatible. Mientras el modo de prueba está activado, muestra Test mode is on: payments go to the Viva demo environment. Sin el permiso para modificar la extensión, la página muestra los ajustes pero no puede guardarlos.

Al guardar, Title no puede estar vacío y debe tener como máximo 128 caracteres (Enter a title for the payment method (at most 128 characters).), Sort Order debe ser un número entero (Sort Order must be a whole number.), Total debe ser un número igual o mayor que 0 (Total: enter a number, 0 or greater.), y la zona geográfica y los estados de pedido seleccionados deben existir; si no, no se guarda nada y la página muestra el error. Al guardar los ajustes se eliminan los tokens de acceso de Viva en caché, de modo que las nuevas credenciales se usan de inmediato.

Viva Wallet

Enable/Disable: Enable Viva Wallet payment gateway activa o desactiva el método de pago. Predeterminado: off.

Title: el nombre del método de pago que ven los clientes en la compra. También es el nombre del método de pago guardado en el pedido. Predeterminado: Viva Wallet. Obligatorio, como máximo 128 caracteres.

Description: el texto que se muestra al cliente en el paso Confirm Order, encima del botón de confirmación. Predeterminado: Pay securely with Viva Wallet — cards, Apple Pay, Google Pay and more.

Test Mode: usa el entorno de demo de Viva (demo.vivapayments.com). Los nuevos pagos y las llamadas a la API usan las credenciales de la cuenta de demo. No se cobra dinero real, y en el paso Confirm Order los clientes ven (Test mode: use Viva demo cards, no real money is charged.) Predeterminado: on. Desactívalo para aceptar pagos reales con la cuenta real. Los pagos ya hechos siguen verificándose y reembolsándose en el entorno en el que se hicieron.

Sort Order: la posición de Viva Wallet entre los métodos de pago de la compra. Déjalo vacío o introduce un número entero; se permiten los números negativos.

Geo Zone: ofrece Viva Wallet 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 debe alcanzar un pedido para que se ofrezca Viva Wallet: un número igual o mayor que 0. Déjalo vacío para ofrecerlo con cualquier total.

Demo account (test mode) and Live account

Ambas secciones tienen los mismos campos: un juego para la cuenta de demo y otro para la cuenta real. En tu cuenta de Viva abre Settings > API Access y copia las credenciales de Smart Checkout (Client ID, Client Secret), el Merchant ID y la API Key. El Source Code está en Sales > Online payments > Websites / apps.

Client ID (Demo) / Client ID (Live): el Client ID OAuth 2.0 de Smart Checkout de la cuenta. Necesario para los pagos.

Client Secret (Demo) / Client Secret (Live): el Client Secret OAuth 2.0 de Smart Checkout de la cuenta. Necesario para los pagos.

Source Code (Demo) / Source Code (Live): el código de 4 dígitos de la fuente de pago de la cuenta. Sus URL de éxito y de fallo deben apuntar a esta tienda (véase más abajo). Necesario para los pagos.

Merchant ID (Demo) / Merchant ID (Live): opcional. Se usa solo para responder a la verificación de la URL del webhook de Viva.

API Key (Demo) / API Key (Live): opcional. Se usa solo para responder a la verificación de la URL del webhook de Viva.

Los Client Secret y las API Key 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.

Clear saved secrets: al final de la sección Live account. Marca un secreto guardado y haz clic en Save para eliminarlo. Un campo vacío mantiene el valor guardado.

Return URLs and webhook

Addresses for the Viva account: este campo muestra las tres direcciones de tu tienda que debes introducir en la cuenta de Viva. Se construyen a partir de la dirección de la tienda de tu instalación de OpenCart y tienen este aspecto en OpenCart 3: https://your-store/index.php?route=extension/payment/wcp_viva_gateway/success&, https://your-store/index.php?route=extension/payment/wcp_viva_gateway/fail& y https://your-store/index.php?route=extension/payment/wcp_viva_gateway/webhook, y en OpenCart 4 así: https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.success&, https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.fail& y https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.webhook. Cópialas exactamente como las muestran los ajustes. El & al final de las direcciones de éxito y de fallo es necesario: Viva añade la transacción a la dirección, y sin él OpenCart responde con una página no encontrada.

Payment source: en Sales > Online payments > Websites / apps crea una fuente de pago para el dominio de tu tienda, en cada cuenta que uses. Como Success URL y Failure URL introduce las rutas que siguen al dominio en las direcciones de éxito y de fallo.

Webhook: en Settings > API Access > Webhooks añade la dirección del webhook para estos eventos:

Viva comprueba la URL antes de guardarla. La extensión responde con la clave de verificación de tu cuenta: la obtiene con el Merchant ID y la API Key del modo actual, o usa la clave que introduzcas abajo. Los webhooks confirman los pagos aunque el cliente cierre el navegador. Los webhooks de Viva no están firmados, así que la extensión nunca se fía del webhook por sí solo: cada pago se verifica con la API de Viva antes de que el pedido reciba su estado. Sin el webhook, un pedido solo recibe su estado cuando el cliente vuelve a la tienda después de pagar.

Webhook Verification Key: opcional. Déjalo vacío para obtener la clave automáticamente con el Merchant ID y la API Key del modo actual, o pega aquí la clave de verificación de tu cuenta de Viva.

Order statuses

OpenCart crea el pedido en el paso Confirm Order sin estado (un pedido perdido). El pedido recibe un estado solo después de que el pago de Viva se haya verificado. Los campos de estado muestran tus estados de pedido de OpenCart.

Order Status After Payment: el estado que recibe un pedido pagado. Se aplica de una vez, con un único cambio de estado.

Processing Status: el estado de un pedido pagado para Default y Processing. Predeterminado: Processing.

Complete Status: el estado de un pedido pagado para Completed. Predeterminado: Complete.

On Hold Status: el estado de un pedido pagado para On Hold, y de un pedido cuyo pago de Viva no coincide con el importe o la moneda del pedido (retenido para revisión, no pagado; la nota indica el motivo). Predeterminado: Pending, porque OpenCart no tiene el estado On hold. Puedes crear tu propio estado en System > Localisation > Order Statuses y seleccionarlo aquí.

Cancelled Order Status: un pago de Viva recibido para un pedido en este estado nunca lo reabre; una nota te pide que restaures el pedido o reembolses el pago. La extensión nunca asigna este estado. Predeterminado: Canceled.

Refunded Status: se asigna cuando el pago se reembolsa por completo desde la pestaña del pedido. Un pago posterior tampoco reabre un pedido así. Predeterminado: Refunded.

Advanced Settings

Brand Color: un código de color HEX de 6 dígitos para la página de pago de Viva, por ejemplo 0000ff. Se elimina un # inicial. Déjalo vacío para usar el color predeterminado. Cualquier otro valor no se guarda: el resto de los ajustes sí se guardan, y la página muestra Brand Color must be a 6-digit HEX code (e.g. 0000ff). The previous value was kept.

Debug Logging: escribe las peticiones a la API en viva_wp_debug.log.php, en la carpeta de registros de OpenCart (storage/logs, en OpenCart 4 system/storage/logs). El archivo no se puede abrir desde la web. Las claves, los tokens y los datos de los clientes no se registran. Los errores siempre se registran, aunque esta opción esté desactivada. Predeterminado: off.

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 sus datos de pago (intentos de pago de Viva, reembolsos) nunca se eliminan. Predeterminado: off.

Import / Export

Export: Download JSON guarda los ajustes en un archivo JSON. Los secretos no se exportan.

Import: pega un JSON exportado previamente y haz clic en Import para restaurar los ajustes. Los secretos guardados se mantienen.

Compra

En el paso Payment Method el cliente elige el método de pago (por defecto Viva Wallet). En el paso Confirm Order el cliente ve tu descripción y la nota You will be redirected to the secure Viva Wallet payment page (cards, Apple Pay, Google Pay and more). OpenCart crea el pedido en este paso, todavía sin estado. En OpenCart 4 el cliente elige el método de pago con el botón Choose del bloque de método de pago, en la ventana Payment method options, y hace clic en Confirm Order al final de la página de compra. Cuando el cliente hace clic en Confirm Order, la extensión crea un pedido de pago de Viva por el importe total del pedido en su moneda y envía al cliente a la página de Smart Checkout de Viva, con tu Brand Color si has configurado uno. Allí el cliente paga con uno de los métodos activados en tu cuenta de Viva. El correo electrónico, el nombre, el teléfono, el país y el idioma de la tienda del cliente se pasan a Viva. El pago aparece en Viva como OpenCart # y el número de pedido, y se describe al cliente como Order, el número de pedido, at y el nombre de tu tienda. El pedido de pago de Viva caduca a los 30 minutos.

Después de pagar, el cliente vuelve a tu tienda. El pedido se marca como pagado solo cuando Viva lo confirma: la extensión vuelve a leer la transacción desde la API de Viva, tanto al volver el cliente como con el webhook. Después el pedido recibe su estado de la forma estándar de OpenCart, con los correos habituales del pedido y la actualización del stock, y el cliente ve la página de pedido completado de OpenCart. Si el pago todavía no está confirmado, una página Payment confirmation muestra We are waiting for Viva Wallet to confirm your payment. You will receive an e-mail as soon as it is confirmed. con los botones Check again y Back to checkout. El carrito se conserva hasta que se confirme el pago; el webhook asigna el estado del pedido en cuanto Viva lo confirma. En OpenCart 4, cuando el cliente vuelve de la página de Viva, una página intermedia breve vuelve a abrir la dirección de retorno de tu tienda, de modo que el carrito y la sesión del cliente se conservan.

Si el pago falla o el cliente cancela en la página de Viva, el pedido queda sin estado y el carrito se conserva. El cliente vuelve a la compra con The Viva Wallet payment was not completed. Please try again or choose another payment method. o The Viva Wallet payment was cancelled. You can try again or choose another payment method. y puede volver a pagar. Cada nuevo intento crea un nuevo pedido de pago de Viva. Un carrito solo se paga una vez: si el carrito ya está pagado por otro pedido de la misma compra, el cliente pasa directamente a la página de éxito. En OpenCart 4 estos mensajes se muestran encima de la página de compra. OpenCart 3 crea un pedido nuevo cada vez que se muestra el paso Confirm Order, OpenCart 4 actualiza el pedido de la compra. Un cambio del carrito, incluida una nueva cantidad, cuenta como un carrito nuevo que necesita su propio pago.

OpenCart 4 mantiene el pedido en la compra hasta que se muestra la página de éxito. Tras un pago fallido o cancelado, el cliente vuelve a pagar el mismo pedido con un nuevo pedido de pago de Viva. Si ese pedido se cerró entretanto (por ejemplo, lo cancelaste), o se pagó para un carrito que ha cambiado desde entonces, el cliente vuelve a la compra con This order can no longer be paid. Please confirm your order again., y el siguiente Confirm Order paga un pedido nuevo.

Si Viva no puede iniciar el pago, el cliente se queda en el paso Confirm Order con un mensaje encima del botón: Viva Wallet payments are not available at the moment. Please choose another payment method or contact us. (credenciales ausentes o incorrectas) o We could not connect to Viva Wallet. Please try again in a moment or choose another payment method. El motivo técnico se escribe en el registro.

Las páginas de retorno muestran la página de pedido completado solo al cliente que ha pagado. Cualquier otra persona que abra la dirección de retorno es enviada al historial de pedidos o a la compra, sin detalles del pedido.

El webhook también funciona mientras la tienda está en modo de mantenimiento, porque OpenCart deja pasar las peticiones de las extensiones de pago. En OpenCart 4, una acción de inicio de la extensión deja pasar el webhook y las direcciones de éxito y de fallo.

La extensión solo acepta pagos únicos, cobrados de inmediato en la página de Viva. No incluye preautorización y captura, pagos a plazos, tarjetas guardadas, suscripciones, Viva Native Checkout (campos de tarjeta en tu propia página) ni terminales TPV. Cuando el cliente empieza un nuevo intento, el pedido de pago de Viva anterior sin pagar no se cancela; Viva lo caduca a los 30 minutos.

Pedidos y reembolsos

Order statuses

Sin estado (pedido perdido): el cliente fue enviado a Viva y no ha pagado, el pago falló o se canceló, o Viva todavía no ha finalizado el pago. El cliente puede volver a pagar. En Sales > Orders estos pedidos solo se muestran con el filtro Order Status en Missing Orders. En OpenCart 4.1 ese pedido también puede tener el estado Voided, que OpenCart establece cuando se vuelve a mostrar el paso de confirmación; la extensión lo cuenta como un pedido sin estado.

Order Status After Payment (predeterminado Processing): el pago fue confirmado. Una nota muestra el importe, la transacción, el código del pedido de Viva, el entorno (demo o real) y cómo se confirmó (webhook o retorno del cliente).

On Hold Status tras una discrepancia (predeterminado Pending): Viva informó de un importe o una moneda distintos del total del pedido. El pedido no se marca como pagado, y la nota Viva Wallet payment held for review indica el motivo. Compara el pago en el panel de Viva con el pedido y gestiónalo manualmente: envíalo o reembólsalo. Si más tarde llega un pago coincidente para el mismo pedido, el pedido pasa al estado de pagado.

Un pago que llega para un pedido en Cancelled Order Status o Refunded Status no cambia el estado del pedido; una nota te pide que restaures el pedido o reembolses el pago en el panel de Viva. Si llega 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 en el pedido pagado te pide que reembolses el duplicado en el panel de Viva.

Las notas son entradas del History del pedido que el cliente no ve. Los cambios de estado no avisan al cliente por sí solos; OpenCart envía su correo habitual del pedido cuando un pedido pagado recibe su estado por primera vez.

VibeFox Viva Wallet Gateway tab

En Sales > Orders abre un pedido pagado con Viva Wallet. En la parte inferior de la página del pedido, junto a History y Additional, la pestaña VibeFox Viva Wallet Gateway muestra el Viva order code, el Transaction ID con una etiqueta Demo en los pagos de demo, el Environment / Source Code, el Viva status, los importes Paid / refunded, el formulario de reembolso, el historial de reembolsos, los Viva payment attempts del pedido (si hubo más de uno) y las Viva Wallet notes del pedido. La pestaña se muestra a los usuarios que tienen acceso a la extensión.

Refunds

En la pestaña VibeFox Viva Wallet Gateway introduce el Amount (se rellena el importe que aún no se ha reembolsado), opcionalmente un Reason (optional), y haz clic en Refund via Viva Wallet. Confirma la pregunta Refund this amount via Viva Wallet? This cannot be undone. Se admiten reembolsos totales y parciales para pedidos con un pago de Viva confirmado. Necesitas el permiso para modificar la extensión (se configura en System > Users > User Groups). Puedes reembolsar hasta el importe que Viva cobró por el pago, aunque el pedido se haya editado después. El reembolso se envía a la cuenta en la que se hizo el pago (demo o real), en la moneda del pago, por lo que deben estar introducidos el Client ID y el Client Secret de esa cuenta. Si Viva no acepta el reembolso, la pestaña muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade al historial de reembolsos y a las notas con la transacción de reembolso de Viva. Un reembolso total asigna el pedido a Refunded Status sin avisar al cliente y sin devolver productos al stock, como un cambio manual de estado. Un reembolso parcial no cambia el estado. Un pedido retenido para revisión tras una discrepancia no tiene un pago confirmado y no se puede reembolsar desde la pestaña.

Las devoluciones de productos en Sales > Returns no devuelven dinero a través de Viva. Los reembolsos hechos en el panel de Viva no se importan. Actualiza el pedido manualmente si es necesario.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Viva Wallet Gateway es el primero de la página Extensions > Extensions > Payments > VibeFox Viva Wallet Gateway > Edit, por 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: opencart-payment-viva 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 es aceptada, 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 que cambie 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, 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. Quitar la clave de la tienda no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, Viva Wallet no se muestra a los clientes en la compra. Si se inicia un pago 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 de administración 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. Tras abrir una vez la página Edit, aparece un recordatorio en el Dashboard del panel de administración. Ciérralo con × para ocultarlo durante 7 días. Los pedidos existentes no se ven afectados: los pagos ya iniciados se siguen confirmando mediante el webhook de Viva y el retorno a la tienda, y los reembolsos funcionan.

Cuando una licencia caduca, la extensión sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente cuando abres el Dashboard del panel de administración o la página Edit: 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. Al desinstalar la extensión siempre se eliminan la clave de licencia y el estado de la licencia.

Resolución de problemas

Viva Wallet no aparece en la compra: comprueba que la licencia está activa, que Enable/Disable está activado y que el modo actual tiene su Client ID, su Client Secret y su Source Code (los campos Demo en modo de prueba, los campos Live en modo real). La moneda seleccionada en la tienda debe ser una de EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK o CHF. Comprueba también que la dirección de pago está en la Geo Zone seleccionada y que el pedido alcanza el Total configurado. La página de ajustes muestra una advertencia cuando faltan credenciales.

El pago se realizó, pero el pedido se queda sin estado: el webhook no funciona. En Viva comprueba que el webhook existe en la cuenta que usas (demo o real), que su URL es exactamente la que aparece en los ajustes y que Transaction Payment Created está seleccionado. Comprueba que el Client ID y el Client Secret de la cuenta de ese pago siguen introducidos: la extensión los necesita para verificar el pago. Activa Debug Logging y revisa el campo Log. El pedido también recibe su estado cuando el cliente vuelve a la tienda después de pagar.

El cliente vuelve a una página no encontrada: la Success URL o la Failure URL de la fuente de pago no termina en &. Copia las rutas exactamente como las muestran los ajustes.

Viva no puede verificar la URL del webhook: introduce el Merchant ID y la API Key del modo actual (o la propia clave de verificación en Webhook Verification Key), guarda y vuelve a verificar en Viva. Para verificar el webhook de la otra cuenta, cambia primero Test Mode o introduce la clave de esa cuenta.

El webhook responde con un error: Viva muestra la respuesta de tu tienda y reintenta los webhooks fallidos. verification_failed (HTTP 500) significa que no se pudo contactar con la API de Viva para verificar el pago, o que no se pudo asignar el estado del pedido. busy (HTTP 503) significa que otra petición estaba procesando el pedido en ese mismo momento. transaction_not_found (HTTP 404) significa que la transacción no existe en la cuenta de ese pago, por ejemplo por credenciales incorrectas. Los eventos de pagos de otras tiendas de la misma cuenta de Viva reciben la respuesta ignored.

El cliente ve un error después de Confirm Order: revisa el campo Log de la página de la extensión. Un Client ID o un Client Secret incorrectos dan el mensaje de que los pagos con Viva Wallet no están disponibles. Si no se puede contactar con Viva o Viva rechaza el pedido de pago, por ejemplo porque el Source Code pertenece a otra cuenta, el cliente recibe el mensaje de que la tienda no pudo conectar con Viva Wallet. This payment method is not available. significa que la sesión de compra ya no coincide con el pedido: el cliente debe recargar la compra.

El cliente vuelve y ve We could not find your order. If you were charged, please contact us.: el código de pedido de Viva de la dirección de retorno no es un pago de esta tienda, por ejemplo porque la fuente de pago de otra tienda apunta aquí. Revisa la Success URL y la Failure URL de la fuente de pago.

El pedido está en el estado de revisión tras el pago: lee las notas de la pestaña VibeFox Viva Wallet Gateway (véase Order statuses), y después envía el pedido o reembolsa el pago.

No hay formulario de reembolso en la pestaña: la pestaña indica el motivo: el pedido no tiene un pago de Viva confirmado (Transaction ID not found. Cannot process refund.), está reembolsado por completo, faltan las credenciales de la cuenta del pago, o tu grupo de usuarios no tiene permiso para modificar la extensión.

El reembolso falla con This payment was made in the Viva demo (or live) environment: el Client ID y el Client Secret de la cuenta en la que se hizo el pago no están introducidos. Introdúcelos e inténtalo de nuevo. Otros errores de reembolso muestran el mensaje de Viva.

Desinstalación

Ve a Extensions > Extensions, elige el tipo Payments y haz clic en Uninstall (el botón rojo −) junto a VibeFox Viva Wallet Gateway. Siempre se eliminan la clave de licencia y el estado de la licencia de esta extensión. OpenCart siempre elimina sus propios ajustes de la extensión: Enable/Disable, Sort Order, Geo Zone, Total y los campos de estado de la sección Order statuses, que vuelven a sus valores predeterminados en una reinstalación. Las claves de acceso de Viva en caché y las claves de los webhooks siempre se eliminan. En OpenCart 4 se elimina también siempre el evento de la extensión y su acción de inicio, que deja pasar en modo de mantenimiento el webhook y las direcciones de retorno. Si Delete Data on Uninstall está activado, se eliminan los demás ajustes de la pasarela (título, descripción, modo de prueba, credenciales, estado del pedido tras el pago, color de marca, registro) y el registro. Si está desactivado, se conservan para una reinstalación posterior. Los intentos de pago y los reembolsos de Viva siempre se conservan, de modo que los pedidos pagados antes se pueden reembolsar después de una reinstalación. 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 desinstalar y haz clic en Uninstall (el botón naranja −) junto a VibeFox Viva Wallet Gateway en la lista de extensiones instaladas, y después en Delete (el botón rojo de la papelera) para eliminar el paquete subido.

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