VibeFox Pin Payments for WooCommerce — Ayuda

Requisitos

WordPress: 6.2 o posterior.

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

PHP: 8.0 o posterior.

HTTPS: tu finalización de compra debe usar HTTPS, como se requiere para aceptar pagos con tarjeta (PCI DSS). Los datos de la tarjeta se envían desde el navegador del cliente directamente a Pin Payments mediante Pin.js y nunca llegan a tu servidor, por lo que la tienda entra en el ámbito de PCI SAQ A-EP.

Cuenta de Pin Payments: una cuenta de comerciante de Pin Payments (para empresas de Australia o Nueva Zelanda; los clientes pueden pagar desde cualquier lugar). Necesitas su clave publicable y su clave secreta, para producción y, para las pruebas, para el entorno de prueba. No se necesita un secreto de webhook: el plugin no usa webhooks.

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

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Payments > Pin Payments > Manage, o haz clic en Settings debajo del 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. En el panel de Pin Payments abre Account > API Keys y copia tus claves de prueba en Test publishable key y Test secret key. Deja activado Test mode, activa Enable/Disable y guarda.

6. Haz un pedido de prueba con una tarjeta de prueba de Pin Payments. Cuando todo funcione, introduce las claves de producción, desactiva Test mode y guarda.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Pin Payments. Encima de los campos, la página muestra un aviso mientras el modo de prueba está activado, un error mientras la clave publicable o la clave secreta del modo actual está vacía, y un error cuando Pin Payments no admite la moneda de la tienda (con la lista de monedas admitidas). En los dos últimos casos la pasarela se oculta en la finalización de compra. Después de guardar, los avisos ya reflejan el nuevo modo y las nuevas claves. En la lista de métodos de pago, la pasarela aparece como pendiente de configuración hasta que el modo actual tenga las dos claves.

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

Title: el título del método de pago que se muestra en la finalización de compra. Por defecto: Credit card (Pin Payments).

Description: la descripción del método de pago que se muestra en la finalización de compra. Por defecto: Pay with your credit card via Pin Payments.

Claves de API

Encontrarás tus claves en el panel de Pin Payments, en Account > API Keys. Las claves de prueba solo funcionan con la API de prueba, y las de producción solo con la API de producción. La clave publicable la usa Pin.js en el navegador del cliente. La clave secreta nunca sale de tu servidor.

Test mode: Enable test mode. Usa el entorno de prueba de Pin Payments (test-api.pinpayments.com) y las claves de prueba. No se realiza ningún cargo real, y los clientes ven TEST MODE — no real charges will be made. en el formulario de tarjeta. Cuando está desactivado, se usan la API de producción (api.pinpayments.com) y las claves de producción. Por defecto: activado.

Test publishable key: la clave publicable de tu cuenta de prueba de Pin Payments.

Test secret key: la clave secreta de tu cuenta de prueba de Pin Payments. Es un campo de contraseña.

Live publishable key: la clave publicable de tu cuenta de producción de Pin Payments.

Live secret key: la clave secreta de tu cuenta de producción de Pin Payments. Es un campo de contraseña.

Los espacios alrededor de las claves se eliminan. Ambas claves del modo actual deben estar rellenas; de lo contrario, la pasarela no se muestra en la finalización de compra.

Avanzado

Debug log: Log Pin Payments API calls — los registros se guardan en WooCommerce > Status > Logs, origen wcp_pinpayments_gateway. Los errores siempre se registran; actívalo para registrar también cada llamada a la API. Los datos de tarjeta, las claves de API y los datos personales de los clientes nunca se registran. Por defecto: desactivado.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. Desactivar el plugin nunca borra nada. Los datos de pago guardados en los pedidos siempre se conservan. Por defecto: desactivado.

Finalización de compra

El cliente elige el método de pago (por defecto Credit card (Pin Payments), con los iconos de Visa, Mastercard y American Express) y completa Card number, Expiry (MM / YY), CVC y Name on card en tu finalización de compra. Antes de enviar, el formulario de tarjeta comprueba la longitud del número de tarjeta, el mes y el año de caducidad, un CVC de 3 o 4 dígitos y el nombre.

