﻿=== MedianetPay Gateway for WooCommerce ===
Contributors:      medianetpay
Tags:              woocommerce, payment, gateway, webcheckout, medianetpay
Requires at least: 6.0
Tested up to:      6.7
Requires PHP:      8.1
Stable tag:        1.0.0
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Integra MedianetPay como pasarela de pago en WooCommerce mediante un flujo de WebCheckout seguro.

== Description ==

MedianetPay Gateway for WooCommerce permite a los comercios aceptar pagos en línea a través de la plataforma MedianetPay utilizando un flujo de WebCheckout optimizado.

= Características principales =

* Flujo de pago mediante redirección a WebCheckout
* Validación de firma HMAC-SHA256 en callbacks
* Protección contra callbacks duplicados (idempotencia)
* Protección contra replay attacks
* Modo Sandbox para pruebas
* Logging detallado mediante el sistema de WooCommerce
* Registro de auditoría de todas las transacciones
* Compatible con High-Performance Order Storage (HPOS)

= Flujo de pago =

1. El cliente completa el checkout en WooCommerce
2. El plugin crea un Link de Pago mediante la API de MedianetPay
3. El cliente es redirigido al WebCheckout de MedianetPay
4. El cliente completa el pago
5. MedianetPay notifica el resultado al plugin mediante callback
6. El plugin valida la notificación y actualiza el estado de la orden

= Requisitos =

* WordPress 6.0 o superior
* WooCommerce 9.0 o superior
* PHP 8.2 o superior
* Cuenta activa en MedianetPay

== Installation ==

1. Sube el directorio `medianetpay-gateway` a `/wp-content/plugins/`
2. Ejecuta `composer install --no-dev` dentro del directorio del plugin
3. Activa el plugin desde el panel de WordPress
4. Ve a WooCommerce > Ajustes > Pagos > MedianetPay WebCheckout
5. Configura tus credenciales (API Base URL, Merchant ID, API Key, Secret Key)
6. Selecciona el ambiente (Sandbox o Producción)
7. Activa la pasarela

== Configuration ==

= API Base URL =
URL base de la API de MedianetPay. Ejemplo: https://api.medianetpay.ec/v1

= Merchant ID =
Tu identificador único de comercio proporcionado por MedianetPay.

= API Key =
Clave de autenticación para las peticiones a la API.

= Secret Key =
Clave secreta utilizada para validar la firma de los callbacks.

= Ambiente =
Selecciona "Sandbox" para pruebas o "Producción" para transacciones reales.

= Timeout =
Tiempo máximo (en segundos) de espera para peticiones a la API. Por defecto: 30 segundos.

= Modo Debug =
Activa el logging detallado. Los logs se pueden revisar en WooCommerce > Estado > Logs.

== Frequently Asked Questions ==

= ¿Cómo configuro la URL de callback en mi cuenta MedianetPay? =

La URL de callback del plugin es:
`https://tu-tienda.com/wc-api/medianetpay_webcheckout/`

Configura esta URL en el panel de tu cuenta MedianetPay como URL de notificación.

= ¿Dónde veo los logs del plugin? =

Ve a WooCommerce > Estado > Logs y filtra por el canal `medianetpay-gateway`.

= ¿El plugin es compatible con HPOS? =

Sí, el plugin declara compatibilidad completa con High-Performance Order Storage (HPOS).

== Changelog ==

= 1.0.0 =
* Versión inicial

== Upgrade Notice ==

= 1.0.0 =
Versión inicial del plugin.
