VibeFox Authorize.Net for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 7.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.
HTTPS: la finalización de compra debe usar HTTPS. Accept.js no se ejecuta sobre HTTP sin cifrar.
Cuenta de Authorize.Net: necesitas el API Login ID, la Transaction Key y la Public Client Key de tu cuenta de Authorize.Net, y una Signature Key si usas webhooks. Las cuentas de producción (account.authorize.net) y de sandbox (sandbox.authorize.net) tienen credenciales distintas. Las cuentas de Authorize.Net están disponibles para comerciantes de Estados Unidos, Canadá, Reino Unido, Europa, Australia y Nueva Zelanda.
Moneda: la moneda de la tienda debe ser USD, CAD, CHF, DKK, EUR, GBP, NOK, PLN, SEK, AUD o NZD, y tu cuenta de Authorize.Net debe liquidar en ella. Para otras monedas, 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_authorizenet_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Payments > Authorize.Net > 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 las credenciales de las cuentas de sandbox y de producción (consulta Configuración). Opcionalmente, configura el webhook.
6. Activa Enable/Disable, elige el Transaction type y guarda. Prueba un pago en modo sandbox con la tarjeta 4111 1111 1111 1111, cualquier fecha de caducidad futura y cualquier CVV, y después desmarca Sandbox mode.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Authorize.Net. Encima de los campos, la página te avisa cuando el sitio no usa HTTPS (Accept.js solo funciona en páginas HTTPS) y cuando la moneda de la tienda no es compatible (en ese caso el método de pago se oculta en la finalización de compra). La página muestra solo los campos de credenciales del modo seleccionado.
General
Enable/Disable: Enable Authorize.Net 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: Credit Card.
Description: el texto que se muestra encima del formulario de tarjeta en la finalización de compra. Por defecto: Pay securely with your credit card via Authorize.Net.
Credenciales de la API
En Merchant Interface de Authorize.Net, abre Account > Settings > Security Settings. En API Credentials & Keys copia el API Login ID y crea una Transaction Key y una Signature Key. En Manage Public Client Key copia la Public Client Key. Las cuentas de sandbox y de producción usan credenciales distintas.
Sandbox mode: Use the Authorize.Net sandbox (test transactions, no real charges). Cambia el endpoint de la API, Accept.js y el conjunto de credenciales de abajo. Por defecto: activado. Desmárcalo para aceptar pagos reales.
Live API Login ID y Sandbox API Login ID: el API Login ID de la cuenta de producción o de sandbox.
Live Transaction Key y Sandbox Transaction Key: la Transaction Key de esa cuenta.
Live Public Client Key y Sandbox Public Client Key: la clave pública que usa Accept.js en el navegador.
Live Signature Key y Sandbox Signature Key: necesarias solo para los webhooks. Verifican la cabecera X-ANET-Signature de cada notificación.
Pago
Transaction type: cómo se cobra la tarjeta. Una autorización caduca a los 30 días.
Webhooks (recomendado)
Sin webhooks, los pedidos retenidos por Fraud Detection Suite o capturados o anulados en el panel de Authorize.Net hay que actualizarlos a mano. En Merchant Interface ve a Account > Settings > Business Settings > Webhooks y haz clic en Add Endpoint. Usa la URL que aparece en esta sección de los ajustes. Tiene el aspecto de https://your-site/wc-api/wc_authorizenet/. Selecciona estos eventos:
Introduce la Signature Key de la cuenta en Live Signature Key o en Sandbox Signature Key. Los webhooks sin una firma válida se rechazan. Para cada notificación, el plugin también consulta a Authorize.Net el estado actual y el importe de la transacción antes de cambiar el pedido, así que las notificaciones repetidas no cambian nada.
Avanzado
Debug log: Log API requests and responses escribe en WooCommerce > Status > Logs, origen wcp_authorizenet_gateway. Las claves, los tokens de tarjeta y los datos personales se enmascaran. Por defecto: desactivado.
Delete data on uninstall: Remove the settings and the Authorize.Net order meta when the plugin is deleted. Por defecto: desactivado.
Finalizar compra
El cliente elige el método de pago (por defecto, Credit Card) e introduce el número de tarjeta, la fecha de caducidad (MM/YY) y el código de seguridad (CVV) en la página de finalización de compra. En modo sandbox, el formulario muestra una pista con la tarjeta de prueba 4111 1111 1111 1111. Al realizar el pedido, Accept.js intercambia los datos de la tarjeta por un token de un solo uso en el navegador. Los campos de tarjeta no tienen nombre de campo, así que el número de tarjeta y el CVV nunca se envían a tu servidor.
El plugin cobra el token a través de la API de Authorize.Net por el total del pedido en la moneda del pedido. La dirección de facturación, el correo electrónico y la dirección IP se envían con la transacción para la verificación de la dirección y los filtros antifraude. Si el pago se aprueba, el cliente pasa a la página de pedido recibido y el carrito se vacía.
Si la tarjeta es rechazada, el cliente permanece en la finalización de compra y ve Payment failed: seguido del motivo, por ejemplo tarjeta rechazada, código de seguridad incorrecto o tarjeta caducada. Los errores de configuración y de la API no se muestran a los clientes: ven un mensaje general, y los detalles van a la nota del pedido y al registro. Si la tienda no puede conectar con Authorize.Net, el cliente ve Payment error: unable to connect to the payment gateway. Please try again.
Los envíos repetidos del formulario y los pagos repetidos del mismo pedido nunca lo cobran por segunda vez. 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 de WooCommerce (HPOS).
El plugin no guarda tarjetas ni perfiles de cliente, no admite WooCommerce Subscriptions ni Pre-Orders, ni eCheck/ACH, Apple Pay, Google Pay, PayPal o 3-D Secure, y no admite la captura parcial de una autorización ni la conversión automática de moneda.
Pedidos y reembolsos
Estados del pedido
Processing or Completed: la tarjeta fue cobrada (Authorize and capture), o una autorización fue capturada. WooCommerce asigna Processing, o Completed para pedidos que solo contienen productos virtuales descargables. La nota del pedido muestra el importe, el ID de la transacción, el código de autorización, el tipo de tarjeta y las últimas cuatro cifras. El ID de la transacción es el Trans ID de Authorize.Net.
On hold: los fondos solo están autorizados (Authorize only), o Fraud Detection Suite retuvo la transacción para revisión. Aprueba o rechaza una transacción retenida en el panel de Authorize.Net; con webhooks, el pedido se actualiza automáticamente. Un pedido también pasa a espera cuando una captura notificada por webhook no coincide con el importe del pedido.
Cancelled: un webhook informó de que la transacción fue rechazada, anulada o caducó antes de que el pedido se pagara. Si esto ocurre con un pedido ya pagado, su estado no cambia y se añade una nota de advertencia.
Captura
Para un pedido con autorización, abre el pedido, elige Capture payment (Authorize.Net) en las acciones del pedido y haz clic en el botón de actualizar. Se captura todo el importe del pedido menos los reembolsos, y el pedido se marca como pagado. Si la captura falla, el error se muestra y se añade a las notas del pedido. También puedes capturar en el panel de Authorize.Net; con webhooks, el pedido se actualiza automáticamente.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Credit Card (el botón usa el título de tu método de pago). Un reembolso por el importe total del pedido primero anula la transacción si todavía no está liquidada, o una autorización que no se capturó. Las transacciones liquidadas, normalmente después de 24 horas, se pueden reembolsar totalmente o en parte. Antes de la liquidación no es posible un reembolso parcial: reembolsa el importe total para anular la transacción, o inténtalo de nuevo tras la liquidación. Si Authorize.Net no acepta el reembolso, WooCommerce muestra el error y no se registra ningún reembolso. Un reembolso o una anulación correctos se añaden a las notas del pedido.
Los reembolsos, las capturas y las comprobaciones por webhook de un pedido usan las credenciales del modo en el que se pagó el pedido, así que los pedidos del otro modo se pueden capturar y reembolsar también después de cambiar Sandbox mode. Conserva las credenciales de ese modo en sus campos hasta que esos pedidos estén terminados.
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 > Authorize.Net. 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, Authorize.Net 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 webhooks siguen procesándose y las capturas 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
Authorize.Net 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 API Login ID, Transaction Key y Public Client Key. Comprueba que la moneda de la tienda sea compatible; la página de ajustes muestra un aviso cuando no lo es.
El pago se realizó, pero el pedido sigue On hold: el tipo de transacción es Authorize only (captúralo con la acción de pedido), o Authorize.Net retuvo la transacción para revisión. Apruébala o recházala en el panel de Authorize.Net. Para que estos pedidos se actualicen automáticamente, configura el webhook: comprueba que la URL del endpoint sea exactamente la que aparece en los ajustes, que estén seleccionados los cuatro eventos y que esté introducida la Signature Key del modo actual.
El webhook responde con webhooks are not configured: no se ha introducido ninguna Signature Key en ninguno de los dos modos.
El webhook responde con invalid signature: la Signature Key pertenece a otra cuenta o modo. Crea o copia de nuevo la Signature Key y pégala en el campo de su modo.
El webhook responde con verification failed, retry later: la tienda no pudo leer la transacción de la API de Authorize.Net. Authorize.Net reintenta la entrega.
El formulario de tarjeta no carga o muestra The secure card form (Accept.js) could not be loaded: la finalización de compra debe usar HTTPS, y la Public Client Key y el API Login ID del modo actual deben ser correctos.
Payment error: the card could not be tokenized: Accept.js no devolvió un token. El cliente debe volver a introducir los datos de la tarjeta e intentarlo de nuevo.
El cliente ve un error general: revisa las notas del pedido o activa el Debug log y mira en WooCommerce > Status > Logs, origen wcp_authorizenet_gateway. Authorize.Net rechaza una moneda que la cuenta no admite.
Un reembolso parcial falla porque la transacción aún no está liquidada: reembolsa el importe total del pedido para anular la transacción, o inténtalo tras la liquidación, normalmente en un plazo de 24 horas.
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 Authorize.Net guardados en los pedidos y los registros 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.
Authorize.Net es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Authorize.Net ni cuenta con su respaldo.