VibeFox Tranzila for OpenCart — Ayuda

Requisitos

OpenCart: 3.0.x (probado con la versión 3.0.5.0) o 4.0.2 y posteriores (probado con la versión 4.1.0.3).

PHP: 8.0 o posterior.

Moneda: ILS, USD, EUR o GBP. Para otras monedas de los clientes el método de pago se oculta en la finalización de compra.

Terminal de Tranzila: necesitas el nombre del terminal. La contraseña del terminal (TranzilaPW) es necesaria para el handshake y para los reembolsos desde la página del pedido. Algunos terminales también necesitan una contraseña de crédito independiente (CreditPass) para los reembolsos. Tranzila te proporciona el nombre del terminal y las contraseñas: consulta la configuración de tu terminal o pide ayuda al soporte de Tranzila. Para las pruebas, Tranzila te da un terminal de prueba independiente; introduce su nombre como nombre del terminal.

IP real del visitante: las notificaciones de pago se comprueban con la dirección IP del servidor de Tranzila. Si tu tienda está detrás de un proxy o de una CDN como Cloudflare, el servidor web debe pasar a PHP la IP real del visitante (REMOTE_ADDR).

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_tranzila_payment_gateway-oc3-(version).ocmod.zip y el paquete de OpenCart 4 wcp_tranzila_payment_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_tranzila_payment_gateway-oc3-(version).ocmod.zip. La extensión no tiene modificaciones OCMOD, por lo que Extensions > Modifications no necesita actualizarse. En lugar del instalador, también puedes copiar el contenido de la carpeta upload de este paquete a la carpeta raíz de tu tienda.

2. Ve a Extensions > Extensions y elige el tipo Payments. Busca VibeFox Tranzila Payment Gateway 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 del 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. Introduce el Terminal name (supplier) y la Terminal password (TranzilaPW) si usas el handshake o los reembolsos.

5. Mantén Notifications activado y revisa Trusted IP: debe contener las direcciones IP desde las que Tranzila envía las notificaciones. Confirma la lista con el soporte de Tranzila. La URL de notificación se envía con cada pago, así que no tienes que copiarla en ningún sitio.

6. Recomendado: activa el handshake en el terminal de Tranzila, permite allí la IP de tu servidor y, después, activa Handshake en la extensión.

7. Activa Enable/Disable, haz clic en Save y prueba un pago con el terminal de prueba de Tranzila.

OpenCart 4

1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo wcp_tranzila_payment_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 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 Tranzila Payment 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 y los ajustes como en los pasos 3 a 7 de OpenCart 3. La página de ajustes y sus campos son los mismos en ambas versiones.

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

Configuración

Todos los ajustes están en la página de la extensión: Extensions > Extensions > Payments > VibeFox Tranzila Payment Gateway > Edit. Las secciones aparecen a la izquierda; el botón Save situado debajo de la lista guarda la página completa. Encima de los ajustes, la página te avisa cuando el nombre del terminal está vacío (en ese caso el método de pago se oculta en la finalización de compra), cuando las notificaciones están desactivadas o Trusted IP está vacío (los pedidos pagados se retienen entonces para revisión manual), cuando el handshake está activado sin contraseña del terminal (no se puede abrir la página de pago) y cuando la moneda predeterminada de la tienda no es compatible. Sin el derecho a modificar la extensión, la página muestra los ajustes pero no puede guardarlos.

Al guardar, la página nunca rechaza todo de golpe. Un Title vacío o de más de 128 caracteres, un nombre de terminal no válido, una entrada no válida en Trusted IP, un campo numérico que no es un entero, o un Sort Order, Total, Geo Zone o estado de pedido no válido, no se guarda: la página muestra el mensaje en un bloque rojo encima de los ajustes, y el campo vuelve a mostrar el valor anterior. Un número fuera del rango permitido se guarda como el valor permitido más cercano, y la página te lo indica; por ejemplo, que 5000 está fuera de 400–1500 y se guardó como 1500. Los demás campos sí se guardan.

Tranzila

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

Title: el nombre del método de pago que ve el cliente en la finalización de compra y el título de la página de pago. También es el nombre del método de pago guardado en el pedido, por lo que es obligatorio y puede tener como máximo 128 caracteres. Predeterminado: Credit Card (Tranzila).

Description: el texto que ve el cliente en el paso Confirm Order, encima del botón de confirmar. Predeterminado: Pay securely with your credit card on the Tranzila payment page.

Sort Order: la posición de Tranzila entre los métodos de pago de la finalización de compra. Déjalo vacío o introduce un número entero (se permiten valores negativos).

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

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

