VibeFox Tranzila for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 8.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Moneda de la tienda: ILS, USD, EUR o GBP. Para otras monedas, el método de pago no se muestra 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 WooCommerce. 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. Tranzila no tiene un sandbox público. Para las pruebas, Tranzila te proporciona 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 sitio está detrás de un proxy o una CDN como Cloudflare, el servidor web debe pasar la IP real del visitante a PHP (REMOTE_ADDR).
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un dominio.
Instalación
1. En WordPress ve a Plugins > Add New > Upload Plugin, elige el archivo ZIP del plugin y haz clic en Install Now. También puedes subir la carpeta wcp_tranzila_payment_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > Tranzila > Manage, o haz clic en Settings debajo del nombre del plugin en la página de Plugins.
4. Introduce tu clave de licencia de VibeFox en el bloque de licencia de la parte superior de la página y haz clic en Activate.
5. Introduce el Terminal name (supplier) y la Terminal password (TranzilaPW) si usas el handshake o los reembolsos.
6. Mantén Notifications activado y revisa Trusted IP: debe incluir las direcciones IP desde las que Tranzila envía las notificaciones. Confirma la lista con el soporte de Tranzila.
7. Recomendado: activa el handshake en el terminal de Tranzila, permite allí la IP de tu servidor y luego activa Handshake en el plugin.
8. Activa Enable/Disable y prueba un pago con el terminal de prueba de Tranzila.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Tranzila. Encima de los campos, la página te avisa cuando el nombre del terminal está vacío (entonces el método de pago no se muestra en la finalización de compra), cuando las notificaciones están desactivadas o Trusted IP está vacío (entonces los pedidos pagados se quedan en espera de revisión manual), cuando el handshake está activado sin contraseña del terminal (la página de pago no se puede abrir) y cuando la moneda de la tienda no es compatible. Al guardar, un nombre de terminal no válido o una entrada no válida en Trusted IP no se guardan: la página muestra un error y se mantiene el valor anterior. Los números fuera del rango permitido se corrigen al valor permitido más cercano.
General
Enable/Disable: Enable Tranzila Payment Gateway 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. Por defecto: Credit Card (Tranzila).
Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely with your credit card on the Tranzila payment page.
Terminal
Terminal name (supplier): el nombre de tu terminal de Tranzila, por ejemplo myshop. Solo letras, dígitos, «-» y «_». Hasta que se introduzca, 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 WooCommerce.
Refund password (CreditPass): solo si tu terminal exige una contraseña independiente para las transacciones de crédito (reembolsos). Déjala vacía en caso contrario.
Payment page
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, Hebrew, English, Russian, Spanish, German, French o Japanese. Por defecto: Hebrew. Site language usa el idioma de la configuración regional de WordPress del visitante cuando es uno de estos idiomas; en caso contrario, English.
iFrame width (px): de 300 a 1200. Por defecto: 600. En pantallas pequeñas, el marco nunca es más ancho que la página.
iFrame height (px): de 400 a 1500. Por defecto: 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. Por defecto: 0. El terminal debe estar autorizado para procesar cuotas.
Handshake: Lock the amount with a handshake token (recommended). Antes de abrir la página de pago, la tienda pide a Tranzila un token único vinculado al importe del pedido, de modo que el importe no se puede cambiar en el navegador. Requiere la contraseña del terminal, que el handshake esté activado en el terminal de Tranzila y que la IP de tu servidor esté permitida allí. Por defecto: desactivado.
Payment confirmation
Las notificaciones de Tranzila no están firmadas. Un pedido se marca como pagado solo cuando la notificación procede de una IP de confianza y su clave de pedido, terminal, importe y moneda coinciden con el pedido. Con el handshake activado, el token también debe coincidir con la página de pago del pedido. El regreso del cliente desde la página de pago nunca marca un pedido como pagado.
Notifications: Confirm payments automatically with Tranzila notifications (notify URL). Por defecto: activado. La URL de notificación se envía a Tranzila con cada pago, así que no tienes que introducirla en el terminal de Tranzila. Tiene este formato: https://your-site/wc-api/tranzila_p_callback/ y se muestra debajo del campo. Con las notificaciones desactivadas, un cliente que regresa de una página de pago exitosa deja el pedido en espera, y tú confirmas el pago manualmente tras comprobarlo en el terminal de Tranzila.
Trusted IP: las direcciones IP o rangos CIDR de los servidores de Tranzila que envían las notificaciones, separados por comas. Por defecto: 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 exitoso notificado deja el pedido en espera de revisión manual, y una denegación notificada no cambia el pedido.
Advanced
Debug log: Log payment page, notification and refund events escribe en WooCommerce > Status > Logs, origen wcp_tranzila_payment_gateway. Los errores siempre se registran, incluso con esta opción desactivada. Las contraseñas, tokens y datos de los clientes nunca se escriben. Por defecto: desactivado.
Delete data on uninstall: Delete the settings, logs and Tranzila order data when the plugin is deleted. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto Credit Card (Tranzila)) y hace clic en Continue to payment. El pedido se crea con el estado Pendiente de pago, y el cliente pasa a la página de pago del pedido de tu tienda. Allí se abre la página de pago de Tranzila en un iframe, con el total del pedido en su moneda, los datos de facturación y una lista breve de los productos pedidos. 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 su número en la página de Tranzila.
Tras un pago exitoso, Tranzila devuelve al cliente y toda la ventana pasa a la página de pedido recibido de tu tienda. El pedido se marca como pagado solo cuando Tranzila lo confirma con una notificación. Hasta entonces, la página 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. Si el pedido está en espera de revisión, muestra Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed.
Si el pago es rechazado o cancelado, el cliente vuelve a la página de pago del pedido 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 cliente puede volver a pagar o elegir otro método de pago.
Si la página de pago no se puede abrir, por ejemplo cuando falla el handshake, el cliente ve un mensaje breve como Could not connect to Tranzila. Please try again in a moment. y el enlace Choose another payment method. El motivo técnico se escribe en el registro.
El método de pago funciona en la finalización de compra clásica, en el bloque de Finalizar compra y en la página Pay for order. En la página Pay for order se ofrece cuando la moneda del pedido es compatible. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin acepta solo 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
Order statuses
Pending payment: el cliente fue enviado a la página de pago y aún no ha pagado, o la notificación de Tranzila todavía no ha llegado.
Processing or Completed: el pago fue confirmado por una notificación verificada. WooCommerce asigna Procesando, o Completado para los pedidos que no requieren envío. La nota del pedido muestra el importe, la transacción de Tranzila y el número de autorización, y el número de cuotas si las hay. El ID de transacción es el índice de transacción de Tranzila.
On hold: el pago se recibió, pero no se aceptó automáticamente: el importe, la moneda o el token del handshake no coincidían con el pedido; la notificación no se pudo verificar porque Trusted IP está vacío; o las notificaciones están desactivadas y el cliente regresó de una página de pago exitosa. La nota del pedido explica el motivo. Comprueba el pago en el terminal de Tranzila y cambia el estado manualmente.
Failed: Tranzila informó de un pago rechazado para un pedido pendiente. La nota muestra el código de respuesta y su significado. Un pedido que ya está pagado nunca pasa a Failed.
Si llega un pago para un pedido cancelado, el pedido se reabre con una nota que pide comprobar el stock antes de enviarlo. Si el cliente cambió a otro método de pago en la página Pay for order, pero pagó en una página de Tranzila que seguía abierta, el método de pago del pedido vuelve a ser Tranzila. Si llega un segundo pago para un pedido que ya está pagado, completado o reembolsado, el pedido no cambia. Una nota pide comprobarlo y reembolsar el duplicado en el terminal de Tranzila. Las notificaciones repetidas de la misma transacción se ignoran.
Refunds
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Credit Card (Tranzila) (el botón muestra el título del método de pago). Se admiten reembolsos totales y parciales. El reembolso se realiza como una transacción de crédito de Tranzila de la transacción original. El botón está disponible cuando la contraseña del terminal está configurada y el pedido tiene una transacción de Tranzila confirmada con número de autorización. Un reembolso exitoso se añade a las notas del pedido con la transacción de crédito de Tranzila.
Si Tranzila no acepta el reembolso, WooCommerce muestra el error, por ejemplo Tranzila declined the refund con el código, y no se registra ningún reembolso. Un pedido pagado en un terminal distinto del configurado ahora (por ejemplo, un terminal de prueba) no se puede reembolsar desde WooCommerce; reembólsalo en ese terminal de Tranzila. Los reembolsos hechos en el terminal de Tranzila no se comunican a la tienda. Si es necesario, crea un reembolso manual en WooCommerce sin usar el botón de Tranzila.
Clave de licencia
El plugin funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Payments > Tranzila. Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo la fecha hasta la que la licencia está activa y tu dominio. Usa Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para quitarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.
Una clave funciona en un dominio. Quitar la clave de un sitio 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 un pago se inicia de todos modos, el cliente ve This payment method is not available. Please choose another one. Los gestores de la tienda que han iniciado sesión siguen viendo el método de pago, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar el plugin antes de comprar una clave. Aparece un recordatorio en la página de Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los pagos ya iniciados se siguen confirmando y los reembolsos funcionan.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren renovarla. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Tranzila does not appear at checkout: comprueba que la licencia está activa, que Enable/Disable está activado, que Terminal name (supplier) está rellenado y que la moneda de la tienda (en la página Pay for order, la moneda del pedido) es ILS, USD, EUR o GBP. La página de ajustes muestra una advertencia cuando falta el nombre del terminal o la moneda no es compatible.
The payment went through, but the order stays Pending payment: la notificación no llegó o fue rechazada. Comprueba que Notifications está activado y que Trusted IP incluye las direcciones desde las que Tranzila envía las notificaciones. Los errores siempre se escriben en WooCommerce > Status > Logs, origen wcp_tranzila_payment_gateway. El mensaje de que una IP no está en la lista de Trusted IP significa que hay que corregir el ajuste Trusted IP o la configuración del proxy: detrás de un proxy o una CDN, el servidor web debe pasar la IP real del visitante a PHP.
Notification answers Forbidden: llegó desde una dirección IP que no está en Trusted IP.
Notification answers Bad request or Not found: el pedido, su clave de pedido, el terminal o el índice de transacción de la notificación no coinciden con ningún pedido de esta tienda.
Notification answers Accepted for manual review: Trusted IP está vacío, así que la notificación no se pudo verificar. Un pago exitoso deja el pedido en espera. Rellena Trusted IP para confirmar los pagos automáticamente.
Notification answers Busy, retry: otra petición estaba procesando el pedido en ese mismo momento, y la notificación no se aplicó. Comprueba el pago en el terminal de Tranzila; si el pedido sigue esperando el pago y el pago está aprobado allí, cambia el estado manualmente.
Some paid orders are On hold: lee la nota del pedido. El importe, la moneda o el token del handshake no coincidían, o la notificación no se pudo verificar (Trusted IP vacío o notificaciones desactivadas). Comprueba el pago en el terminal de Tranzila y cambia el estado manualmente.
The payment page does not open with the handshake on: comprueba el nombre y la contraseña del terminal, que el handshake esté activado en el terminal de Tranzila y que la IP de tu servidor esté permitida allí. El registro muestra el motivo.
Refunds fail: 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.
Other currencies: el plugin admite ILS, USD, EUR y GBP. Los desarrolladores pueden ajustar la lista con el filtro tranzila_p_currency_map.
The license block shows an error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera una plaza en tu cuenta de vibefox.net y haz clic en Check now. Si cambió la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los datos. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. Los ajustes de la pasarela, los datos de Tranzila guardados en los pedidos y los registros del plugin (incluidos los archivos de registro rotados) se eliminan solo si Delete data on uninstall estaba activado. En caso contrario, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
Tranzila es una marca comercial de su respectivo titular. Este plugin no está afiliado a Tranzila ni cuenta con su respaldo.