Volver

VibeFox Tap 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.

Moneda del pedido: AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR o USD. En los pedidos en otras monedas, el método de pago no aparece en la finalización de compra.

Acceso a Internet a tu tienda: Tap envía el resultado del pago a un webhook de tu tienda, así que el sitio debe ser accesible desde Internet. La URL del webhook se envía con cada pago; no hay que configurar nada en el panel de Tap.

Cuenta de Tap: necesitas las claves de API de tu panel de Tap (goSell, credenciales de API). Las claves de prueba empiezan por pk_test_ / sk_test_, y las claves reales, por pk_live_ / sk_live_. La clave secreta siempre es necesaria; la clave publicable, solo para la ventana emergente de finalización de compra. Los métodos de pago que se ofrecen (mada, KNET, Benefit y otros) y la verificación del dominio de Apple Pay se configuran en tu cuenta de Tap.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo 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_tap_payment_gateway-oc3-(version).ocmod.zip y el paquete de OpenCart 4 wcp_tap_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_tap_payment_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 Tap Payments 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 con forma 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. Introduce tus claves de prueba y reales de Tap, elige la acción de pago, el tipo de finalización de compra y el idioma de la página de Tap (consulta Configuración).

5. Activa Enable / Disable y haz clic en Save. Prueba con las tarjetas de prueba de Tap y luego desactiva Test mode.

OpenCart 4

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

4. Introduce la clave de licencia, las claves de Tap y las opciones de pago igual que en los pasos 3 a 5 de OpenCart 3. La página de ajustes y sus campos son iguales en ambas versiones.

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 Tap Payments > 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 Test mode is on: payments use your Tap test keys and no real money is charged. o Live mode: real payments are accepted. También avisa cuando faltan las claves del modo actual (en ese caso, el método de pago no se muestra en la finalización de compra) y cuando la moneda predeterminada de la tienda no se ofrece con Tap. Sin permiso para modificar la extensión, la página muestra los ajustes pero no puede guardarlos.

Al guardar, Title no puede estar vacío ni tener más de 128 caracteres, Sort Order debe ser un número entero (se permiten valores negativos), Total debe ser un número igual o mayor que 0, y los estados del pedido deben existir; si no, no se guarda nada. Una clave con un prefijo incorrecto para su campo no se guarda: se mantiene el valor anterior, los demás ajustes sí se guardan y aparece un mensaje como Test secret key was not saved: a Tap key for this field starts with "sk_test_".. Por ejemplo, una clave real en un campo de prueba se rechaza.

Tap Payments

Enable / Disable: Enable Tap Payments activa o desactiva el método de pago. Predeterminado: desactivado.

Title: el nombre del método de pago que ven los clientes en la finalización de compra. También es el nombre del método de pago que se guarda en el pedido. Predeterminado: Tap Payments. Obligatorio, máximo 128 caracteres.

Description: el texto que ve el cliente en el paso Confirm Order, encima del botón de confirmar. Predeterminado: Pay with Visa, Mastercard, mada, KNET, Benefit, Apple Pay or Google Pay.

Sort Order: la posición de Tap 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 Tap solo para direcciones de pago dentro 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 Tap. Déjalo vacío para ofrecer Tap con cualquier importe.

Claves de API de Tap

Encuentra tus claves en el panel de Tap (goSell, credenciales de API). La sección enlaza con la documentación para desarrolladores de Tap.

Test mode: usa las claves de prueba; no se cobra dinero real. Los pagos, las comprobaciones de estado, las capturas y los reembolsos siempre usan las claves del modo en que se realizó el pago, de modo que un pago de prueba se sigue comprobando y reembolsando con la clave de prueba aunque hayas cambiado al modo real. Predeterminado: activado. Mientras esté activado, los clientes ven Test mode: no real payment will be made. en el paso Confirm Order y en la página de pago emergente.

Test publishable key: empieza por pk_test_. Necesaria para la ventana emergente.

Test secret key: empieza por sk_test_.

Live publishable key: empieza por pk_live_. Necesaria para la ventana emergente.

Live secret key: empieza por sk_live_.

Merchant ID: opcional. Tu ID de comerciante de Tap; solo es necesario si Tap te pidió dirigir los pagos a una cuenta de comerciante concreta.