Terminal

Terminal name (supplier): el nombre de tu terminal de Tranzila, por ejemplo myshop. Solo letras, dígitos, «-» y «_». Hasta que lo introduzcas, el método de pago no se muestra en la finalización de compra. Para las pruebas, introduce el nombre de tu terminal de prueba de Tranzila.

Terminal password (TranzilaPW): la contraseña de API del terminal. Es necesaria para el handshake y para los reembolsos desde la página del pedido.

Refund password (CreditPass): solo si tu terminal exige una contraseña independiente para las transacciones de crédito (reembolso). Déjalo vacío en caso contrario.

Las contraseñas guardadas nunca se vuelven a mostrar. El campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo para cambiarlo. Para eliminar una contraseña guardada, marca Clear saved password on save debajo del campo y haz clic en Save.

Página de pago

Payment page version: la página de Tranzila que se muestra en el iframe.

Payment page language: el idioma de la página de Tranzila: Site language, hebreo, inglés, ruso, español, alemán, francés o japonés. Predeterminado: Hebrew. Site language usa el idioma de la tienda que tenga el cliente cuando es uno de estos; en otro caso, inglés.

iFrame width (px): de 300 a 1200. Predeterminado: 600. En pantallas pequeñas el marco nunca es más ancho que la página.

iFrame height (px): de 400 a 1500. Predeterminado: 650.

Max installments: el número máximo de cuotas (tashlumim) que el cliente puede elegir en la página de pago, hasta 36. 0 o 1 significa sin cuotas. Predeterminado: 0. El terminal debe estar autorizado para procesar cuotas.

Handshake: bloquea el importe con un token de handshake (recomendado). Antes de abrir la página de pago, la tienda pide a Tranzila un token de un solo uso ligado al importe, de modo que el importe no puede modificarse en el navegador. Requiere la contraseña del terminal, que el handshake esté activado en el terminal de Tranzila y que la dirección IP de tu servidor esté permitida allí. Predeterminado: off.

Confirmación de pago

Las notificaciones de Tranzila no están firmadas. Un pedido solo recibe el estado de pagado cuando la notificación procede de una Trusted IP y su token de la página de pago, pedido, terminal, importe y moneda coinciden con los de la página de pago. Con el handshake, el token también debe coincidir. El retorno del cliente desde la página de pago nunca marca un pedido como pagado.

Notifications: confirma los pagos automáticamente con las notificaciones de Tranzila (URL de notificación). Predeterminado: on. Cuando las notificaciones están desactivadas, un cliente que vuelve de una página de pago correcta pone el pedido en On hold status, y tú confirmas el pago manualmente después de revisar el terminal de Tranzila.

Notification URL: se muestra a título informativo. En OpenCart 3 tiene este aspecto: https://your-store/index.php?route=extension/payment/wcp_tranzila_payment_gateway/notify; en OpenCart 4, https://your-store/index.php?route=extension/wcp_tranzila_payment_gateway/payment/wcp_tranzila_payment_gateway.notify. Se construye a partir de la dirección de la tienda de tu instalación de OpenCart. La URL se envía a Tranzila con cada pago, así que no tienes que introducirla en el terminal de Tranzila. También funciona cuando la tienda está en modo mantenimiento (en OpenCart 4, una acción de inicio de la extensión deja pasar la notificación y el retorno del cliente).

Trusted IP: las direcciones IP o los rangos CIDR de los servidores de Tranzila que envían las notificaciones, separados por comas. Predeterminado: 80.244.170.7. Confirma la lista actual con el soporte de Tranzila. Las notificaciones de otras direcciones se rechazan. Si el campo está vacío, las notificaciones no se pueden verificar: un pago correcto notificado pone el pedido en On hold status para revisión manual, y un rechazo notificado no cambia nada.

Pedidos

OpenCart crea el pedido en el paso Confirm Order sin estado (un pedido ausente). El pedido solo recibe un estado a partir de una notificación de Tranzila verificada. OpenCart no tiene estado On hold, así que se usa el estado que elijas aquí, y una nota del pedido explica el motivo. Cada campo siguiente muestra tus estados de pedido de OpenCart.

Order status after payment: el pago fue confirmado por una notificación verificada (coinciden el importe, la moneda, el terminal y el token). Predeterminado: Processing.

On hold status: el pago necesita tu revisión: el importe, la moneda o el token de handshake no coinciden, la notificación no se pudo verificar (sin Trusted IP), o las notificaciones están desactivadas y el cliente volvió de una página de pago correcta. Predeterminado: Pending. Puedes crear tu propio estado en System > Localisation > Order Statuses y seleccionarlo aquí.

