VibeFox ePay.bg for WooCommerce — Ayuda

Requisitos

WordPress: 6.0 o posterior.

WooCommerce: 7.0 o posterior, instalado y activo.

PHP: 8.0 o posterior.

Moneda de la tienda: leva búlgaro (BGN), euro (EUR) o dólar estadounidense (USD). El pedido se cobra en su propia moneda con 2 decimales. Para otras monedas, el método de pago se oculta en la finalización de compra.

Cuenta de ePay.bg: necesitas el número de cliente (MIN) y la clave secreta de tu perfil de comerciante de ePay.bg: los reales desde www.epay.bg y los de prueba desde demo.epay.bg (la cuenta de prueba se registra por separado). También debes introducir la URL de notificación de tu tienda en el perfil de comerciante.

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

2. Haz clic en Activate. WooCommerce debe estar activo.

3. Abre los ajustes: WooCommerce > Settings > Payments > ePay.bg > Manage, o haz clic en Settings bajo el 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 MIN y la clave secreta de prueba y/o reales (consulta Configuración).

6. Copia la URL de notificación que aparece en la sección Payment notifications (IPN) en el campo URL for receiving notifications del perfil de comerciante de ePay.bg, tanto en el perfil demo como en el real. Sin ella, los pedidos se quedan en «Pendiente de pago».

7. Activa Enable/Disable. Haz un pedido de prueba en modo de prueba y después desmarca Test Mode.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > ePay.bg. Encima de los campos, la página muestra un error cuando la moneda de la tienda no es BGN, EUR ni USD, una advertencia cuando la pasarela está activada pero el MIN o la clave secreta del modo seleccionado están vacíos (entonces se oculta en la finalización de compra y, al guardar, se muestra el mismo error), y Test mode is on: payments go to demo.epay.bg and no real money is charged. mientras el modo de prueba está activado. En la lista de métodos de pago, ePay.bg aparece marcado como pendiente de configurar hasta que se introducen las credenciales del modo seleccionado.

General

Enable/Disable: Enable ePay.bg Payment Gateway activa o desactiva el método de pago. Valor por defecto: desactivado.

Title: el nombre del método de pago que ven los clientes en la finalización de compra. Valor por defecto: ePay.bg.

Description: el texto que se muestra bajo el método de pago en la finalización de compra. Valor por defecto: Pay securely via ePay.bg with a bank card or your ePay.bg account.

Cuenta de ePay.bg

El número de cliente (MIN) y la clave secreta aparecen en tu perfil de comerciante en www.epay.bg (real) y demo.epay.bg (cuenta de prueba, registrada por separado). Los espacios y saltos de línea de las claves secretas pegadas se eliminan al guardar.

Test Mode: Enable test mode (use demo.epay.bg and the test credentials). Cuando está activado, los clientes son enviados al entorno demo de ePay.bg y las solicitudes se firman con las credenciales de prueba. Valor por defecto: activado.

Test Merchant ID (MIN): el número de cliente (MIN) de tu cuenta de comerciante de demo.epay.bg.

Test Secret Key: la clave secreta de tu cuenta de comerciante de demo.epay.bg (64 caracteres).

Live Merchant ID (MIN): el número de cliente (MIN) de tu cuenta de comerciante de www.epay.bg.

Live Secret Key: la clave secreta de tu cuenta de comerciante de www.epay.bg (64 caracteres), que se usa para la firma HMAC-SHA1.

Si actualizas desde la versión 1.0, el único conjunto de credenciales de esa versión se traslada a los campos de prueba cuando el modo de prueba estaba activado.

Notificaciones de pago (IPN)

La notificación informa a tu tienda de que una solicitud de pago se ha pagado, rechazado o ha caducado. Esta sección muestra la URL de notificación, que tiene este aspecto: https://your-site/wc-api/epaybg_payment_callback/. Introdúcela como URL for receiving notifications en el perfil de comerciante de ePay.bg, tanto el real como el de prueba. Los pedidos solo se marcan como pagados con estas notificaciones firmadas; el regreso del cliente a la tienda no marca un pedido como pagado.

