ONE.lat para WooCommerce

Descripción

ONE.lat para WooCommerce conecta tu tienda con ONE, una pasarela de pagos creada para Latinoamérica. Tus clientes pagan con el método local de su país — 🇦🇷 transferencias bancarias, 🇧🇷 PIX, 🇨🇴 PSE, 🇲🇽 SPEI o criptomonedas — y vos recibís la liquidación en USDC directamente en tu wallet, en cuestión de minutos, sin necesidad de una LLC ni de una cuenta bancaria en dólares.

Por qué ONE

  • Métodos de pago locales: 🇦🇷 transferencias bancarias en Argentina, 🇧🇷 PIX en Brasil, 🇨🇴 PSE en Colombia, 🇲🇽 SPEI en México y cripto en cualquier país.
  • Liquidación en minutos, en USDC: los fondos llegan a tu wallet en minutos en lugar de días, sin intermediarios bancarios.
  • Sin contracargos: las transferencias y los pagos en cripto son irreversibles, a diferencia de las tarjetas de crédito — una vez que se confirma un pago, queda confirmado.
  • Sin fricciones de infraestructura: no necesitás abrir una LLC ni una cuenta bancaria en dólares en EE. UU. para empezar a cobrar y liquidar en tu tienda.
  • Integración nativa con WooCommerce: funciona tanto con el checkout clásico como con los bloques de carrito y checkout (Cart & Checkout Blocks), y es compatible con HPOS (High-Performance Order Storage).

Cómo funciona

  1. El cliente selecciona «ONE» como método de pago en tu checkout.
  2. Tu tienda crea una preferencia de checkout a través de la API de ONE y redirige al cliente a una página de pago segura y alojada.
  3. El cliente paga con el método local disponible en su país.
  4. ONE notifica el resultado mediante un webhook. El plugin nunca confía solo en esa notificación: siempre realiza una solicitud autenticada a la API de ONE para confirmar el estado real antes de marcar la orden como pagada.

Monedas soportadas

USD, ARS, BRL, COP y MXN. Si tu tienda factura en otra moneda, el método de pago ONE se oculta automáticamente en el checkout.

Lo que necesitás

Para probar el plugin no necesitás una cuenta: copiá la API Key y el API Secret de prueba públicos desde ONE developers y dejá el entorno en Staging. Para aceptar pagos reales, create una cuenta en ONE y reemplazá esas claves por las tuyas.

Servicios externos

Este plugin se conecta a la API de ONE (one.lat) para crear preferencias de pago y confirmar el estado de las transacciones de tu tienda. Esta conexión es necesaria para que el método de pago funcione: sin ella, ONE no puede procesar los pagos de tus órdenes.

Datos enviados, y cuándo:

  • Cuando se crea una orden: el monto y la moneda de la orden, un identificador interno de la orden y los datos de contacto del cliente (correo electrónico, nombre, apellido y teléfono) ingresados en el checkout se envían a la API de ONE (api.one.lat en producción, api.stg.one.lat en el entorno de staging) para generar el checkout alojado de ONE.
  • Cuando se recibe una notificación de cambio de estado (webhook): el plugin realiza una solicitud GET autenticada a la API de ONE, usando tus propias credenciales, para confirmar el estado real del pago o reembolso antes de actualizar la orden.

Estas solicitudes solo se realizan cuando un cliente elige pagar con ONE y son necesarias para completar la transacción.

Más información:
Términos de uso de ONE
Política de privacidad de ONE

Capturas

Instalación

  1. Instalá y activá WooCommerce si todavía no lo hiciste.
  2. Subí la carpeta one-lat-for-woocommerce a /wp-content/plugins/, o instalá el plugin directamente desde la pantalla de plugins de WordPress.
  3. Activá el plugin desde el menú Plugins.
  4. Andá a WooCommerce > Ajustes > Pagos > ONE y activá el método de pago.
  5. Para probar sin cuenta, copiá la API Key y el API Secret públicos desde ONE developers. Para vender de verdad, create una cuenta en ONE y usá tus propias claves.
  6. Dejá el entorno en Staging mientras usás las claves de prueba. Cambiá a Producción solo con las credenciales de tu dashboard.