Las claves secretas guardadas nunca se vuelven a mostrar. El campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo. Para eliminar una clave guardada, marca Clear the saved value debajo del campo y haz clic en Save. Las claves publicables son públicas y siguen visibles.

Pago

Payment action: lo que ocurre con el dinero cuando el cliente paga.

Charge (capture immediately): el pago se captura de inmediato (predeterminado).
Authorize only (capture later from the order): solo se reservan los fondos. El pedido recibe el Authorized Status; captúralo con Capture Tap payment o libera los fondos con Void Tap authorization en la pestaña del pedido.

Checkout type: dónde paga el cliente.

Tap payment page (redirect, recommended): el cliente paga en la página segura alojada por Tap (predeterminado).
Tap checkout popup on your site: el SDK de Tap Checkout abre una página de pago de la tienda. La página de pago de Tap sigue disponible como alternativa. Necesita la clave publicable del modo actual.

Tap page language: idioma de la página de pago de Tap y de la ventana emergente: English (predeterminado) o Arabic.

Notificaciones de pago (webhook)

Tap envía el resultado del pago a la URL que aparece en Webhook URL en esta sección. En OpenCart 3 tiene este aspecto: https://your-store/index.php?route=extension/payment/wcp_tap_payment_gateway/webhook, y en OpenCart 4, este otro: https://your-store/index.php?route=extension/wcp_tap_payment_gateway/payment/wcp_tap_payment_gateway.webhook. Se genera a partir de la dirección pública de tu instalación de OpenCart. La URL se envía con cada pago, así que no hay que configurar nada en el panel de Tap. Solo asegúrate de que sea accesible desde Internet (que no la bloqueen un cortafuegos ni una autenticación HTTP); el modo de mantenimiento no la bloquea (en OpenCart 4, una acción de inicio de la extensión deja pasar el webhook y la vuelta del cliente a la tienda). Cada notificación se verifica con la firma hashstring (HMAC-SHA256 con la clave secreta del modo en que se realizó el pago). Los webhooks sin una firma válida se rechazan. Ni siquiera una notificación firmada se considera fiable por sí misma: la extensión vuelve a leer el pago desde la API de Tap antes de cambiar el pedido. Sin un webhook que funcione, el pedido solo recibe su estado cuando el cliente vuelve a la tienda después de pagar.

Pedidos

OpenCart crea el pedido en el paso Confirm Order sin estado (un pedido faltante). El pedido solo recibe un estado después de que Tap haya confirmado el pago a través de la API. Cada campo siguiente muestra tus estados de pedido de OpenCart.

Paid Order Status: el estado tras un pago capturado. Predeterminado: En proceso.

Authorized Status: Authorize only: los fondos quedan reservados, aún sin capturar. Predeterminado: Pendiente.

On Hold (Review) Status: el pago necesita tu revisión (consulta Estados del pedido). Predeterminado: Pendiente, porque OpenCart no tiene el estado En espera. Puedes crear tu propio estado en System > Localisation > Order Statuses y seleccionarlo aquí.

Voided Status: se establece después de que Void Tap authorization libere los fondos reservados. Predeterminado: Cancelado.

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

Avanzado

Debug log: escribe los eventos de pago en tap_p_debug.log.php, en la carpeta de registros de OpenCart (storage/logs; en OpenCart 4, system/storage/logs). El archivo no se puede leer desde la web y, al llegar a 5 MB, se mueve a tap_p_debug.old.log.php. Los errores y las advertencias siempre se registran; activa esta opción para registrar también todos los eventos de pago. El registro nunca contiene claves ni datos de tarjetas o clientes. Predeterminado: desactivado.

Log: muestra el tamaño y las entradas más recientes 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 registros de pago de los pedidos siempre se conservan. Predeterminado: desactivado.

Importar / Exportar

Export: Download JSON guarda los ajustes como un archivo JSON. Las claves secretas no se exportan.

Import: pega el 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 (de forma predeterminada, Tap Payments). En el paso Confirm Order, el cliente ve tu descripción. OpenCart crea el pedido en este paso, todavía sin estado. Después, el cliente hace clic en Confirm Order. 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.

