VibeFox Satispay for WooCommerce — Ayuda

Requisitos

WordPress: 6.0 o posterior.

WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él.

PHP: 8.0 o posterior con la extensión OpenSSL. Sin OpenSSL, el plugin muestra un error en el área de administración y el método de pago no se carga.

Moneda: EUR. Satispay cobra solo en euros, así que el método de pago se oculta cuando la moneda de la tienda (o, en la página Pay for order, la moneda del pedido) no es EUR.

Cuenta de Satispay: una cuenta de Satispay Business. No copias ninguna clave API: el plugin se conecta con un código de activación de un solo uso que generas en el Satispay Business Dashboard (ver Configuración). Para las pruebas necesitas una cuenta sandbox de Satispay, que solicitas a Satispay for developers.

Sitio público: tu sitio debe ser accesible desde internet, para que Satispay pueda llamarlo cuando cambie un pago. Para esto no hay que configurar nada en Satispay.

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_satispay_gateway a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Payments > Satispay > Manage, o haz clic en Settings debajo del nombre del plugin en la página 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. Elige el entorno: marca Sandbox Mode para las pruebas y déjalo desmarcado para los pagos reales.

6. Pega en Activation Code un código de activación de ese entorno y guarda. El estado de la conexión mostrará entonces el Key ID.

7. Activa Enable/Disable y guarda. Prueba un pago en el sandbox, después desmarca Sandbox Mode y conecta el entorno de producción con un código de activación de producción.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Satispay. La sección Satispay connection muestra el estado de ambos entornos, por ejemplo Live: Connected con el Key ID o Sandbox: Not connected, y marca el entorno en uso. Mientras el entorno en uso no esté conectado, la página indica Satispay se oculta en la finalización de compra hasta que el entorno en uso esté conectado. En la lista de métodos de pago de WooCommerce, Satispay aparece como pendiente de configuración hasta que el entorno en uso esté conectado, y muestra una insignia de modo de prueba mientras Sandbox Mode esté activado.

Enable/Disable: Enable Satispay payment activa o desactiva el método de pago. Por defecto: desactivado.

Checkout

Lo que ven los clientes en la lista de métodos de pago.

Title: el nombre del método de pago que se muestra en la finalización de compra. Por defecto: Satispay.

Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

Satispay connection

Sandbox Mode: Use the Satispay sandbox (staging) environment. Los pagos en sandbox no se cobran. Por defecto: desactivado. El sandbox y la producción tienen claves independientes: conecta cada entorno con un código de activación de ese entorno. Mientras el sandbox esté en uso, los clientes ven Modo sandbox: no se cobra dinero real. debajo del método de pago.

Activation Code: para conectar el entorno seleccionado arriba, pega un nuevo código de activación de 6 caracteres y guarda. Los códigos de producción se generan en el Satispay Business Dashboard, sección Online shop. Los códigos del sandbox se obtienen con una cuenta sandbox de Satispay. El código se usa una sola vez y no se guarda. Deja el campo vacío para mantener la conexión actual.

Al guardar con un código, el plugin crea un par de claves RSA, envía la clave pública y el código a Satispay, y guarda en la base de datos de WordPress el Key ID y las claves de ese entorno. Si todo va bien, la página muestra, por ejemplo, Satispay Live connected. Key ID: seguido del ID. Si Satispay rechaza el código, la página muestra el mensaje de Satispay y te pide que compruebes que el código es de este entorno y que aún no se ha usado. Un código con caracteres distintos de letras y números se rechaza antes de enviar nada. Guardar un código nuevo para un entorno sustituye su conexión anterior.

Payment notifications

No hay nada que configurar en Satispay. Cada pago lleva su propia URL de callback, a la que Satispay llama cuando cambia el pago, y el plugin vuelve a leer el pago desde la API de Satispay antes de cambiar un pedido. La sección muestra un ejemplo de esta URL. Tiene este aspecto: https://your-site/wc-api/satispay_payment_callback/?action=callback&order_id={order}&payment_id={uuid}. La URL debe ser accesible desde internet: sin modo de mantenimiento ni protección con contraseña en /wc-api/.

Advanced