Preguntas frecuentes

¿Necesito una cuenta en ONE para usar este plugin?

No para una orden de prueba. Copiá la API Key y el API Secret de prueba públicos desde ONE developers y usá el entorno de Staging. Para aceptar pagos reales sí necesitás una cuenta en one.lat y tus propias credenciales.

¿En qué países funciona?

La API de ONE admite pagos en Argentina, Brasil, Colombia y México con métodos locales, además de cripto en cualquier país. Las monedas de facturación que admite el plugin son USD, ARS, BRL, COP y MXN.

¿Cómo se confirma un pago?

ONE notifica los cambios de estado por webhook, pero el plugin nunca actualiza una orden basándose solo en esa notificación: siempre hace una petición GET autenticada a la API de ONE para confirmar el estado real antes de marcar la orden como pagada, rechazada o expirada.

Does the plugin process refunds automatically?

No. La API de ONE todavía no expone un endpoint para crear reembolsos, solo para consultarlos. Cuando ONE confirma un reembolso, el plugin agrega una nota a la orden para que puedas conciliarla manualmente — no se crea ningún reembolso automático en WooCommerce.

¿Es compatible con Cart & Checkout Blocks y HPOS?

Sí, ambos están explícitamente declarados y testeados.

¿Qué pasa si mi tienda factura en una moneda no admitida?

El método de pago ONE se oculta automáticamente en el checkout si la moneda de la tienda no es una de las admitidas.

Reseñas

No hay reseñas para este plugin.

Colaboradores y desarrolladores

“ONE.lat para WooCommerce” es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

“ONE.lat para WooCommerce” ha sido traducido a 1 idioma. Gracias a los traductores por sus contribuciones.

Traduce “ONE.lat para WooCommerce” a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN , o suscríbete al log de desarrollo por RSS .

Registro de cambios

1.0.2

  • Release 1.0.2.

1.0.1

  • Release 1.0.1.

1.0.0

  • Every request to the ONE API now sends two extra headers: x-woocommerce-plugin-version (the installed plugin version) and x-origin: WOOCOMMERCE, so ONE can identify the integration and enforce a minimum supported plugin version.

0.2.2

  • Updated the plugin description (header and readme) to better reflect actual coverage: local payments in 4 countries and crypto worldwide, settlement in USDC dollars.

0.2.1

  • Added a “Settings” link on the plugins list page (next to “Deactivate”) linking directly to the gateway settings.

0.2.0

  • Removed the embedded iframe checkout: both classic checkout and Checkout Blocks now do a full-page redirect to the ONE hosted checkout. This avoids failures in ONE’s anti-bot challenge (Cloudflare/AWS WAF), which cannot complete inside a cross-origin iframe.
  • Simplified the Cart & Checkout Blocks integration: it no longer depends on pre-creating a draft order or exposing its own REST endpoints for that.

0.1.4

  • The payment method title shown to the customer (previously fixed per currency) is now editable per store in the gateway settings, with the same previous text as the default value.

0.1.3

  • Removed the hardcoded minimum/maximum amounts: in Staging the error returned by the ONE API is shown as-is (useful for testing); in Production a generic, customer-facing message is shown instead, without exposing numbers that could become outdated relative to the real API.

0.1.2

  • Errors returned by the ONE API when creating a Checkout Preference (amount out of range, invalid contact details, credentials, etc.) are now translated into specific messages for the customer, instead of a single generic message.

0.1.1

  • First version of the embedded iframe checkout for Checkout Blocks (later replaced in 0.2.0 by the full-page redirect).
  • Visible warning in Staging when the store’s currency isn’t supported or the order amount is out of range.

0.1.0

  • Initial version: redirect-type gateway to the ONE hosted checkout.
  • Payment confirmation via webhook with authenticated GET verification (the webhook payload is never trusted on its own).
  • Logging of ONE refunds as an order note for manual reconciliation.
  • Cart & Checkout Blocks integration and HPOS compatibility.
  • Option to delete stored settings on uninstall.