Refunded status: se asigna cuando el pago se reembolsa por completo desde la página del pedido. Predeterminado: Refunded.

Cancelled order status: la extensión no lo asigna. Un pedido con este estado que se paga más tarde se reabre con una nota para revisar el stock. Predeterminado: Canceled.

Payment error status: la extensión no lo asigna. Un pedido con este estado se paga con un pago de Tranzila aprobado posterior. Predeterminado: Failed.

Avanzado

Debug log: registra los eventos de la página de pago, de las notificaciones y de los reembolsos en tranzila_p_debug.log.php, en la carpeta de logs de OpenCart (storage/logs; en OpenCart 4, system/storage/logs). El archivo no se puede abrir desde la web, y al llegar a 5 MB se traslada a tranzila_p_debug.old.log.php. Las advertencias y los errores siempre se registran, aunque esta opción esté desactivada. Las contraseñas, los tokens y los datos de los clientes nunca se escriben. 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 y el registro. Las transacciones y los reembolsos de Tranzila siempre se conservan, porque los pedidos antiguos los necesitan. Predeterminado: off.

Importar / Exportar

Export: Download JSON guarda los ajustes en un archivo JSON. Las contraseñas no se exportan.

Import: pega el JSON exportado anteriormente y haz clic en Import para restaurar los ajustes. Las contraseñas guardadas se conservan.

Finalización de compra

En el paso Payment Method el cliente elige el método de pago (por defecto Credit Card (Tranzila)). En el paso Confirm Order el cliente ve tu descripción y la nota After you confirm, you will enter your card details on the secure Tranzila payment page. The order is confirmed once Tranzila confirms the payment. OpenCart crea el pedido en este paso, todavía sin estado. Cuando el cliente hace clic en Confirm Order, pasa a una página de pago de tu tienda. Allí se abre la página de pago de Tranzila en un iframe, con el total del pedido en la moneda del pedido, los datos de facturación y una breve lista de los productos. La página dice Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment". El enlace Choose another payment method está debajo del marco. Si se permiten cuotas, el cliente elige el número de cuotas en la página de Tranzila. En OpenCart 4 el cliente elige el método de pago con el botón Choose del bloque de métodos 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.

Cada vez que se muestra la página de pago es un nuevo intento de pago con su propio token (y su propio token de handshake). Recargar la página abre un nuevo intento para el pedido de la misma sesión del cliente; un enlace a la página de pago abierto en otro navegador vuelve a la finalización de compra.

Después de un pago correcto, Tranzila devuelve al cliente y la ventana completa avanza. El pedido solo se marca como pagado cuando Tranzila lo confirma con una notificación. 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. Cuando se paga un pedido retenido, el cliente recibe el correo electrónico sobre el nuevo estado del pedido. Si la notificación ya ha llegado, el cliente ve la página de éxito del pedido de OpenCart con Your payment with Tranzila has been received. Si el pedido está retenido para revisión, la página muestra Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed. Si la notificación todavía no ha llegado, una página Payment confirmation muestra Your payment is being confirmed by Tranzila. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. con los botones Check again y Back to checkout.

Si el pago se rechaza o se cancela, el cliente vuelve a la finalización de compra con el mensaje The payment was not completed. You have not been charged — please try again or choose another payment method. Cuando Tranzila informa de un código de respuesta, se añaden el motivo y el código, por ejemplo que la tarjeta ha caducado. El carrito se conserva y el pedido queda sin estado. En OpenCart 4 este mensaje se muestra encima de la página de finalización de compra. OpenCart 3 crea un pedido nuevo cada vez que se muestra el paso Confirm Order; OpenCart 4 actualiza el pedido de la finalización de compra; un carrito que ya ha sido pagado por uno de estos pedidos no se vuelve a cobrar. 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. Tras un pago rechazado, el cliente paga el mismo pedido de nuevo con un nuevo intento de pago. Si ese pedido se cerró mientras tanto (por ejemplo, lo cancelaste), o se pagó para un carrito que ha cambiado desde entonces, el cliente vuelve a la finalización de compra con This order can no longer be paid. Please confirm your order again., y el siguiente Confirm Order paga un pedido nuevo.

Si la página de pago no se puede abrir, por ejemplo cuando falla el handshake, el cliente permanece en el paso Confirm Order con un breve mensaje encima del botón, como Could not connect to Tranzila. Please try again in a moment. El motivo técnico se escribe en el registro.

