VibeFox 2C2P for WooCommerce — Ayuda

Requisitos

WordPress: 5.8 o posterior.

WooCommerce: 6.0 o posterior, instalado y activo. Sin WooCommerce, el plugin muestra un aviso en el área de administración y el método de pago no se carga.

PHP: 8.0 o posterior.

Cuenta de 2C2P: necesitas el Merchant ID y la Secret Key de tu cuenta de comerciante de 2C2P. 2C2P los emite cuando se abre la cuenta de comerciante. Las cuentas de sandbox y de producción tienen claves distintas. La documentación para desarrolladores y las tarjetas de prueba del sandbox están en developer.2c2p.com.

Moneda: la moneda de la tienda debe ser compatible con el plugin y estar activada en tu cuenta de 2C2P. Son compatibles, entre otras, THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR y GBP. Si la moneda de la tienda no es compatible, el método de pago se oculta en la finalización de compra.

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

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Payments > 2C2P > 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 ID y la Secret Key de tu sandbox, activa Enable/Disable y haz un pedido de prueba.

6. Cuando estés listo, introduce las credenciales de producción y desmarca Sandbox Mode.

Las URL de retorno y de notificación se envían con cada pago. No hay que configurar nada en el portal de 2C2P.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > 2C2P. Encima de los campos, la página muestra Sandbox mode is active. No real transactions will be processed. mientras el modo sandbox está activado. Avisa cuando la pasarela está activada pero el Merchant ID o la Secret Key del modo actual están vacíos, y cuando la moneda de la tienda no es compatible. En ambos casos el método de pago se oculta en la finalización de compra. Al guardar con Sandbox Mode desactivado, el plugin pide el Merchant ID y la Secret Key de producción si están vacíos.

General

Enable/Disable: Enable 2C2P Payment 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: 2C2P Payment.

Description: el texto que se muestra debajo del método de pago en la finalización de compra. Por defecto: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. En modo sandbox se le añade (TEST MODE).

Modo de prueba (sandbox)

Sandbox Mode: Enable sandbox / test mode envía los pagos al sandbox de 2C2P (demo2.2c2p.com) con las credenciales de sandbox de abajo. Por defecto: activado. Desmárcalo para aceptar pagos reales.

Sandbox Merchant ID: tu Merchant ID de 2C2P para el sandbox.

Sandbox Secret Key: tu Secret Key de 2C2P para el sandbox.

Credenciales de la API de producción

Se usan cuando el modo sandbox está desactivado.

Merchant ID: tu Merchant ID de 2C2P de producción. Obligatorio cuando el modo sandbox está desactivado.

Secret Key: tu Secret Key de 2C2P de producción. Obligatoria cuando el modo sandbox está desactivado. La clave se guarda exactamente como la introduces, incluidas las comillas y las barras invertidas.

Página de pago

Esta sección muestra, a modo de referencia, la URL de retorno para el cliente (frontend), https://your-site/?wc-api=tc2p_p, y la URL de notificación del servidor (backend), https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1. Se envían automáticamente con cada pago.

Payment Page Language: el idioma de la página de pago de 2C2P. Por defecto: English.

Redirect API version: mantén 8.5 a menos que 2C2P te indique que tu cuenta todavía usa la versión antigua 7.0 (firmas SHA-1). Los resultados de los pagos iniciados antes de un cambio se siguen verificando.

Order ID prefix: opcional, solo letras y dígitos (máximo 10), por ejemplo SHOP1. 2C2P rechaza un ID de pedido que ya ha recibido. Pon un prefijo único cuando varias tiendas compartan una cuenta de 2C2P, y también en el sandbox, donde las cuentas de comerciante de prueba se comparten. Los demás caracteres se eliminan al guardar, con un aviso.

Ajustes avanzados

Enable Logging: Log 2C2P events escribe en WooCommerce > Status > Logs, origen wcp_2c2p_payment. No se registran datos de tarjetas ni claves secretas. Por defecto: desactivado.

Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted. Por defecto: desactivado.

Finalizar compra

El cliente elige el método de pago (por defecto, 2C2P Payment) y realiza el pedido. La página siguiente muestra Thank you for your order. You will be redirected to 2C2P to complete your payment. y envía al cliente a la página de pago de 2C2P tras un momento. Si no ocurre, el cliente hace clic en Pay via 2C2P. La página también tiene un botón Cancel order.

En la página de 2C2P, el cliente paga con cualquier método activado en tu cuenta de 2C2P, por ejemplo tarjetas, monederos electrónicos, pagos con QR, banca en línea o pagos en efectivo. El plugin envía a 2C2P el total del pedido en la moneda del pedido, el correo electrónico de facturación del cliente y los nombres de los productos pedidos. El pago se puede completar en un plazo de 24 horas.