ePay.bg comunica estos resultados para cada factura:

Cada notificación se comprueba con la clave secreta del modo seleccionado. Las notificaciones sin una suma de verificación válida se rechazan y ePay.bg sigue enviándolas. Sin la URL de notificación en el perfil de comerciante, ningún pedido se marca como pagado.

Solicitud de pago

Invoice Prefix: solo dígitos (hasta 10), que se colocan delante del ID del pedido para formar el número de factura de ePay.bg, por ejemplo 00001 + 123 = 00001123. Usa prefijos distintos para tiendas distintas en una misma cuenta de ePay.bg. Los demás caracteres se eliminan al guardar. Cambiar el prefijo más adelante es seguro: los pedidos pendientes se localizan por la factura guardada en el pedido. Valor por defecto: 00001.

Expiration Time: el tiempo tras el cual caduca una solicitud de pago sin pagar; entonces ePay.bg la comunica como caducada y el pedido pendiente se cancela. Elige 1, 3, 6, 12, 24, 48 o 72 horas. La hora se envía en hora de Bulgaria, sea cual sea la zona horaria de tu sitio. Valor por defecto: 24 horas.

Language: el idioma de la página de pago de ePay.bg, inglés o búlgaro. Valor por defecto: inglés.

Order Status After Payment: el estado del pedido que se establece tras un pago correcto. El estado se establece de inmediato, sin un segundo cambio de estado.

Avanzado

Logging: Enable logging escribe las solicitudes de pago y las notificaciones en WooCommerce > Status > Logs, fuente wcp_epaybg_gateway, sin claves secretas ni datos de tarjeta. Valor por defecto: desactivado.

Delete Data on Uninstall: Remove all plugin data when uninstalled. Si está marcado, los ajustes de la pasarela, los datos de ePay.bg guardados en los pedidos y los registros del plugin se eliminan al desinstalar el plugin. Valor por defecto: desactivado.

Finalización de compra

El cliente elige el método de pago (por defecto ePay.bg) y realiza el pedido. El cliente ve Redirecting to ePay.bg for payment... y es enviado a ePay.bg con una solicitud de pago firmada por el total del pedido en la moneda del pedido, con el número de factura y el tiempo de caducidad. La página también tiene un botón Pay via ePay.bg por si la redirección no se inicia, y un botón Cancel order. En ePay.bg el cliente paga con una tarjeta bancaria o con una cuenta de ePay.bg.

Tras pagar, el cliente vuelve a la página de pedido recibido de tu tienda. El pedido solo se marca como pagado cuando llega la notificación firmada de ePay.bg. El carrito solo se vacía en la página de pedido recibido.

Si el cliente cancela en ePay.bg, el pedido se cancela de la forma estándar de WooCommerce y se conserva el carrito, de modo que el cliente puede elegir otro método de pago.

Si el pedido no se puede pagar con ePay.bg, el cliente ve un mensaje breve, por ejemplo ePay.bg payments are temporarily unavailable. Please choose another payment method., o un aviso de que ePay.bg no acepta pagos en la moneda del pedido.

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 el almacenamiento de pedidos de alto rendimiento (HPOS) de WooCommerce.

El plugin solo admite pagos únicos en ePay.bg. No permite reembolsos desde WooCommerce, ni tarjetas guardadas o tokenización, ni suscripciones o pagos recurrentes, ni códigos de pago en efectivo de EasyPay o B-Pay.

Pedidos

Estados del pedido

Pending payment: el cliente fue enviado a ePay.bg y aún no ha pagado, o todavía no ha llegado la notificación. La nota del pedido dice Awaiting ePay.bg payment.

Processing, Completed or On Hold: el pago fue confirmado. El estado sigue lo indicado en Order Status After Payment. La nota del pedido muestra el número de factura, la fecha del pago, el STAN y el código BORICA. El ID de transacción es el STAN (o el número de factura si no hay STAN).