Al realizar el pedido, Pin.js envía desde el navegador los datos de la tarjeta y la dirección de facturación directamente a Pin Payments y obtiene un token de tarjeta de un solo uso. Solo este token se envía a tu servidor. Después, tu servidor crea un cargo capturado por el total del pedido en la moneda del pedido, con la descripción <store name> - Order <number>. Pin Payments responde en la misma solicitud. El pedido se marca como pagado solo cuando Pin Payments informa de un cargo correcto, y solo por exactamente el importe y la moneda del pedido. Después, el cliente llega a la página de pedido recibido.

Solo se ejecuta un intento de pago por pedido a la vez. Un segundo envío recibe Este pedido ya se está pagando. Espera un momento y revisa tu correo electrónico antes de volver a intentarlo. Un pedido que ya está pagado, o cargado y retenido, nunca se vuelve a cobrar. Un token de tarjeta solo puede usarse una vez: después de un intento fallido, o cuando el cliente cambia los datos de la tarjeta, se crea un token nuevo.

Mensajes que puede ver el cliente: Tu tarjeta ha sido rechazada. Usa otra tarjeta o contacta con tu banco.; Tu tarjeta no tiene fondos suficientes. Usa otra tarjeta.; Tu tarjeta ha caducado. Usa otra tarjeta.; El código de seguridad de la tarjeta (CVC) es incorrecto.; Este tipo de tarjeta no se acepta. Usa Visa, Mastercard o American Express.; Error en el pago: con el motivo de Pin Payments por los datos rechazados; Los datos de tu tarjeta han caducado. Vuelve a introducirlos e inténtalo de nuevo. cuando el token no se puede usar; No se pudo cargar el formulario seguro de tarjeta. Recarga la página o elige otro método de pago. cuando Pin.js no se carga; Los pagos con tarjeta no están disponibles temporalmente. Inténtalo más tarde o elige otro método de pago. cuando Pin Payments rechaza la clave secreta; No hemos podido confirmar tu pago con Pin Payments. Revisa tu correo electrónico y el extracto de tu tarjeta antes de volver a intentarlo, o contacta con nosotros. cuando Pin Payments no responde. Los detalles técnicos se guardan en las notas del pedido y en el registro.

El método de pago funciona en la finalización de compra clásica, en el bloque de Finalizar compra (con los mismos campos de tarjeta) y en la página Pay for order. Es compatible con High-Performance Order Storage (HPOS) de WooCommerce.

El plugin no tiene flujo de 3-D Secure. Si tu cuenta de Pin Payments requiere 3-D Secure, el cargo queda pendiente y el plugin marca el pedido como fallido, así que ese intento no cobra dinero; el cliente ve El pago con tu tarjeta no se pudo completar (se requiere verificación adicional). Prueba con otra tarjeta u otro método de pago. No hay modo de solo autorización con captura posterior, ni tarjetas guardadas, ni WooCommerce Subscriptions, ni Apple Pay o Google Pay, ni webhooks.

Pedidos y reembolsos

Estados del pedido

Processing: Pin Payments informó de un cargo correcto y capturado por exactamente el importe y la moneda del pedido. Los pedidos con solo productos virtuales descargables pasan a Completado, el valor predeterminado de WooCommerce. La nota del pedido muestra el importe y el token del cargo (y TEST MODE en los pagos de prueba). El ID de transacción es el token de cargo de Pin Payments.

Failed: la tarjeta fue rechazada, el cargo quedó pendiente (3-D Secure), Pin Payments rechazó la clave secreta o la solicitud. Cada intento fallido añade una nota al pedido con el código de error y el mensaje de Pin Payments, también cuando el pedido ya estaba como Fallido por un intento anterior. El cliente puede volver a intentarlo con el mismo pedido.

Pending payment: Pin Payments no dio una respuesta clara (tiempo de espera agotado, error del servidor, respuesta ilegible). El pedido no se marca como fallido, porque el cargo puede haberse creado igualmente. La nota indica que busques la descripción del cargo en el panel de Pin Payments antes de que el cliente vuelva a pagar o de enviar el pedido. Ese estado es Pendiente de pago.

On hold: Pin Payments cobró un importe o una moneda distintos a los del pedido (la nota muestra el importe esperado y el cobrado), o el cargo está autorizado pero no capturado. Revisa el cargo en el panel de Pin Payments antes de procesar el pedido.

