=== Nave for WooCommerce === Contributors: jcabreranave Tags: woocommerce, payment, gateway, nave, argentina Requires at least: 6.0 Tested up to: 6.9 Stable tag: 1.0.3 Requires PHP: 8.0 Requires Plugins: woocommerce License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Método de pago por redirección para WooCommerce usando la API de Nave. == Description == El plugin oficial de Nave te permite aceptar pagos en tu tienda WooCommerce de forma rápida y segura. Tus clientes son redirigidos al checkout de Nave para completar el pago y vuelven automáticamente a tu tienda una vez finalizado. Para instalarlo no necesitás conocimientos técnicos: seguí el paso a paso de esta guía y empezá a vender hoy mismo. = ¿Qué podés hacer con Nave for WooCommerce? = * **Aceptá tarjetas, MODO y QR:** ofrecé Visa, Mastercard, Amex, Cabal, pagos con MODO y códigos QR desde un solo plugin. * **Probá antes de salir a producción:** usá el entorno Sandbox para testear tu integración sin riesgo. * **Aprovechá las promos bancarias:** tus clientes pueden acceder a las promociones vigentes de sus bancos al pagar con tarjeta. * **Número de operación visible:** tanto en "Mi cuenta" como en los emails de confirmación, el comprador recibe su número de operación para cualquier consulta o reclamo. * **Consultá el estado del pago desde el admin:** verificá en tiempo real el estado de un pago directamente desde la pantalla del pedido, con un botón o desde el menú de acciones. = Preparado para tu negocio = * **Compatible con Block Checkout (Gutenberg) y Checkout clásico:** funciona en ambos flujos de compra sin configuración extra. * **Compatible con HPOS:** soporte completo para WooCommerce High-Performance Order Storage. * **Seguridad integrada:** token criptográfico de un solo uso por orden, almacenamiento cifrado con AES-256-CBC, enmascaramiento de datos sensibles en logs y renovación automática de tokens OAuth. * **Procesamiento robusto:** reintentos con backoff exponencial, protección contra doble procesamiento de pagos (idempotencia) y reducción de stock garantizada en una sola operación. * **Logs integrados:** seguí cada paso del proceso de pago desde WooCommerce → Estado → Logs con el modo debug activado. ¡Impulsá tus ventas con Nave for WooCommerce! == Installation == 1. Subí la carpeta `nave-for-woocommerce` a `/wp-content/plugins/`. 2. Activá el plugin desde **Plugins → Plugins instalados**. 3. Andá a **WooCommerce → Ajustes → Pagos → Nave**. 4. Completá tu Client ID, Client Secret y POS ID. Si todavía no tenés tus credenciales, solicitálas escribiendo a **integraciones@navenegocios.com**. 5. Seleccioná el entorno (Sandbox o Producción). 6. Guardá los cambios. ¡Listo! Nave ya aparece como método de pago en tu checkout. == Frequently Asked Questions == = ¿Dónde obtengo mis credenciales de API? = Escribí a **integraciones@navenegocios.com** para solicitar tu Client ID, Client Secret y POS ID para la integración B2B. El equipo de Nave te va a guiar en el proceso de alta. = ¿El plugin soporta reembolsos? = No en la versión actual. Los reembolsos deben procesarse manualmente desde el dashboard de Nave. = ¿Es compatible con HPOS? = Sí, es totalmente compatible con WooCommerce High-Performance Order Storage. = ¿Funciona con el Block Checkout (Gutenberg)? = Sí, el plugin detecta automáticamente si tu tienda usa el Block Checkout o el Checkout clásico y se adapta sin configuración adicional. = ¿Qué pasa si el pago expira? = Si el cliente no completa el pago dentro del tiempo configurado (por defecto 15 minutos), la intención de pago expira y la orden permanece en estado pendiente. Podés ajustar la duración del link de pago desde los ajustes del plugin. = ¿Puedo verificar el estado de un pago manualmente? = Sí. Desde la pantalla del pedido en el admin tenés dos formas: un botón en el meta box lateral "Nave - Estado del Pago" o la acción "Consultar estado en Nave" en el menú desplegable de acciones del pedido. = ¿Es seguro? = Sí. El plugin utiliza tokens criptográficos de un solo uso para los callbacks, almacenamiento cifrado con AES-256-CBC para los tokens de acceso, y enmascara datos sensibles en los logs de depuración. Ningún dato de tarjeta se almacena en tu servidor. == Screenshots == 1. Tus clientes te pagan como quieran. 2. Vendé más con promos. 3. Llevá la información de tus ventas en un solo lugar. == Changelog == = 1.0.3 = * Fix: una vez registrado el pago, el pedido pasa a estado Procesando en lugar de Completado. = 1.0.2 = * Fix: inicialización temprana de WC()->payment_gateways() que causaba que otras pasarelas (ej. MercadoPago) desaparecieran del checkout y del panel de administración al activar el plugin. La instanciación de ReturnHandler y WebhookHandler ahora es lazy (solo ocurre cuando el hook realmente dispara, no durante plugins_loaded). = 1.0.1 = * Agregada la declaración de servicios externos en el readme (Guideline 6). * Reemplazados estilos y scripts inline por wp_add_inline_style() y wp_add_inline_script(). * Agregado el header Requires Plugins para la dependencia de WooCommerce. * Corregido Plugin URI a una URL pública válida. * Agregados comentarios para traductores en placeholders de i18n. * Prefijadas variables globales en uninstall.php. * Uso de $wpdb->prepare() para las consultas de limpieza en base de datos. = 1.0.0 = * Lanzamiento inicial. == Upgrade Notice == = 1.0.3 = El pedido ahora pasa a Procesando (en lugar de Completado) cuando se registra el pago. = 1.0.2 = Corrección crítica: si tenés otras pasarelas de pago (MercadoPago, etc.) que desaparecen al activar Nave, actualizá a esta versión. = 1.0.1 = Correcciones de cumplimiento para las directrices del directorio de plugins de WordPress.org. = 1.0.0 = Lanzamiento inicial. == External Services == Este plugin se conecta a la **plataforma de pagos Nave** para procesar pagos. Nave es un adquirente de pagos que permite a los comercios aceptar pagos con tarjeta (Visa, Mastercard, Amex, Cabal), MODO y QR en Argentina. = API de Pagos de Nave = * **Qué es:** la API de procesamiento de pagos de Nave, utilizada para crear intenciones de pago, consultar el estado de un pago y recibir notificaciones de pago. * **Cuándo se envían datos:** * Cuando un cliente inicia un pago en el checkout, el plugin envía los datos del pedido (monto, moneda, nombres de productos, cantidades, precios unitarios) e información del comprador (nombre, email, teléfono, dirección de facturación) para crear una intención de pago. * Cuando el administrador de la tienda o un cron automático consulta el estado de un pago existente. * Cuando Nave envía una notificación webhook a la tienda para confirmar el estado del pago. * **URLs del servicio:** * Sandbox: `https://api-sandbox.ranty.io/api` * Producción: `https://api.ranty.io/api` * Pagos Sandbox: `https://punku-sandbox.ranty.io/payments-ms/payments` * Pagos Producción: `https://punku.ranty.io/payments-ms/payments` * **Proveedor del servicio:** Nave (por Galicia) — [https://navenegocios.com](https://navenegocios.com) * **Términos de servicio:** [https://ecommerce.ranty.io/nave/terms](https://ecommerce.ranty.io/nave/terms) * **Política de privacidad:** [https://ecommerce.ranty.io/nave/terms](https://ecommerce.ranty.io/nave/terms) = Servicio de Autenticación de Nave = * **Qué es:** servicio de autenticación OAuth 2.0 machine-to-machine utilizado para obtener tokens de acceso a la API de Nave. * **Cuándo se envían datos:** cuando el plugin necesita un nuevo token de acceso (en el primer uso y cuando el token almacenado expira). El plugin envía el Client ID y Client Secret del comercio. * **URLs del servicio:** * Sandbox: `https://homoservices.apinaranja.com/security-ms/api/security/auth0/b2b/m2ms` * Producción: `https://services.apinaranja.com/security-ms/api/security/auth0/b2b/m2msPrivate` * **Proveedor del servicio:** Naranja X — [https://naranjax.com](https://naranjax.com) * **Términos de servicio:** [https://ecommerce.ranty.io/nave/terms](https://ecommerce.ranty.io/nave/terms) * **Política de privacidad:** [https://ecommerce.ranty.io/nave/terms](https://ecommerce.ranty.io/nave/terms) Este plugin no recopila ni envía datos de seguimiento o analítica. Todos los datos transmitidos son estrictamente necesarios para el procesamiento de pagos.