On hold after payment: el pago llegó, pero no por lo que dice ahora el pedido: el total o la moneda se cambió después de la solicitud de pago, la solicitud se hizo en el otro modo o la pasarela se cambió después entre prueba y real, se cambió el método de pago del pedido, o el pedido se había cancelado antes. La nota del pedido explica el motivo. Comprueba el pago en el panel de comerciante de ePay.bg y completa o reembolsa el pedido manualmente.

Cancelled: ePay.bg comunicó la solicitud de pago como rechazada o caducada, o el cliente canceló en ePay.bg. WooCommerce restablece las existencias. Un pedido cancelado no se puede volver a pagar, porque el número de factura de ePay.bg es el prefijo más el ID del pedido. El cliente debe hacer un pedido nuevo.

Un aviso tardío de rechazo o caducidad nunca modifica un pedido pagado. Si llega un pago de un pedido que ya está pagado o reembolsado, el estado no se cambia y una nota te pide que compruebes en el panel de comerciante de ePay.bg si hay un pago duplicado.

Reembolsos

Los reembolsos desde WooCommerce no están disponibles, porque la API WEB de ePay.bg no tiene una llamada de reembolso. Reembolsa el pago en el panel de comerciante de ePay.bg y registra el reembolso manualmente en WooCommerce.

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 > ePay.bg. 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. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, ePay.bg 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 de Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los pagos ya iniciados se siguen confirmando.

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

ePay.bg no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado, que el MIN y la clave secreta del modo seleccionado estén definidos y que la moneda de la tienda sea BGN, EUR o USD. La página de ajustes muestra una advertencia en cada uno de estos casos.

El pago se realizó, pero el pedido sigue en «Pendiente de pago»: el pedido solo se marca como pagado con la notificación de ePay.bg. Comprueba que la URL de notificación esté introducida en el perfil de comerciante de ePay.bg del modo que usas (demo o real) y que la clave secreta del modo activo sea correcta. Activa Logging y consulta WooCommerce > Status > Logs, fuente wcp_epaybg_gateway.

La notificación responde ERR=Not valid CHECKSUM: la clave secreta de los ajustes no coincide con el perfil de comerciante que envió la notificación. Las notificaciones se comprueban con la clave del modo seleccionado en ese momento y después con la clave del otro modo, de modo que las solicitudes de pago hechas antes de cambiar de modo siguen siendo aceptadas. ePay.bg sigue reintentando, así que el pedido se actualiza cuando la clave es correcta.

La notificación responde ERR=Not configured: la clave secreta del modo seleccionado está vacía. Introdúcela.

La notificación responde STATUS=NO para una factura: la factura no pertenece a un pedido de ePay.bg de esta tienda, por ejemplo porque la emitió otra tienda de la misma cuenta de ePay.bg. Da a cada tienda su propio Invoice Prefix.

La notificación responde STATUS=ERR: un error temporal, por ejemplo dos notificaciones del mismo pedido en el mismo momento. ePay.bg vuelve a enviar la notificación.

El pedido está «En espera» después del pago: lee la nota del pedido. El total o la moneda cambió después de la solicitud de pago, la solicitud se hizo en el otro modo o el modo se cambió después, cambió el método de pago o el pedido se había cancelado. Comprueba el pago en el panel de comerciante de ePay.bg.

El prefijo de factura se modificó al guardar: el prefijo solo puede contener dígitos, hasta 10. Los demás caracteres se eliminan.

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.

Para desarrolladores, el readme menciona el filtro epay_bp_form_fields, por ejemplo para usar la página directa de tarjeta (PAGE=credit_paydirect).

Desinstalación

Desactivar el plugin conserva todos los datos. Para eliminarlo, desactívalo y bórralo en la página de Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. Los ajustes de la pasarela, los datos de ePay.bg guardados en los pedidos y los registros solo se eliminan 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 e IDs de transacción.

ePay.bg es una marca comercial de su respectivo propietario. Este plugin no está afiliado a ePay.bg ni cuenta con su respaldo.