Volver

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

Moneda de la tienda: el rand sudafricano (ZAR) debe estar habilitado como moneda en System > Localisation > Currencies. Yoco acepta solo ZAR. Cuando el cliente paga en cualquier otra moneda, el método de pago se oculta en la finalización de compra. El total del pedido debe ser de al menos R2.00.

Cuenta de Yoco: una cuenta de Yoco con pagos en línea. Necesitas sus claves secretas, que encuentras en el Yoco Business Portal en Selling Online > Payment Gateway. Solo se introducen las claves secretas. El webhook lo registra la extensión, y su secreto de firma se rellena por ti.

Sitio público: Yoco envía webhooks a tu tienda, así que debe ser accesible desde internet.

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_yoco_pay-oc3-(version).ocmod.zip y el paquete de OpenCart 4 wcp_yoco_pay.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_yoco_pay-oc3-(version).ocmod.zip. La extensión no tiene modificaciones OCMOD, así que Extensions > Modifications no necesita actualizarse. En lugar del instalador, 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 Yoco Pay 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 configuración. Introduce 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. Pega la clave secreta de prueba (sk_test_...) y, cuando estés listo, la clave secreta de producción (sk_live_...). Haz clic en Save. El webhook se registra para cada modo que tenga una clave.

5. Activa Enable/Disable y haz clic en Save. Haz un pago de prueba con una tarjeta de prueba de Yoco mientras Test mode esté activado, y después desactiva Test mode para aceptar pagos reales.

OpenCart 4

1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo wcp_yoco_pay.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 Yoco Pay 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 las claves de Yoco 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 la URL del webhook es diferente (véase Webhook); se registra en Yoco al guardar de la misma forma.

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 Yoco Pay Gateway > Edit. Las secciones aparecen a la izquierda; el botón Save situado debajo de la lista guarda toda la página. Sin el permiso para modificar la extensión, la página muestra los ajustes pero no puede guardarlos.

Encima de los ajustes, la página muestra el modo activo (Test mode: the test secret key is used, no real money is charged. o Live mode: real payments are accepted.). Avisa si la moneda predeterminada de la tienda no es ZAR (entonces Yoco solo se ofrece cuando el cliente paga en ZAR, o no se ofrece en absoluto si no hay ninguna moneda ZAR habilitada) y si el modo actual no tiene clave secreta, por ejemplo Enter the test secret key to offer Yoco at checkout (test mode).

Al guardar, Title puede tener como máximo 128 caracteres, Sort Order debe ser un número entero (se permiten negativos), Total debe ser un número igual o mayor que 0, y la zona geográfica y los estados de pedido deben existir. Si no, no se guarda nada y la página indica el campo. Después, la extensión comprueba las claves y los secretos de webhook y registra los webhooks. Los mensajes al respecto aparecen encima de los ajustes.

Yoco

Enable/Disable: Enable Yoco activa o desactiva el método de pago. Por defecto: off.

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 guardado en el pedido. Por defecto: Card or Instant EFT (Yoco). Hasta 128 caracteres; si está vacío, los clientes ven Card or Instant EFT (Yoco).

Description: el texto que ve el cliente en el paso Confirm Order, encima del botón de confirmación. Por defecto: You will be redirected to the secure Yoco page to pay by card or Instant EFT.

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

Geo Zone: ofrece Yoco solo para direcciones de pago de la zona geográfica seleccionada. Por defecto: 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 Yoco. Déjalo vacío para ofrecer Yoco con cualquier total. Yoco en sí siempre necesita al menos R2.00.

Claves de API

Copia las claves secretas desde el Yoco Business Portal en Selling Online > Payment Gateway (la sección tiene enlaces allí). Yoco tiene una sola API para ambos modos: la clave decide si un pago es de prueba o real. El modo de prueba usa solo la clave de prueba, y el modo de producción solo la clave de producción.

Test mode: usa la clave secreta de prueba. No se cobra dinero real; paga con tarjetas de prueba de Yoco. Por defecto: on. Desactívalo para aceptar pagos reales. Mientras esté activado, los clientes ven Test mode — use a Yoco test card; no real money is charged. en el paso Confirm Order.