Tap payment page: la extensión crea un cargo de Tap (o una autorización en modo Authorize only) por el total del pedido en la moneda del pedido, con la descripción Order # y el número de pedido, y envía al cliente a la página de pago de Tap. El nombre, el correo electrónico y el teléfono del cliente se pasan a Tap. Allí el cliente elige una tarjeta, mada, KNET, Benefit, Apple Pay o Google Pay (según estén activados en tu cuenta de Tap) y paga. Si Tap no puede iniciar el pago, el cliente se queda en el paso Confirm Order con The Tap payment could not be started. Please try again or choose another payment method. y el motivo se escribe en el registro.

Tap checkout popup: el cliente va a la página Tap payment de la extensión, donde se abre el formulario de pago de Tap. La página también muestra el enlace Pay on the Tap payment page instead. Si la ventana se cierra, el botón Pay now la vuelve a abrir. Si el formulario no se puede cargar, se pide al cliente que use la página de pago de Tap. Recargar la página reutiliza el mismo intento de pago.

Después de pagar, el cliente vuelve a tu tienda. El pedido se marca como pagado solo cuando Tap lo confirma: la extensión lee el pago de la API de Tap con la clave del modo del pago, comprueba que se refiere a este pedido y que lo inició su finalización de compra, y compara el importe y la moneda con el pedido. El ID de Tap de la dirección de retorno, por sí solo, nunca cambia el pedido. El webhook hace la misma comprobación en segundo plano. Luego el pedido recibe su estado de la forma estándar de OpenCart, con los correos habituales del pedido y la actualización de existencias, y el cliente ve la página de confirmación del pedido de OpenCart. En OpenCart 4, cuando el cliente vuelve de la página de pago de Tap, una página intermedia breve vuelve a abrir la dirección de retorno de tu tienda, de modo que se conservan el carrito y el inicio de sesión del cliente. En un pago autorizado, la página también muestra Your payment has been authorized. We will process the order as soon as the payment is captured. Para un pago en revisión muestra Your payment is being reviewed. We will contact you if anything else is needed.

Si Tap aún no ha confirmado el pago cuando el cliente vuelve, aparece una página de Payment confirmation con We have not received the payment confirmation from Tap yet. If you completed the payment, the order will be updated automatically in a few minutes — there is no need to pay again. y los botones Check again y Back to checkout. El webhook actualiza el estado del pedido en cuanto llega.

Si el pago fue rechazado, abandonado o cancelado, el pedido se queda sin estado. El cliente vuelve a la finalización de compra con Your payment was not completed. Please try again or choose another payment method. (con el motivo de Tap cuando Tap lo indica). Un pago sin terminar muestra The payment was not completed. You can try again or choose another payment method. El carrito se conserva y puede pagarse de nuevo. En OpenCart 4 estos mensajes se muestran 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. Si otro pedido del mismo carrito ya se ha pagado, el cliente va directamente a la página de confirmación en lugar de volver a pagar. Antes de iniciar un nuevo pago, se comprueban con Tap las páginas de pago abiertas del pedido y del carrito de las últimas 24 horas, de modo que un pago hecho en otra pestaña se confirme en lugar de cobrarse dos veces. Cualquier cambio en el carrito, incluida una nueva cantidad, cuenta como un carrito nuevo que necesita su propio pago.

En OpenCart 4, el pedido se mantiene en la finalización de compra hasta que se muestra la página de confirmación. Tras un pago rechazado o cancelado, el siguiente Confirm Order inicia un nuevo pago de Tap para el mismo pedido. Si ese pedido se cerró sin pago entretanto (por ejemplo, porque lo cancelaste o se anuló su autorización), el cliente vuelve a la finalización de compra con Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order., y el siguiente Confirm Order paga un pedido nuevo.

Otros mensajes en la finalización de compra: Tap does not accept payments in seguido de la moneda, cuando la moneda del pedido no es compatible, y The order total must be greater than zero to pay with Tap.

La extensión no tiene tarjetas guardadas ni tokenización, ni suscripciones, ni campos de tarjeta incrustados en la página de finalización de compra. Capture Tap payment siempre captura el total del pedido; la captura parcial no es compatible.

Pedidos y reembolsos

Estados del pedido

Sin estado (pedido faltante): el cliente fue enviado a Tap y no ha pagado, o Tap todavía no ha confirmado el pago. En Sales > Orders, estos pedidos solo se muestran con el filtro Order Status configurado en Missing Orders. En OpenCart 4.1, un pedido de este tipo también puede tener el estado Voided, que OpenCart asigna al volver a mostrar el paso de confirmación; la extensión lo cuenta como un pedido sin estado.