La extensión solo acepta pagos únicos con tarjeta, en la página de Tranzila. No tiene tarjetas ni tokens guardados, ni suscripciones, ni autorización y captura por separado (J5), ni botones propios de Bit, Apple Pay o Google Pay (lo que ofrezca tu página de pago de Tranzila se muestra dentro del iframe), ni facturas de Tranzila.

Pedidos y reembolsos

Estados de pedido

Sin estado (pedido ausente): el cliente fue enviado a la página de pago y no ha pagado, el pago fue rechazado o la notificación de Tranzila todavía no ha llegado. En Sales > Orders estos pedidos solo se muestran con el filtro Order Status en Missing Orders. En OpenCart 4.1 este pedido también puede tener el estado Voided, que OpenCart asigna cuando se vuelve a mostrar el paso de confirmación; la extensión lo cuenta como un pedido sin estado.

Estado del pedido tras el pago (predeterminado Processing): el pago fue confirmado por una notificación verificada. Una nota muestra el importe, la transacción de Tranzila (índice), el número de autorización y el número de cuotas, si las hay.

On hold status (predeterminado Pending): el pago se notificó pero no se aceptó automáticamente: no coincidieron el importe, la moneda o el token de handshake; no se pudo verificar la notificación porque Trusted IP está vacío; o las notificaciones están desactivadas y el cliente volvió de una página de pago correcta. La nota explica el motivo. Revisa el pago en el terminal de Tranzila y cambia el estado manualmente.

Refunded status (predeterminado Refunded): el pago se reembolsó por completo mediante la extensión.

Si llega un pago para un pedido en estado retenido, cancelado o de error de pago, el pedido recibe el Order status after payment; un pedido cancelado además recibe una nota que te pide revisar el stock antes de enviarlo. Si llega un segundo pago para un pedido que ya está pagado o reembolsado, o para otro pedido de un carrito que ya está pagado, el pedido no se modifica. Una nota en el pedido pagado te pide revisarlo y reembolsar el duplicado en el terminal de Tranzila. Las notificaciones repetidas de la misma transacción se ignoran.

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

Pestaña VibeFox Tranzila Payment Gateway

En Sales > Orders abre un pedido pagado con Tranzila. En la parte inferior de la página del pedido, junto a History y Additional, la pestaña VibeFox Tranzila Payment Gateway muestra la Transaction (index), la Authorization, el Terminal, el Status, los importes Paid / refunded, el número de Installments, el formulario de reembolso, el historial de reembolsos, todas las Payment pages of the cart con su resultado y las Tranzila notes del pedido. La pestaña se muestra a los usuarios que tienen acceso a la extensión.

Reembolsos

En la pestaña VibeFox Tranzila Payment 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 Tranzila. Confirma la pregunta Refund this amount via Tranzila? This cannot be undone. Se admiten reembolsos totales y parciales. Necesitas el derecho a modificar pedidos (sale/order en System > Users > User Groups). El reembolso se realiza como una transacción de crédito de Tranzila sobre el pago original, en el terminal que lo cobró, por el importe y la moneda que Tranzila cobró realmente. Por tanto, tras un desajuste de importe o de moneda puedes reembolsar hasta lo que el cliente pagó realmente, no el total del pedido.

El formulario está disponible cuando la contraseña del terminal está configurada y el pedido tiene una transacción de Tranzila confirmada. Si no, la pestaña indica el motivo, por ejemplo Refunds need the terminal password (TranzilaPW) in the gateway settings. Un pedido pagado en un terminal distinto del que hay ahora en los ajustes (por ejemplo, un terminal de prueba) no se puede reembolsar desde la página del pedido; reembólsalo en ese terminal de Tranzila.

Si Tranzila no acepta el reembolso, la pestaña muestra el error, por ejemplo Tranzila declined the refund con el código y su significado, 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 crédito de Tranzila. Un reembolso total asigna el Refunded status al pedido sin notificar al cliente y sin devolver productos al stock, como un cambio manual de estado. Un reembolso parcial no cambia el estado.

Las devoluciones de productos en Sales > Returns no devuelven dinero a través de Tranzila. Los reembolsos hechos en el terminal de Tranzila no se comunican a la tienda. Actualiza el pedido manualmente si hace falta.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Tranzila Payment Gateway es el primer bloque de Extensions > Extensions > Payments > VibeFox Tranzila Payment Gateway > 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 volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo están la línea Product: opencart-payment-tranzila 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 después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si el servidor de licencias no responde, 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, Tranzila 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. 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 queda oculto 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 se siguen confirmando mediante la notificación de Tranzila 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 requieren renovarla. 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 se necesita tarea cron. Desinstalar la extensión elimina siempre la clave de licencia y su estado.