Test secret key: la clave secreta del modo de prueba. Empieza por sk_test_.

Live secret key: la clave secreta del modo de producción. Empieza por sk_live_.

Una clave que no empieza por el prefijo esperado no se guarda: la página muestra un error, por ejemplo Yoco: the test secret key must start with sk_test_ — the previous value was kept. Los demás ajustes sí se guardan. Si Yoco indica durante el registro del webhook que una clave pertenece al otro modo, la página te lo dice.

Las claves y los secretos guardados nunca se vuelven a mostrar. El campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo. Para eliminar un valor guardado, marca Clear the saved value debajo del campo y haz clic en Save.

Webhooks

Yoco confirma los pagos y los reembolsos a la URL que aparece en Webhook URL en esta sección. En OpenCart 3 tiene el aspecto de https://your-store/index.php?route=extension/payment/wcp_yoco_pay/webhook, y en OpenCart 4 el de https://your-store/index.php?route=extension/wcp_yoco_pay/payment/wcp_yoco_pay.webhook. Se construye a partir de la dirección de la tienda de tu instalación de OpenCart. No necesitas crear el webhook en el portal de Yoco. Al guardar los ajustes, la extensión registra la URL en Yoco para cada modo que tenga una clave secreta pero no un secreto de webhook, y guarda el secreto de firma en el campo de ese modo. Vuelve a registrar la URL cuando cambia la clave secreta de ese modo o cuando cambia la URL del webhook. Cuando cambia la URL, se elimina el registro anterior.

Para cada modo (Test y Live) la sección muestra el estado del webhook:

registered: la extensión registró el webhook y se muestra su ID en Yoco. Si la nota dice que es para otra URL, guarda los ajustes para registrarlo de nuevo.
secret entered manually: tú pegaste un secreto. La extensión no lo cambia.
not registered: el modo tiene una clave, pero todavía no tiene webhook. Guarda los ajustes para registrarlo. Hasta entonces, los pagos solo se confirman cuando el cliente vuelve a la tienda.
no secret key: el modo no tiene clave secreta.

La extensión gestiona estos eventos (también aparecen listados en esta sección):

payment.succeeded: se realizó un pago. La extensión consulta el checkout en Yoco antes de establecer el estado del pedido.
refund.succeeded: se completó un reembolso, hecho desde OpenCart o en el portal de Yoco.
refund.failed: un reembolso falló. Se añade una nota al pedido.

Los webhooks sin firma válida se rechazan. Un evento debe estar firmado con el secreto del modo en que se hizo el pago, así que un secreto de prueba nunca confirma un pago real.

Test webhook secret: se rellena automáticamente al registrar el webhook. Pega un secreto (whsec_...) solo si registraste tú mismo la URL del webhook.

Live webhook secret: se rellena automáticamente al registrar el webhook. Bórralo y guarda para registrar el webhook de nuevo.

Un secreto de webhook debe tener la forma whsec_ seguida de texto en base64. Cualquier otro valor no se guarda, y se mantiene el valor anterior. Borrar un secreto de webhook y guardar vuelve a registrar el webhook.

Pedidos

OpenCart crea el pedido en el paso Confirm Order sin estado (un pedido ausente). El pedido recibe un estado solo después de que Yoco 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 después de un pago confirmado. Por defecto: Processing.

On Hold Status: un pago cuyo importe o moneda no coincide con el total del pedido pone el pedido en este estado con una nota. Un pago posterior con el importe correcto lo salda. Por defecto: Pending, porque OpenCart no tiene el estado On hold. Puedes crear tu propio estado en System > Localisation > Order Statuses y seleccionarlo aquí.

Refunded Status: se establece cuando los reembolsos alcanzan el importe pagado. Por defecto: Refunded.

Avanzado

Debug log: escribe las peticiones y los webhooks de Yoco en yoco_p_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, y al llegar a 5 MB se mueve a yoco_p_debug.old.log.php. Los errores y las advertencias, como las peticiones fallidas a Yoco y los webhooks rechazados, siempre se registran. Las claves, los secretos de webhook y las direcciones de correo se enmascaran. Por defecto: off.

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