Paid Order Status (default Processing): Tap confirmó un pago capturado. Una nota muestra el importe, el ID del cargo de Tap (chg_...), el método de pago y, en el caso de los pagos de prueba, (test mode).

Authorized Status (default Pending): el pago solo se autorizó y espera captura o anulación.

On Hold (Review) Status (default Pending): el importe o la moneda pagados no coincidían con el pedido (Tap: amount/currency mismatch — manual review required.), o un pago llegó después de que el pedido se hubiera cancelado. La nota lo explica. Revisa el pedido y prepáralo para el envío, o reembolsa el pago.

Voided Status (default Canceled): la autorización se anuló con Void Tap authorization, de modo que los fondos reservados se liberaron.

Refunded Status (default Refunded): el pago se reembolsó por completo a través de la extensión.

Un intento fallido nunca cambia un pedido que ya tiene estado. Si llega un segundo pago correcto para un pedido que ya está pagado, el pedido no se modifica. Una nota indica que es un pago duplicado y te pide reembolsarlo en el panel de Tap. Un pago de otro pedido de un carrito que ya está pagado deja ese pedido sin estado y se anota en el pedido pagado. Un pago que hace referencia al pedido pero que no lo inició su finalización de compra solo se anota.

Las notas son entradas del History del pedido que el cliente no ve. Empiezan con "Tap".

Pestaña VibeFox Tap Payments

En Sales > Orders, abre un pedido pagado con Tap. En la parte inferior de la página del pedido, junto a History y Additional, la pestaña VibeFox Tap Payments muestra el Tap ID, la Authorization y el Charge, el Mode (una etiqueta Test para los pagos de prueba), el Status del pago y el método, Charged / refunded, el formulario de reembolso, el historial de reembolsos, los Payment attempts del pedido y las Tap notes. La pestaña se muestra a los usuarios que tienen acceso a la extensión; la captura, la anulación y los reembolsos requieren el permiso para modificar la extensión (se configura en System > Users > User Groups).

Captura y anulación

En modo Authorize only, abre el pedido autorizado. Capture Tap payment (con el total del pedido en el botón) captura el total del pedido tras la pregunta Capture the reserved funds of this order through Tap?; el pedido recibe entonces el Paid Order Status. Void Tap authorization muestra Release the reserved funds? The order will be canceled., libera los fondos y establece el Voided Status. Un segundo clic en captura dentro de 2 minutos se bloquea. Si Tap rechaza la acción, se muestra un error en la pestaña y se añade a las notas. Estos cambios de estado se hacen sin notificar al cliente y sin modificar las existencias, igual que un cambio manual de estado. Si una autorización se captura directamente en el panel de Tap, el webhook marca el pedido como pagado; los reembolsos de ese pago deben hacerse en el panel de Tap.

Reembolsos

En la pestaña, introduce el Amount (se rellena el importe que aún no se ha reembolsado), opcionalmente un Reason (optional), y haz clic en Refund via Tap. Confirma la pregunta Refund this amount through Tap? This cannot be undone. Se admiten reembolsos totales y parciales de cargos de Tap capturados. Puedes reembolsar hasta el importe y la moneda que Tap cobró realmente, aunque el pedido se haya editado después. El reembolso se envía con la clave secreta del modo en que se realizó el pago, así que esa clave debe estar configurada. Un reembolso aceptado por Tap se añade al historial de reembolsos y a las notas con el ID y el estado del reembolso en Tap. Si Tap lo rechaza, la pestaña muestra el error y no se registra ningún reembolso. Un reembolso total establece el Refunded Status sin notificar al cliente y sin devolver productos a las existencias; un reembolso parcial no cambia el estado. En un pedido autorizado, los reembolsos están disponibles una vez capturada la autorización. Un pedido en revisión tras una diferencia de importe o de moneda se reembolsa en el panel de Tap.

Las devoluciones de productos en Sales > Returns no devuelven dinero a través de Tap. Los reembolsos hechos en el panel de Tap no aparecen en OpenCart.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Tap Payments es el primer bloque de Extensions > Extensions > Payments > VibeFox Tap Payments > 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-tap 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 de la extensión pueden cambiar la clave. Los textos del bloque siguen el idioma del panel de administración (se incluyen el inglés y el ruso).

Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on seguido de una fecha. Después de cambiar la dirección de la tienda, o después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede contactar con el servidor de licencias, la extensión sigue funcionando con el último estado conocido.