Debug log: Log API calls and payment events escribe en WooCommerce > Status > Logs, origen wcp_satispay_gateway, sin claves ni datos de clientes. Los errores siempre se registran, incluso con esta opción desactivada. Por defecto: desactivado.

Delete data on uninstall: Remove the settings and Satispay keys when the plugin is deleted. Los datos de pago guardados en los pedidos se conservan. Por defecto: desactivado.

Finalización de compra

El cliente elige el método de pago (por defecto Satispay) y hace clic en Pay with Satispay. El plugin crea un pago de Satispay por el total del pedido en euros, con el número de pedido como referencia, y envía al cliente a la página de pago de Satispay. En un ordenador, el cliente escanea el código QR con la aplicación Satispay. En un teléfono, el cliente confirma el pago en la aplicación.

Después del pago, el cliente vuelve a tu tienda. El pedido solo se marca como pagado cuando Satispay lo confirma: el plugin lee el pago desde la API de Satispay, comprueba que se creó para este pedido y compara su estado, importe (en céntimos) y moneda con el pedido. Esto ocurre tanto cuando Satispay llama a la URL de callback como cuando el cliente regresa, lo que llegue primero. Si el pago aún no está confirmado, la página de pedido recibido muestra Satispay aún no ha confirmado tu pago. El pedido se actualizará automáticamente en cuanto llegue la confirmación.

Si el cliente sale de la página de Satispay sin pagar, el plugin cancela el pago en Satispay, de modo que la página abandonada ya no se puede pagar. El cliente vuelve a la finalización de compra (o a la página Pay for order) con el mensaje Tu pago de Satispay fue cancelado y no se cobró nada. Puedes intentarlo de nuevo o elegir otro método de pago. El mismo mensaje aparece cuando el cliente rechaza el pago en la aplicación.

Un cliente puede pagar de nuevo un pedido no pagado, por ejemplo desde la página Pay for order. Antes de crear un nuevo pago de Satispay, se comprueba el anterior: un pago pendiente se cancela en Satispay, y si ya estaba pagado, el pedido se marca como pagado con ese pago y no se crea un segundo cobro.

Si el pago no se puede iniciar, el cliente ve un mensaje breve y puede elegir otro método de pago: Satispay no está disponible en este momento. Elige otro método de pago. cuando la tienda no está conectada o Satispay rechaza las claves, o No se puede crear el pago de Satispay. Vuelve a intentarlo o elige otro método de pago. para otros errores. El motivo 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. Es compatible con WooCommerce High-Performance Order Storage (HPOS).

El plugin acepta solo pagos únicos en euros. No admite suscripciones, métodos de pago guardados, preautorizaciones ni vales de comida. No hay una comprobación programada de los pagos pendientes: si ni la llamada callback de Satispay ni el regreso del cliente llegan a tu sitio, el pedido permanece como Pendiente de pago, y el pago es visible en el Satispay Dashboard.

Pedidos y reembolsos

Order statuses

Pending payment: el cliente fue enviado a Satispay y todavía no ha pagado, o Satispay aún no ha confirmado el pago. La nota del pedido muestra el ID del pago de Satispay, el importe y el entorno (producción o sandbox).

Processing or Completed: el pago fue confirmado. El pedido sigue la regla estándar de WooCommerce: Procesando, o Completado para los pedidos que contienen solo productos descargables virtuales. La nota del pedido muestra el pago de Satispay, el importe y cómo se verificó (callback, redirección o finalización de compra). El ID de transacción es el ID del pago de Satispay.

On hold: Satispay informó de un importe o una moneda distintos del total del pedido, o el pago se aceptó después de cancelar el pedido. La nota del pedido lo explica, y el pago se guarda como ID de transacción, para que pueda reembolsarse. Revisa el pago en el Satispay Dashboard y luego completa el pedido o reembolsa el pago.

Cancelled: el último pago de Satispay del pedido fue cancelado o expiró, por ejemplo porque el cliente salió de la página de Satispay. Un pago anterior que expira no cancela un pedido con un pago más reciente en curso. Los pedidos que creaste en el área de administración (enlaces de pago) no se cancelan: permanecen como Pendiente de pago con una nota, para que el cliente aún pueda pagarlos.