Delete data: si está activado, al desinstalar la extensión se eliminan los ajustes de la pasarela, el registro y los webhooks que la extensión registró en Yoco. Los datos de los pedidos (checkouts e ID de pago de Yoco, reembolsos) siempre se conservan, porque se necesitan para los reembolsos. Por defecto: off.

Importar / Exportar

Export: Download JSON guarda los ajustes como archivo JSON. Las claves secretas y los secretos de webhook no se exportan.

Import: pega un JSON exportado previamente y haz clic en Import para restaurar los ajustes. Los secretos guardados se mantienen, y ninguna importación registra un webhook.

Finalización de compra

El método de pago se muestra cuando el cliente paga en ZAR y el total del pedido es de al menos R2.00. En el paso Payment Method el cliente lo elige (por defecto, Card or Instant EFT (Yoco)). En el paso Confirm Order el cliente ve tu descripción. 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 finalización de compra. Cuando el cliente hace clic en Confirm Order, la extensión crea un checkout de Yoco por el total del pedido en céntimos y envía al cliente a la página de pago de Yoco, donde paga con tarjeta o Instant EFT.

Después de pagar, el cliente vuelve a tu tienda. El pedido solo se marca como pagado cuando Yoco lo confirma: la extensión consulta a Yoco el checkout cuando el cliente vuelve y de nuevo cuando llega el webhook firmado. 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 éxito del pedido de OpenCart con Your payment with Yoco has been received. Si Yoco todavía no ha confirmado el pago cuando el cliente vuelve, una página de Payment confirmation muestra We are waiting for Yoco to confirm your payment. The order will be updated automatically — please do not pay again. con los botones Check again y Back to checkout; el webhook pone el estado del pedido en cuanto llega. En OpenCart 4, cuando el cliente vuelve de la página de Yoco, una página intermedia breve vuelve a abrir la dirección de retorno de tu tienda, de modo que el carrito y el inicio de sesión del cliente se conservan.

Si el cliente cancela en la página de Yoco, vuelve a la finalización de compra con The Yoco payment was cancelled. Your cart is saved — you can pay again or choose another payment method. Si el pago falla, el mensaje es The Yoco payment was not successful. Please try again or choose another payment method., y se añade una nota al pedido. El carrito se conserva. 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. Antes de un nuevo pago la extensión comprueba el carrito: si otro pedido de ese mismo carrito ya está pagado, el cliente va directamente a la página de éxito. Los checkouts de Yoco sin pagar de ese pedido y del carrito de las últimas 24 horas se comprueban primero en Yoco; si uno se pagó entretanto, se confirma ese pago en lugar de crear uno nuevo. Si el checkout abierto del mismo pedido es por el mismo importe y modo y se creó hace menos de 30 minutos, el cliente recibe de nuevo la misma página de Yoco. Si no, se crea un nuevo checkout de Yoco. 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 finalización de compra hasta que se muestra la página de éxito, así que tras un pago cancelado o fallido el cliente vuelve a pagar el mismo pedido. Si ese pedido se cerró entretanto sin pago (por ejemplo, lo cancelaste), 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.

Si Yoco no puede iniciar el pago, el cliente se queda en el paso Confirm Order con Yoco could not start the payment. Please try again in a moment or choose another payment method. encima del botón, y el motivo se escribe en el registro y en las notas del pedido. Un pedido por debajo de R2.00 recibe Yoco requires an order total of at least R2.00.

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 el regreso del cliente.

Los pagos se cobran inmediatamente en la página de Yoco. La extensión no tiene tarjetas guardadas, suscripciones ni pagos recurrentes, ni formulario de tarjeta en la tienda, ni autorización y captura separadas, y no funciona con monedas distintas de ZAR.

Pedidos y reembolsos

Estados del pedido

Sin estado (pedido ausente): el cliente fue enviado a Yoco y no ha pagado, canceló en la página de Yoco, o Yoco todavía no ha confirmado el pago. 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.

