=== Recaudos para Nequi ===
Contributors: gydoar
Tags: nequi, colombia, pagos, woocommerce, transferencias, bancolombia
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept Nequi payments in WooCommerce. Show your Nequi number to customers with step-by-step instructions to complete the transfer.

== Description ==

**Recaudos para Nequi** adds Nequi as a payment method in your WooCommerce store.

Nequi is Bancolombia's financial app with over 20 million users in Colombia. It allows instant money transfers using a registered mobile number.

= How it works =

Since Nequi does not offer a public API for direct WooCommerce integration, this plugin implements a manual instruction flow:

1. The customer selects "Paga con Nequi" at checkout.
2. After placing the order, the plugin displays your **Nequi mobile number**, the exact amount, and step-by-step instructions.
3. The customer opens the Nequi app and completes the transfer.
4. The order is placed **on hold** until you manually confirm the payment in WooCommerce.

= Features =

* Displays your Nequi number with a **copy to clipboard** button and visual feedback.
* Shows the account holder's **masked name** for customer verification.
* Displays the **exact order amount** to transfer.
* Optional **QR code** support (generate yours from the Nequi app under Cobrar > Compartir mi QR).
* 4-step instructions in a horizontal grid layout.
* **"Confirm payment"** button with receipt upload (image or PDF, max 5MB).
* **WhatsApp button** with pre-filled order details message.
* Instructions also shown in **My Account > View Order** while the order is pending.
* Compatible with **HPOS** (High-Performance Order Storage).
* Compatible with **Block Checkout** (WooCommerce Blocks).

---

**Versión en español**

**Recaudos para Nequi** añade Nequi como método de pago en tu tienda WooCommerce.

Nequi es la app financiera de Bancolombia con más de 20 millones de usuarios en Colombia. Permite hacer transferencias al instante usando un número de celular registrado.

= ¿Cómo funciona? =

1. El cliente selecciona "Paga con Nequi" en el checkout.
2. Al confirmar el pedido, el plugin muestra tu **número Nequi**, el monto exacto e instrucciones paso a paso.
3. El cliente abre la app Nequi y realiza la transferencia.
4. El pedido queda **en espera** hasta que confirmes el pago manualmente en WooCommerce.

= Características =

* Muestra tu número Nequi con botón de copiar al portapapeles.
* Muestra el nombre cifrado del titular para verificación.
* Muestra el monto exacto del pedido.
* Soporte opcional para código QR (genéralo desde Nequi en Cobrar > Compartir mi QR).
* Instrucciones de 4 pasos en layout horizontal.
* Botón "Confirmar mi pago" con adjunto de comprobante (imagen o PDF, máx 5MB).
* Botón de WhatsApp con mensaje pre-cargado con datos del pedido.
* Compatible con HPOS y Block Checkout.

== Installation ==

1. Upload the `recaudos-nequi` folder to `/wp-content/plugins/`, or install it via **Plugins > Add New** in WordPress.
2. Activate the plugin from the **Plugins** menu.
3. Go to **WooCommerce > Settings > Payments > Nequi** and enter your Nequi mobile number.

== Frequently Asked Questions ==

= Are payments processed automatically? =

No. Nequi does not offer a public API for automated processing. Orders are placed on hold and you must confirm the payment manually by changing the order status to Processing or Completed in WooCommerce.

= Where do I get my Nequi QR code? =

Open the Nequi app and go to Cobrar > Compartir mi QR. Save the image and upload the URL in the plugin settings.

= Is it compatible with HPOS? =

Yes, the plugin declares full compatibility with WooCommerce High-Performance Order Storage (HPOS).

= Is it compatible with the Block Checkout? =

Yes, it works with both the classic checkout shortcode and the WooCommerce Block Checkout (WooCommerce 9+/10+).

== Screenshots ==

1. Plugin settings page in WooCommerce admin.
2. Payment instructions block on the order confirmation (Thank You) page.
3. Instructions visible in My Account > View Order while the order is pending.
4. Payment method displayed at checkout.

== Changelog ==

= 1.0.0 =
* Initial release.
* Nequi mobile number display with copy to clipboard button.
* 4-step instructions in horizontal grid layout.
* Confirm payment button with receipt upload.
* WhatsApp integration with pre-filled message.
* Compatible with HPOS and Block Checkout.

== Upgrade Notice ==

= 1.0.0 =
Initial stable release.