Reembolsos

Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Credit card (Pin Payments) (el botón muestra tu Title). Se admiten reembolsos totales y parciales. El reembolso se envía al entorno (prueba o producción) en el que se pagó el pedido, así que la clave secreta de ese modo debe estar configurada. Una solicitud correcta añade una nota al pedido con el importe, el token de reembolso de Pin Payments y su estado. Pin Payments procesa los reembolsos de forma asíncrona, por lo que el estado suele ser Pending. Si Pin Payments rechaza el reembolso o no responde, WooCommerce muestra el error y no se registra ningún reembolso.

Los reembolsos hechos en el panel de Pin Payments no se sincronizan con WooCommerce, así que hazlos desde 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 > Pin Payments. 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 eliminarla 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, Pin Payments no se muestra a los clientes en la finalización de compra. Si se inicia un pago de todos modos, el cliente ve Este método de pago no está disponible. Elige otro. Los gestores de la tienda con sesión iniciada 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. Aparece un recordatorio en la página de Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los reembolsos siguen funcionando.

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

Pin Payments no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que ambas claves del modo actual están rellenas (Test publishable key y Test secret key en modo de prueba, las claves de producción en el resto de casos) y que la moneda del carrito es una de las 14 monedas admitidas. En la página Pay for order cuenta la moneda del pedido. La página de configuración muestra un error si faltan claves o si la moneda no está admitida.

En la finalización de compra aparece «No hemos podido confirmar tu pago»: Pin Payments no respondió a tiempo. El pedido permanece en Pendiente de pago con una nota. Busca en el panel de Pin Payments un cargo con la descripción <store name> - Order <number> antes de que el cliente vuelva a pagar o de enviar el pedido. El plugin no busca ese cargo automáticamente, y un nuevo intento crea un cargo nuevo.

Los clientes ven «Los pagos con tarjeta no están disponibles temporalmente»: Pin Payments rechazó la clave secreta. La nota del pedido indica que compruebes las claves del modo actual. Las claves de prueba solo funcionan en modo de prueba, y las de producción solo en modo de producción.

Los pedidos fallan con «se requiere verificación adicional»: tu cuenta de Pin Payments requiere 3-D Secure, que el plugin no admite. Pide a Pin Payments que desactive el 3-D Secure obligatorio.

Un pedido está En espera con una nota «does not match»: Pin Payments informó de un importe o una moneda del cargo distintos a los del pedido. Revisa el cargo en el panel de Pin Payments y reembolsa o completa el pedido manualmente.

No se pudo cargar el formulario seguro de tarjeta: Pin.js desde la CDN de Pin Payments no se cargó en el navegador, por ejemplo por un bloqueador de scripts o por un plugin de caché u optimización que modifica los scripts. Excluye la finalización de compra de esas optimizaciones.

Falla el reembolso: lee el mensaje. Un mensaje sobre el modo TEST o LIVE significa que la clave secreta del modo con el que se pagó el pedido está vacía. Pin Payments no confirmó el reembolso significa que no llegó respuesta; revisa el cargo en el panel de Pin Payments antes de volver a intentarlo.

Error de pago con un motivo de Pin Payments: Pin Payments rechazó los datos del cargo, por ejemplo un importe inferior a su cargo mínimo para la moneda. El cliente ve el motivo, y la nota del pedido contiene el código de error.

Pagos de prueba: el modo de prueba usa el entorno de prueba y las claves de prueba. Usa las tarjetas de prueba de la documentación para desarrolladores de Pin Payments, por ejemplo 4200 0000 0000 0000 (correcta) o 4100 0000 0000 0001 (rechazada), con cualquier fecha de caducidad futura y cualquier CVC. Los pedidos conservan el modo en el que se pagaron, así que los reembolsos van al entorno correcto después de cambiar de modo.

Dónde encontrar los errores: los errores se escriben siempre en WooCommerce > Status > Logs, origen wcp_pinpayments_gateway. Activa Debug log para ver cada llamada a la API.

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.

Para desarrolladores: el filtro wc_ppg_supported_currencies cambia la lista de monedas, y wc_ppg_icon cambia el icono de la lista de métodos de pago de WooCommerce.

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, las opciones de versión del plugin y sus registros (archivos de registro, incluidos los rotados, y entradas de registro de la base de datos) se eliminan solo si Delete data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los datos de pago guardados en los pedidos, como el token de cargo de Pin Payments, nunca se eliminan. Los pedidos existentes conservan sus notas de pago e ID de transacción.

Pin Payments es una marca comercial de su respectivo titular. Este plugin no está afiliado ni respaldado por Pin Payments.