Paid Order Status (por defecto Processing): el pago fue confirmado. Una nota muestra el importe, los ID de pago y de checkout de Yoco, el modo y cómo se confirmó el pago (el regreso del cliente, el webhook o una comprobación antes de un nuevo intento de pago).

On Hold Status (por defecto Pending): Yoco informó de un importe o una moneda distintos del total del pedido, por ejemplo porque el carrito se cambió en otra pestaña después de iniciar el pago. La nota lo explica, y el cliente ve We received your payment and are reviewing it. We will contact you if anything else is needed. Revisa el pago antes de enviar el pedido. Si el cliente paga después el importe correcto con otro intento, el pedido pasa a Paid Order Status.

Refunded Status (por defecto Refunded): los reembolsos alcanzaron el importe pagado.

Si llega un pago para un pedido con otro estado, por ejemplo cancelado o reembolsado, el pedido no se modifica. Una nota te pide reembolsar el pago en el portal de Yoco o restaurar el pedido manualmente. El cliente ve Your payment was received after the order had been cancelled. Please contact us — do not pay again.

Si llega un segundo pago para un pedido que ya está pagado, o para otro pedido de un carrito ya pagado, el pedido no se modifica. Una nota en el pedido pagado te pide reembolsarlo en el portal de Yoco.

Las notas son entradas del History del pedido que el cliente no ve. Empiezan con la palabra Yoco.

VibeFox Yoco Pay Gateway tab

En Sales > Orders abre un pedido pagado con Yoco. En la parte inferior de la página del pedido, junto a History y Additional, la pestaña VibeFox Yoco Pay Gateway muestra el Checkout ID, el Payment ID, el Mode (con una etiqueta Test para los pagos de prueba), el Status, los importes Paid / refunded, el formulario de reembolso, la tabla Yoco checkouts of this order, el historial de Refunds y las Yoco notes del pedido. La pestaña se muestra a los usuarios que tienen acceso a la extensión.

Reembolsos

En la pestaña VibeFox Yoco Pay 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 Yoco. Confirma la pregunta Refund this amount through Yoco? This cannot be undone. Se admiten reembolsos totales y parciales. Necesitas el permiso para modificar la extensión (se configura en System > Users > User Groups). Los reembolsos se calculan sobre el importe que cobró Yoco, así que como máximo puedes reembolsar lo que el cliente pagó realmente, aunque el pedido se haya editado después. El reembolso se envía en el modo en que se hizo el pago (prueba o producción), así que la clave secreta de ese modo debe estar configurada. Un reembolso repetido tras una respuesta perdida no se paga dos veces.

Un reembolso correcto se añade al historial de reembolsos y a las notas con el ID de reembolso de Yoco. Cuando los reembolsos alcanzan el importe pagado, el pedido recibe Refunded Status sin notificar al cliente y sin devolver productos al stock; un reembolso parcial no cambia el estado. Si Yoco rechaza el reembolso, la pestaña muestra Yoco refused the refund: con el motivo, y no se registra ningún reembolso. Si Yoco informa de que el reembolso está pendiente, la pestaña lo indica. No lo repitas: se registra cuando Yoco lo confirma mediante webhook. Los reembolsos están disponibles para pedidos pagados con un checkout de Yoco. Un pedido en On Hold Status no tiene un checkout pagado que reembolsar; reembólsalo en el portal de Yoco.

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

Los reembolsos hechos en el portal de Yoco llegan mediante el webhook refund.succeeded y se registran en el historial de reembolsos y en las notas. Cuando alcanzan el importe pagado, el pedido recibe Refunded Status. Un reembolso mayor que el importe que queda por reembolsar no se registra, y una nota te pide revisar el pedido. Un reembolso fallido añade una nota indicando que el dinero no se devolvió al cliente.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Yoco Pay Gateway es el primer bloque de Extensions > Extensions > Payments > VibeFox Yoco Pay Gateway > Edit, encima de los ajustes. Introduce 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-yoco 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. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, Yoco no se muestra a los clientes en la finalización de 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 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.

Solución de problemas