2C2P informa del resultado dos veces: el navegador del cliente vuelve a la tienda y 2C2P envía una notificación servidor a servidor. Ambas se tratan de la misma forma. El pedido se marca como pagado solo después de que 2C2P lo confirme con una firma válida. Además, el resultado debe pertenecer al pedido: se comprueban el Merchant ID, la clave del pedido (order key), el ID del pedido y el método de pago. Los resultados sin firma válida se rechazan.

Tras un pago correcto o pendiente, el cliente llega a la página de pedido recibido y el carrito se vacía. Si el pago no se completó, el cliente vuelve a la finalización de compra con el mensaje Payment was not completed. Please try again or choose a different payment method. El pedido se cancela, el carrito se conserva y el cliente realiza un pedido nuevo. Si el resultado no se puede confirmar, el cliente ve We could not confirm the payment result. If your account was charged, please contact us before paying again.

El método de pago funciona en la finalización de compra clásica y en el bloque de Finalizar compra. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).

El plugin no admite reembolsos desde WooCommerce, no guarda tarjetas, no gestiona pagos recurrentes ni WooCommerce Subscriptions, no tiene campos de tarjeta en tu sitio y no admite la API 2C2P PGW 4.x.

Pedidos

Estados del pedido

Pending payment: el cliente fue enviado a 2C2P y todavía no ha llegado ningún resultado.

Processing or Completed: 2C2P informó de un pago correcto (estado 000). WooCommerce asigna Processing, o Completed para pedidos que solo contienen productos virtuales descargables. La nota del pedido muestra la transacción de 2C2P, el código de aprobación, la fecha y el canal de pago. El ID de la transacción es la referencia de transacción de 2C2P.

On hold: el pago está pendiente en 2C2P (estado 001), por ejemplo un pago en efectivo que el cliente todavía no ha hecho. El pedido pasa a pagado cuando 2C2P informa del pago. Un pedido también pasa a espera cuando 2C2P informa de un importe o una moneda distintos al total del pedido. La nota del pedido muestra los valores recibidos y los esperados. Revisa el pedido y la transacción en el portal de comerciante de 2C2P.

Cancelled: el pago fue rechazado, cancelado por el cliente o falló (estados 002, 003, 999). La nota del pedido muestra el estado y el motivo.

Un pedido pagado o reembolsado nunca se modifica con un resultado posterior, y un resultado antiguo repetido no reabre un pedido que hayas cancelado.

Reembolsos

No se admiten reembolsos desde WooCommerce. Haz el reembolso del pago en el portal de comerciante de 2C2P y, después, crea un reembolso manual 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 > 2C2P. 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 comprobar el estado de nuevo, Change key para introducir otra clave y Remove key para eliminarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.

Una clave funciona en un dominio. Eliminar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, 2C2P 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 que hayan iniciado sesión 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 aviso 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.

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

2C2P 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 un Merchant ID y una Secret Key: los campos del sandbox en modo sandbox, y los de producción en modo de producción. Comprueba que la moneda de la tienda sea compatible. La página de ajustes muestra un aviso en ambos casos.

El pago se realizó, pero el pedido sigue en Pending payment: no ha llegado a tu tienda ningún resultado válido. Comprueba que el Merchant ID y la Secret Key del modo actual coincidan con la cuenta de 2C2P con la que se hizo el pago, y que Redirect API version coincida con tu cuenta. Un resultado con una firma incorrecta o para otro Merchant ID se rechaza. Activa Enable Logging y busca mensajes sobre hash o Merchant ID en WooCommerce > Status > Logs. Comprueba también que tu servidor acepte las solicitudes de 2C2P a la URL de notificación del servidor (backend).

2C2P indica que el ID de pedido ya existe: 2C2P no acepta el mismo ID de pedido dos veces. Esto ocurre cuando varias tiendas comparten una cuenta de 2C2P o en el sandbox, donde muchos desarrolladores comparten cuentas de comerciante de demostración. Define un Order ID prefix único.

Se realizó un pago, pero el pedido está On hold: el pago sigue pendiente en 2C2P (por ejemplo, un pago en efectivo que el cliente todavía no ha hecho) o el importe o la moneda pagados no coincidían con el pedido. Revisa las notas del pedido y la transacción en el portal de comerciante de 2C2P.

El cliente ve el mensaje This payment method is currently unavailable for this order: la moneda del pedido no es compatible, o el Merchant ID o la Secret Key del modo actual están vacíos.

Al guardar aparece Please enter your live Merchant ID or Please enter your live Secret Key: el modo sandbox está desactivado y hay un campo de producción vacío. Introduce las credenciales de producción o deja activado Sandbox Mode.

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. Los ajustes de la pasarela, los datos de 2C2P guardados en los pedidos y los archivos de registro 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 e ID de transacción.

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