Si se acepta un segundo pago para un pedido que ya está pagado, el pedido no cambia. Una nota te pide que reembolses el pago duplicado desde el Satispay Dashboard. Una confirmación repetida nunca vuelve a abrir un pedido cancelado o reembolsado.

Refunds

Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Satispay. Se admiten reembolsos totales y parciales de pedidos pagados con Satispay. El reembolso se envía al entorno en el que se hizo el pago (producción o sandbox), por lo que ese entorno debe seguir conectado. Un reembolso se considera realizado solo cuando Satispay lo acepta: un reembolso correcto se añade a las notas del pedido con el ID del reembolso de Satispay y el motivo. Si Satispay no acepta el reembolso, WooCommerce muestra el error y no se registra ningún reembolso.

Los reembolsos hechos en el Satispay Dashboard no se convierten en reembolsos de WooCommerce. Si es necesario, crea un reembolso manual en WooCommerce sin usar Refund via Satispay.

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 > Satispay. 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, Satispay no se muestra a los clientes en la finalización de compra. Si un pago se inicia de todos modos, el cliente ve Este método de pago no está disponible. Elige otro. Los gestores de la tienda que han iniciado sesión siguen viendo el método de pago, marcado como (sin licencia: visible solo para administradores), para que puedas configurar y probar el plugin antes de comprar una clave. Un recordatorio aparece en la página 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 una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Satispay no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado, que el entorno en uso esté conectado (la sección Satispay connection muestra Connected para él) y que la moneda sea EUR.

El pago se realizó, pero el pedido sigue como Pending payment: el pedido se actualiza cuando Satispay llama a tu sitio o cuando el cliente regresa. Comprueba que tu sitio sea accesible desde internet, sin modo de mantenimiento ni protección con contraseña en /wc-api/, y revisa WooCommerce > Status > Logs, origen wcp_satispay_gateway. El pago es visible en el Satispay Dashboard.

La callback responde Payment status unavailable, retry later o Not configured: el plugin no pudo leer el pago desde Satispay, o el entorno del pedido no está conectado. El pedido no se modifica. Revisa el estado de la conexión y el registro.

La callback responde Busy, retry later: otra solicitud estaba actualizando el pedido en ese mismo momento. Esta callback no cambia el pedido. Se actualiza con la siguiente callback o cuando el cliente regresa.

La callback responde Unknown payment o Missing or invalid payment_id: el pago no se creó para este pedido, o la solicitud no es una callback de Satispay. El pedido no se modifica.

La activación falla: los códigos de activación solo se pueden usar una vez. Comprueba que el código pertenezca al entorno seleccionado en Sandbox Mode (un código de producción para producción, un código de sandbox para el sandbox), genera un código nuevo y guarda de nuevo. Si la página indica que no se pudo generar un par de claves RSA, pide a tu proveedor de hosting que active la extensión OpenSSL de PHP.

Satispay desapareció de la finalización de compra al cambiar de sandbox a producción: el sandbox y la producción usan claves distintas. Pega un código de activación de producción con Sandbox Mode desmarcado y guarda.

El pedido está On hold y la nota no coincide con el pedido: Satispay informó de un importe o una moneda distintos del total del pedido, por ejemplo porque el pedido se editó después de iniciar el pago. Revisa el pago en el Satispay Dashboard y luego completa el pedido o reembolsa el pago.

El reembolso falla porque el entorno ya no está conectado: el pago se hizo en producción o en sandbox, y ese entorno ya no tiene claves. Vuelve a conectarlo con un código de activación, o reembolsa el pago desde el Satispay Dashboard.

El reembolso falla porque Satispay no aceptó el reembolso: Satispay devolvió un estado distinto de accepted. WooCommerce no registró el reembolso. Compruébalo en el Satispay Dashboard.

El bloque de licencia muestra un 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 para 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. La configuración del método de pago, las claves de Satispay de ambos entornos y los registros del plugin solo se eliminan si Delete data on uninstall estaba activado. Si no, se conservan para una futura reinstalación. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.

Satispay es una marca comercial de su respectivo titular. Este plugin no está afiliado a Satispay ni cuenta con su aprobación.