Yoco no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado y que el modo actual tiene una clave secreta: Test secret key en modo de prueba, Live secret key en modo de producción. El cliente debe pagar en ZAR, y el total del pedido debe ser de al menos R2.00. La página de ajustes muestra un aviso cuando falta la clave o la moneda de la tienda no es ZAR. Comprueba también que la dirección de pago está en la Geo Zone seleccionada y que el pedido alcanza el Total de los ajustes.

El pago se realizó, pero el pedido sigue sin estado: el webhook no funciona. Abre la sección Webhooks de los ajustes y comprueba el estado del modo que usas. Si no está registrado, o está registrado para otra URL, guarda los ajustes. Si el registro falla, la página muestra el motivo. Si introdujiste tú el secreto, comprueba que pertenece al webhook de esta URL y de este modo. El pedido también recibe su estado cuando el cliente vuelve a la tienda después de pagar, y cuando el cliente intenta pagar de nuevo.

No se pudo registrar el webhook: los pagos siguen confirmándose cuando los clientes vuelven a la tienda. Corrige el motivo que muestra el mensaje, por ejemplo que la tienda debe ser accesible desde internet, y guarda de nuevo. También puedes registrar la URL tú mismo y pegar el secreto de firma.

Los webhooks se rechazan: los webhooks rechazados se escriben en el registro. webhook secret not configured significa que no hay ningún secreto de webhook configurado. invalid signature significa que el secreto pertenece a otro registro o modo. timestamp outside the tolerance significa que el reloj del servidor está mal: las firmas se aceptan dentro de 5 minutos respecto a la hora del servidor. checkout not completed yet — retry y could not confirm the checkout with Yoco — retry son temporales; Yoco vuelve a enviar el webhook.

La URL del webhook muestra POST only en el navegador: es normal. La URL solo acepta peticiones de Yoco.

El error al guardar The secret key must start with sk_test_ / sk_live_: se pegó una clave en el campo equivocado. La clave de prueba empieza por sk_test_, la de producción por sk_live_. Se mantuvo el valor anterior.

El cliente ve un error después de Confirm Order: mira el campo Log de la página de la extensión. Yoco is not available at the moment. Please choose another payment method. significa que el modo actual no tiene clave secreta.

Se avisa al cliente de que un pago debe revisarse: se pagó un intento con un importe distinto, o después de cancelar el pedido. Lee las notas de la pestaña VibeFox Yoco Pay Gateway y completa el pedido o reembolsa el pago en el portal de Yoco.

El reembolso falla con un mensaje sobre el modo: el pago se hizo en modo de prueba o de producción, y la clave secreta de ese modo no está configurada. Introdúcela y vuelve a intentarlo.

El reembolso falla con No answer from Yoco: no se registró nada en OpenCart. Si Yoco sí procesó el reembolso, repite el mismo reembolso: no se reembolsará dos veces.

Para desarrolladores: antes de crear el checkout de Yoco, la extensión dispara el evento de OpenCart yoco_p_checkout_payload con los datos de la petición y el pedido, para que otra extensión pueda añadir datos a la petición.

Desinstalación

Ve a Extensions > Extensions, elige el tipo Payments y haz clic en Uninstall (el botón rojo −) junto a VibeFox Yoco Pay Gateway. 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 por defecto al reinstalar. También se elimina el evento de OpenCart de la extensión (en OpenCart 4, también sus eventos y su acción de inicio, que deja pasar el webhook y el regreso del cliente en modo de mantenimiento). Si Delete data está activado, se eliminan los demás ajustes de la pasarela (título, descripción, modo de prueba, claves, secretos de webhook, registro), el registro y los webhooks que la extensión registró en Yoco. Si está desactivado, se conservan para una reinstalación posterior. Los checkouts y reembolsos de Yoco siempre se conservan, así que los pedidos pagados antes pueden reembolsarse tras 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 desinstalar y haz clic en Uninstall (el botón naranja −) junto a VibeFox Yoco Pay Gateway en la lista de extensiones instaladas, y después en Delete (el botón rojo de la papelera) para eliminar el paquete subido.

Yoco es una marca registrada de su respectivo propietario. Esta extensión no está afiliada ni respaldada por Yoco.