Solución de problemas

Tranzila no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado, que Terminal name (supplier) esté rellenado y que la moneda del cliente sea ILS, USD, EUR o GBP. La página de ajustes muestra un aviso cuando falta el nombre del terminal o la moneda predeterminada no es compatible. Comprueba también que la dirección de pago esté en la Geo Zone seleccionada y que el pedido alcance el Total de la configuración.

El pago se realizó, pero el pedido sigue sin estado: la notificación no llegó o fue rechazada. Comprueba que Notifications esté activado y que Trusted IP incluya las direcciones desde las que Tranzila envía las notificaciones. Los errores siempre se escriben en el registro; consulta el campo Log de la página de la extensión. El mensaje de que una IP no está en la lista de Trusted IP significa que hay que corregir el ajuste de Trusted IP o la configuración del proxy: detrás de un proxy o una CDN, el servidor web debe pasar a PHP la IP real del visitante. Para los desarrolladores cuya tienda está detrás de un proxy inverso de confianza, la extensión dispara el evento de OpenCart wcp_tranzila_payment_gateway/remote_ip para establecer la IP.

La notificación responde Forbidden: procede de una dirección IP que no está en Trusted IP.

La notificación responde Bad request o Not found: el pedido, el token de la página de pago, el terminal o el índice de transacción de la notificación no coinciden con una página de pago de esta tienda.

La notificación responde Accepted for manual review: Trusted IP está vacío, así que la notificación no se pudo verificar. Un pago correcto deja el pedido retenido. Rellena Trusted IP para confirmar los pagos automáticamente.

La notificación responde Busy, retry: el carrito lo estaba procesando otra petición en el mismo momento, o no se pudo asignar el estado del pedido. El registro muestra el motivo. Revisa el pago en el terminal de Tranzila.

Algunos pedidos están en el estado retenido: lee las notas de la pestaña VibeFox Tranzila Payment Gateway. No coincidieron el importe, la moneda o el token de handshake, o no se pudo verificar la notificación (Trusted IP vacío, o notificaciones desactivadas). Revisa el pago en el terminal de Tranzila y cambia el estado manualmente.

La página de pago no se abre con el handshake activado: comprueba el nombre del terminal y la contraseña del terminal, que el handshake esté activado en el terminal de Tranzila y que la dirección IP de tu servidor esté permitida allí. El registro muestra el motivo.

Los reembolsos fallan: los reembolsos necesitan Terminal password (TranzilaPW). Algunos terminales también exigen una contraseña de crédito independiente; introdúcela en Refund password (CreditPass). Los pedidos pagados en otro terminal deben reembolsarse en ese terminal. Si la respuesta de Tranzila no es la esperada, la pestaña indica que el reembolso no se ha confirmado: revisa el terminal de Tranzila antes de volver a intentarlo. Sin el derecho a modificar pedidos, la pestaña muestra You do not have permission to refund orders.

Otras monedas: la extensión solo admite ILS, USD, EUR y GBP.

Para los desarrolladores: antes de mostrar la página de pago, la extensión dispara el evento de OpenCart wcp_tranzila_payment_gateway/payment_page_params con los campos de la página de pago y del pedido.

Desinstalación

Ve a Extensions > Extensions, elige el tipo Payments y haz clic en Uninstall (el botón rojo −) junto a VibeFox Tranzila Payment Gateway. La clave de licencia y el estado de 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 en una reinstalación. El evento de OpenCart de la extensión también se elimina (en OpenCart 4, sus eventos y su acción de inicio, que permite que la notificación y el retorno del cliente pasen en modo mantenimiento). Si Delete data on uninstall está activado, se eliminan los demás ajustes (título, descripción, terminal, contraseñas, página de pago, confirmación de pago, registro) y el registro. Si está desactivado, se conservan para una reinstalación posterior. Las transacciones y los reembolsos de Tranzila siempre se conservan, así que los pedidos pagados antes pueden reembolsarse tras 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 tras la desinstalación y haz clic en Uninstall (el botón naranja −) junto a VibeFox Tranzila Payment Gateway en la lista de extensiones instaladas, y después en Delete (el botón rojo de papelera) para eliminar el paquete subido.

Tranzila es una marca comercial de su titular. Esta extensión no está afiliada a Tranzila ni avalada por Tranzila.