Una clave funciona en un solo 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, Tap Payments 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 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 en el panel de administración, 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, y los reembolsos, la captura y la anulación 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 ninguna tarea cron. Al desinstalar la extensión siempre se eliminan la clave de licencia y el estado de la licencia.

Solución de problemas

Tap Payments no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable / Disable esté activado y que el modo actual tenga una clave secreta (y una clave publicable cuando Checkout type sea la ventana emergente). Comprueba que la moneda del pedido sea una de AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR o USD, que la dirección de pago esté en la Geo Zone seleccionada y que el pedido alcance el Total configurado. La página de ajustes muestra una advertencia si faltan claves o si la moneda de la tienda no es compatible.

El pago se realizó, pero el pedido sigue sin estado: el webhook no puede llegar a tu tienda. Comprueba que la URL que aparece en Webhook URL sea accesible desde Internet (sin cortafuegos ni autenticación HTTP) y activa Debug log para ver las respuestas en el campo Log. El pedido también recibe su estado cuando el cliente vuelve de Tap.

El webhook responde invalid signature: la notificación no se firmó con la clave secreta del modo del pago. Comprueba las claves secretas en los ajustes.

El webhook responde gateway not configured: la clave secreta del modo del pago (prueba o real) está vacía. Introdúcela.

El webhook responde verification failed: no se pudo contactar con la API de Tap para comprobar el pago. Tap volverá a intentar el webhook más tarde.

El webhook responde order not found: la notificación indica un pedido que no tiene ningún intento de pago de Tap en esta tienda.

El webhook responde busy, retry later or order could not be updated, retry later: otra solicitud estaba confirmando el pedido en el mismo momento, o no se pudo establecer el estado del pedido. Tap vuelve a intentar el webhook. Consulta el campo Log para ver el motivo.

Una clave no se guarda: la clave debe empezar con el prefijo de su campo: pk_test_, sk_test_, pk_live_ o sk_live_.

El cliente ve The Tap payment could not be started: consulta el campo Log de la página de la extensión. Una clave incorrecta o una solicitud rechazada queda registrada allí.

El cliente ve This payment method is not available: la sesión de finalización de compra ya no coincide con el pedido, o el método de pago se desactivó o perdió sus claves mientras tanto. El cliente recarga la finalización de compra.

El cliente ve We could not match this payment to an order: el pago no pertenece a este pedido o no lo inició su finalización de compra. Si se cobró dinero, comprueba el pago en el panel de Tap.

El pedido está en estado de revisión: lee las notas de la pestaña VibeFox Tap Payments. El importe o la moneda pagados no coincidían con el pedido, o el pago llegó después de que el pedido se cancelara.

El reembolso falla con un mensaje sobre el modo: el pago se hizo en modo de prueba o real, y no hay una clave secreta configurada para ese modo. Introdúcela e inténtalo de nuevo. Si la pestaña indica que no se encontró ningún cargo de Tap capturado, reembolsa el pago en el panel de Tap.

Para desarrolladores: los eventos de OpenCart tap_p_charge_payload, tap_p_supported_currencies y tap_p_currency_decimals permiten cambiar la solicitud de pago, las monedas compatibles y los decimales de cada moneda.

Desinstalación

Ve a Extensions > Extensions, elige el tipo Payments y haz clic en Uninstall (el botón rojo −) junto a VibeFox Tap Payments. 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, sus eventos y su acción de inicio, que deja pasar el webhook y la vuelta del cliente a la tienda 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, opciones de pago, interruptor del registro de depuración) y el registro. Si está desactivado, se conservan para una reinstalación posterior. Los intentos de pago y los reembolsos de Tap siempre se conservan, de modo que los pedidos pagados antes se pueden 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 desinstalarla, haz clic en Uninstall (el botón naranja −) junto a VibeFox Tap Payments en la lista de extensiones instaladas y después en Delete (el botón rojo de papelera) para eliminar el paquete subido.

Tap Payments es una marca comercial de su respectivo titular. Esta extensión no está afiliada a Tap Payments ni cuenta con su respaldo.