VibeFox SimplePay 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.
Moneda de la tienda: HUF, EUR o USD. SimplePay no acepta otras monedas, y el método de pago no se ofrece para ellas.
Cuentas de comerciante de SimplePay: SimplePay da una cuenta de comerciante distinta para cada moneda, y cuentas separadas para producción y sandbox. Para cada cuenta necesitas su MERCHANT y su SECRET KEY del panel de comerciante de SimplePay (admin.simplepay.hu para producción, sandbox.simplepay.hu para sandbox), cuenta > Datos técnicos. Si vendes solo en HUF, basta con la cuenta en HUF. No se necesitan otras claves.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo 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_simplepay_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > SimplePay (OTP) > 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. Introduce el MERCHANT y la SECRET KEY de tus cuentas de SimplePay para cada moneda en la que vendes: cuentas de sandbox para las pruebas y cuentas de producción para los pagos reales (ver Configuración).
6. Copia la IPN URL que aparece en la página de ajustes en cada cuenta de comerciante (producción y sandbox) del panel de comerciante de SimplePay.
7. Activa Enable/Disable, haz una prueba de pago con Sandbox mode activado y después desmarca la casilla Sandbox mode para cobrar pagos reales.
Al actualizar desde la versión 1.0, el Merchant ID y la Secret key únicos de la 1.0 se trasladan a la cuenta de la moneda de la tienda, en el modo que estaba activo (sandbox o producción). Revisa las cuentas después de la actualización.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > SimplePay (OTP). Encima de los campos, la página te avisa cuando la moneda de la tienda no es compatible con SimplePay, o cuando la moneda de la tienda no tiene cuenta de comerciante en el modo actual. En ambos casos, el método de pago no se ofrece para pedidos en esa moneda. Mientras el modo sandbox está activado, la página muestra Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. En la lista de métodos de pago, SimplePay aparece marcado como pendiente de configuración hasta que el modo actual tenga al menos una cuenta de comerciante.
General
Enable/Disable: Enable SimplePay 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: SimplePay (Card Payment).
Description: el texto que aparece debajo del método de pago en la finalización de compra. Por defecto: Pay securely with your credit or debit card via SimplePay. Los comerciantes húngaros deben mostrar en la finalización de compra la declaración de transferencia de datos de SimplePay (Adattovábbítási nyilatkozat). Puedes ponerla aquí, con su enlace.
Sandbox mode: Use the SimplePay sandbox envía los pagos al sandbox de SimplePay y usa las cuentas de sandbox. Cambia tanto la dirección de la API como las cuentas de comerciante. No se cobra dinero real. Por defecto: activado. Desmarca la casilla para cobrar pagos reales con las cuentas de producción.
Live merchant accounts
Las cuentas que se usan cuando Sandbox mode está desactivado. Rellena las cuentas de las monedas en las que vende tu tienda. Los valores de MERCHANT y SECRET KEY están en el panel de comerciante de SimplePay (admin.simplepay.hu), cuenta > Datos técnicos. Una cuenta solo se usa cuando se rellenan ambos campos.
HUF account — Merchant ID: el MERCHANT de tu cuenta de producción en HUF.
HUF account — Secret key: la SECRET KEY de tu cuenta de producción en HUF.
EUR account — Merchant ID y EUR account — Secret key: lo mismo para tu cuenta de producción en EUR.
USD account — Merchant ID y USD account — Secret key: lo mismo para tu cuenta de producción en USD.
Sandbox merchant accounts
Las cuentas que se usan cuando Sandbox mode está activado. Los campos son los mismos que en las cuentas de producción: HUF account — Merchant ID, HUF account — Secret key y los mismos pares para EUR y USD. Toma los valores del panel de comerciante de sandbox de SimplePay (sandbox.simplepay.hu), cuenta > Datos técnicos.
IPN URL
El IPN es el mensaje que SimplePay envía a tu tienda cuando cambia el estado del pago. Es la forma habitual de que un pedido pase a pagado. La página de ajustes muestra la IPN URL de tu tienda. Tiene este aspecto: https://your-site/wc-api/simplepay_payment_callback/. Configura esta URL en cada cuenta de comerciante, de producción y de sandbox, en el panel de comerciante de SimplePay. Si tu sitio usa un prefijo de idioma en las URL o redirige otras direcciones, copia la URL exactamente como la muestran los ajustes, porque un IPN redirigido se pierde.
El IPN debe estar firmado con la SECRET KEY de la cuenta de comerciante que indica. Los IPN sin firma válida se rechazan. El plugin confirma a SimplePay cada IPN válido en la forma firmada que SimplePay exige. Estos estados del IPN cambian el pedido:
Los estados Fallido y Cancelado solo se aplican al último intento de pago de un pedido que sigue Pendiente de pago. Los demás estados se registran y no cambian el pedido. Sin el IPN, un pedido solo se confirma cuando el cliente vuelve a la tienda tras un pago correcto.
Orders
Order Status After Payment: el estado del pedido que se asigna tras un pago correcto. El estado se asigna de inmediato, sin un segundo cambio de estado.
Advanced
Logging: Enable logging escribe las llamadas a la API, los IPN y los retornos en WooCommerce > Status > Logs, origen wcp_simplepay_gateway. Las claves y los datos de los clientes no se registran. Los errores siempre se registran, incluso cuando esta opción está desactivada. Por defecto: desactivado.
Delete Data on Uninstall: Remove all plugin data when uninstalling. Cuando está activado, al borrar el plugin se eliminan los ajustes de la pasarela y los registros del plugin. Los datos de los pedidos siempre se conservan. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto SimplePay (Card Payment)) y realiza el pedido. El plugin inicia un pago con tarjeta de SimplePay por el total del pedido en la moneda del pedido, con la cuenta de comerciante de esa moneda en el modo actual, y envía al cliente a la página de pago de SimplePay. La página muestra lo que permita tu cuenta de comerciante para los pagos con tarjeta. El correo electrónico del cliente y, cuando está completa, la dirección de facturación se envían a SimplePay. La página de pago usa el idioma de tu sitio cuando SimplePay lo admite; si no, usa inglés. Un pago iniciado se puede pagar en un plazo de 30 minutos.
Tras un pago correcto, el cliente vuelve a la página de pedido recibido de tu tienda. El retorno por sí solo nunca paga un pedido: el plugin pide a SimplePay el estado de la transacción con una solicitud firmada, así que el pedido se confirma aunque el IPN llegue tarde. La página de pedido recibido muestra Successful transaction. SimplePay transaction ID: y el ID. Si el pago todavía no está confirmado, muestra Your payment is being confirmed by SimplePay. SimplePay transaction ID: y el ID.
Si el pago falla, se cancela o caduca, el cliente vuelve a la finalización de compra o, si el carrito está vacío, a la página Pay for order. Allí el cliente ve el mensaje de SimplePay con el ID de transacción, por ejemplo Cancelled payment. You cancelled the payment o Timeout. The time allowed to complete the payment has expired. Si el pago falla, se pide al cliente que revise los datos introducidos y que se ponga en contacto con el banco emisor de la tarjeta. El cliente puede volver a intentarlo. Cada nuevo intento recibe su propia referencia de SimplePay, por ejemplo 123, 123-2, 123-3.
Si SimplePay no puede iniciar el pago, el cliente ve The SimplePay payment could not be started. Please try again or choose another payment method. Si la moneda del pedido no tiene cuenta de comerciante, el mensaje es SimplePay is not available for the currency of this order. Please choose another payment method. El motivo técnico se añade a las notas del pedido y al registro. Los gestores de la tienda con sesión iniciada también lo ven en el mensaje.
El método de pago funciona en la finalización de compra clásica, en el bloque Finalizar compra y en la página Pay for order. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin solo acepta pagos únicos con tarjeta, cobrados en la página de SimplePay. No tiene tarjetas guardadas ni pagos con un clic, ni suscripciones o pagos recurrentes, ni autorización y captura por separado.
Pedidos y reembolsos
Order statuses
Pending payment: el cliente fue enviado a SimplePay y todavía no ha pagado, o SimplePay aún no ha confirmado el pago. La nota del pedido muestra la transacción iniciada, el importe y el modo (sandbox o producción).
Processing or Completed: el pago fue confirmado. El estado sigue a Order Status After Payment. La nota del pedido muestra el ID de transacción y si lo confirmó el IPN o la solicitud de estado. El ID de transacción de SimplePay se guarda como ID de transacción del pedido. Un pago correcto tardío también completa un pedido que estaba Fallido o Cancelado.
On hold: el total o la moneda del pedido cambió después de iniciar el pago, así que el importe pagado no coincide con el pedido. La nota del pedido muestra ambos importes. Revisa el pedido y procésalo, o reembolsa el pago.
Failed: SimplePay informó de que el último intento de pago no fue autorizado o fue fraudulento.
Cancelled: SimplePay informó de que el último intento de pago caducó o fue cancelado.
Un pedido reembolsado o completado nunca vuelve a abrirse por un IPN tardío. Si un segundo pago se realiza correctamente para un pedido que ya está pagado, el pedido no se vuelve a cambiar. Una nota te pide que lo revises en el panel de SimplePay y que lo reembolses si es un duplicado.
Refunds
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via SimplePay (OTP). Se admiten reembolsos totales y parciales. Los reembolsos en HUF deben ser en forintos enteros. El reembolso se envía con la cuenta de comerciante y en el modo (sandbox o producción) con los que se hizo el pago, así que esa cuenta debe seguir en los ajustes. Si SimplePay no acepta el reembolso, WooCommerce muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade a las notas del pedido con el ID de transacción de reembolso de SimplePay y el motivo, si lo indicaste.
Los reembolsos hechos en el panel de comerciante de SimplePay no se sincronizan con WooCommerce. Regístralos manualmente en WooCommerce, sin usar Refund via SimplePay (OTP).
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 > SimplePay (OTP). 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 solo dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, SimplePay 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. Los gestores de la tienda con sesión iniciada 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 Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los pagos ya iniciados siguen confirmándose y los reembolsos funcionan.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
SimplePay no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que la moneda del pedido es HUF, EUR o USD, y que esa moneda tiene Merchant ID y Secret key en el modo actual: las cuentas de sandbox mientras Sandbox mode esté activado, y las cuentas de producción mientras esté desactivado. La página de ajustes muestra un aviso cuando la moneda de la tienda no tiene cuenta.
El pago se realizó, pero el pedido sigue Pendiente de pago: el IPN no llegó a la tienda. En el panel de comerciante de SimplePay, comprueba la IPN URL de la cuenta de comerciante que usas (producción o sandbox, la moneda del pedido). Debe ser exactamente la URL que muestran los ajustes, y tu servidor debe ser accesible desde internet. El pedido también se confirma cuando el cliente vuelve a la tienda después de pagar.
El IPN responde Invalid signature: el IPN indica una cuenta de comerciante que no está en los ajustes, o su Secret key es incorrecta. Introduce el MERCHANT y la SECRET KEY exactamente como los muestra el panel de comerciante de SimplePay. SimplePay repite los IPN no confirmados.
El IPN responde Order not found o Unknown transaction: el IPN es para un pedido o una transacción que esta tienda no inició. El pedido no se modifica.
El IPN responde Busy, retry: el pedido se estaba confirmando con otra solicitud en ese mismo momento. SimplePay vuelve a enviar el IPN.
El cliente ve un error al realizar el pedido: abre las notas del pedido o revisa WooCommerce > Status > Logs, origen wcp_simplepay_gateway. Una Secret key incorrecta da Invalid response signature from SimplePay. Check the secret key of the merchant account. Los errores de SimplePay se muestran como SimplePay error code(s): seguido de los códigos.
Tras cambiar entre sandbox y producción: los nuevos pagos usan las cuentas del nuevo modo. Los pedidos iniciados antes conservan la cuenta de comerciante y el modo con los que se iniciaron: sus IPN, solicitudes de estado y reembolsos usan esa cuenta. Mantén en los ajustes las cuentas del modo anterior mientras esos pedidos estén abiertos o puedan reembolsarse.
El pedido está En espera tras el pago: lee la nota del pedido. El total o la moneda del pedido cambiaron después de iniciar el pago. Procesa el pedido o reembolsa el pago.
Falla el reembolso: lee el mensaje. SimplePay refunds in HUF must be whole amounts. significa que el importe en HUF tenía decimales. Si el mensaje dice que la cuenta de comerciante de este pago no está configurada, vuelve a introducir la cuenta (moneda y modo) con la que se hizo el pago. Si SimplePay reembolsó un importe distinto, el mensaje te pide que revises el reembolso en el panel de SimplePay.
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 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 y los registros del plugin solo se eliminan si Delete Data on Uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago, ID de transacción y datos de SimplePay.
SimplePay es una marca comercial de su respectivo propietario. Este plugin no está afiliado ni avalado por SimplePay.