Cambios

Ahora, cada publicación del blog, página de documentación y referencia de la API tiene una versión equivalente en Markdown limpio que puedes enviar a ChatGPT, Claude o tu agente de IDE favorito con un solo clic.

Copiar para LLM

Hay un nuevo botón junto al título de cada publicación del blog y página de documentación. Abre un menú desplegable con cuatro accesos directos: copiar la página como Markdown, verla como Markdown, abrirla en ChatGPT y abrirla en Claude. Los dos últimos rellenan previamente el chat con la URL de la versión Markdown, para que el modelo trabaje con el contenido real, no con una captura de pantalla de una página HTML.

Referencia de la API como Markdown

La referencia completa de la API ya está disponible en /api/docs.md, generada a partir de la especificación OpenAPI activa. Pega la URL en cualquier LLM y pregunta: “¿cómo creo un pago con atribución de canal?”. Obtendrás una respuesta fundamentada en lugar de una alucinación.

Las versiones Markdown de las páginas de documentación están disponibles en la misma ruta con .md añadido, por ejemplo, /docs/getting-started.md. Todas están indexadas en llms.txt para agentes de IDE.

Esta versión introduce el envío manual para transferencias directas, notificaciones por correo electrónico y recuperación de pagos para sesiones interrumpidas.

Envío manual para transferencias directas

Los clientes ahora pueden pagar copiando la dirección del comerciante y enviando el monto exacto desde cualquier billetera, sin necesidad de conectarla. Funciona para pagos del mismo token y misma cadena en todas las redes EVM y TON. El sistema genera un monto único (con dígitos de polvo aleatorios) para cada pago y detecta automáticamente la transferencia en la cadena.

Esto es útil para clientes que usan billeteras de hardware, retiros desde exchanges, o simplemente prefieren no conectar su billetera a un sitio web.

Notificaciones por correo electrónico

Los clientes pueden optar por recibir un correo electrónico cuando su pago sea confirmado, para poder cerrar la página con seguridad después de enviar. Los comerciantes también pueden activar alertas desde la configuración del panel para recibir correos sobre pagos completados, fallos u otros eventos.

Recuperación de pagos

Si la página se recarga o la conexión de la billetera se interrumpe durante el pago, el checkout se recupera automáticamente. Los pagos de envío manual reanudan la pantalla de depósito con el monto exacto aún visible. Los pagos con billetera conectada muestran una pantalla de recuperación donde el cliente puede pegar el hash de su transacción o empezar de nuevo.

Si el cliente ya envió pero no encuentra el hash de la transacción, el monitor en segundo plano detectará y completará el pago automáticamente.

Esta versión añade una nueva API headless para remitentes programáticos y lleva la página de pago y el panel del comerciante a cinco idiomas.

API de pagos headless

Un nuevo endpoint POST /api/payments/headless devuelve una dirección de depósito y el monto exacto en una sola llamada. Está pensado para remitentes que ya saben desde qué cadena y token quieren pagar, sistemas automatizados de pagos, plataformas asociadas, scripts y aplicaciones de billetera que controlan su propia UX.

Soporta rutas directas (mismo token, misma cadena) y rutas de swap/bridge basadas en depósito. Los flujos con orden firmada (intents EIP-712, transacciones on-chain) no se admiten en modo headless, las integraciones deben recurrir a la página /pay/{id} alojada para esas rutas.

Página de pago y panel en 5 idiomas

La página /pay/:id y el panel completo del comerciante están ahora disponibles en inglés, español, turco, armenio y ruso. La interfaz detecta automáticamente el idioma del navegador y recuerda la elección entre visitas. Los selectores de idioma se encuentran en el pie de la página de pago, el pie de la página Pay Me y la barra lateral del panel.

Mejoras de fiabilidad

Una ronda de correcciones en el monitoreo de pagos, depósitos atascados y problemas de conexión de billeteras.

Esta versión añade acceso programático sin navegador, seguimiento exacto de montos de liquidación, códigos QR para pagos por depósito y una ronda de mejoras de seguridad.

Cambio importante: rutas de API renombradas

Todos los endpoints del panel de comerciante se han movido de /api/dashboard/* a /api/merchant/*. Las rutas antiguas ya no funcionan. Actualiza tus integraciones.

Clave API maestra

Los comerciantes ahora pueden generar una clave API maestra (prefijo msk_) desde Panel → Configuración. Esta clave autentica contra todos los endpoints de /api/merchant/*: crear pagos, gestionar canales, configurar liquidación, sin necesidad de sesión de navegador. Útil para servicios backend, scripts y pipelines CI.

La gestión de la clave maestra (generar, rotar, revocar) requiere inicio de sesión en el navegador. Una clave maestra no puede rotarse o revocarse a sí misma.

Monto de liquidación en webhooks

Los payloads de webhook ahora incluyen dest_amount y dest_decimals, la cantidad exacta de tokens que llegaron a tu billetera. Esto es crítico para liquidaciones en tokens no estables (por ejemplo, TON) donde amount_usd no indica la cantidad de tokens. Divide dest_amount entre 10^dest_decimals para obtener la cifra legible.

Códigos QR en pagos por depósito

Los clientes que pagan mediante depósito (rutas cross-chain de Rubic, TON, Tron) ahora ven un código QR escaneable sobre los campos de copia. URIs inteligentes por cadena: EIP-681 para EVM nativo, ton://transfer con memo para TON, Solana Pay para Solana y BIP-21 para BTC.

Página de edición de canal

Cada canal ahora tiene una página de edición dedicada en /dashboard/channels/:id con secciones para marca, URL de webhook, override de liquidación, rotación de clave API y una zona de peligro para revocar acceso.

Canal de página “Págame”

Configurar una página “Págame” ahora crea automáticamente un canal dedicado. Esto le da a tu página su propia marca, destino de liquidación y webhook, independientes de tus otros canales.

Fiabilidad de webhooks

Una nueva tarea cron dispara webhooks para cualquier pago que se completó mediante polling de estado en línea pero cuyo webhook fue omitido silenciosamente. No más notificaciones perdidas.

Seguridad

• Límite de intentos en login de administrador (5 intentos / 15 min por IP)
• CORS restringido a mutopay.com + localhost
• Cabecera Content-Security-Policy en todas las páginas
• Cifrado AES-256-GCM para claves API almacenadas
• Protección contra redirección abierta en URLs de retorno

Los comerciantes ahora pueden crear y gestionar canales API directamente desde el panel, sin necesidad del plugin de WooCommerce. Cada canal también puede tener su propio destino de liquidación, independiente del predeterminado de la cuenta.

Crear canales desde el panel

Un nuevo botón + Nuevo canal en Configuración permite crear un canal API manual en segundos. Dale un nombre, opcionalmente añade una URL de webhook, y opcionalmente configura un override de liquidación específico para ese canal. La clave API completa se muestra una vez al crearlo; cópiala antes de salir de la página.

Esta es la forma más fácil de integrar MutoPay en cualquier tienda personalizada, aplicación móvil o servicio backend sin pasar por el flujo de OAuth.

Liquidación independiente por canal

Cada canal ahora puede tener su propia cadena, token y dirección de billetera para liquidación. Si no se establece un override, el canal usa el predeterminado de tu cuenta. Los overrides se gestionan directamente en la tarjeta del canal: haz clic en Override para establecer uno, en el lápiz para editar, o en Eliminar override para volver al predeterminado.

Los tres campos, cadena, token y dirección de billetera, siempre se guardan y eliminan como un conjunto. Esto evita desajustes donde se establece una cadena pero no hay billetera correspondiente.

Edición de canales en línea

Los nombres de canales y URLs de webhook ahora se pueden editar en línea: haz clic en el icono del lápiz junto a cualquier campo, haz tu cambio y guarda sin salir de la página.

El secreto del webhook ahora es visible con un botón Copiar en cada tarjeta de canal, junto al botón existente de Test Webhook.

Onboarding simplificado

El nuevo flujo de onboarding fusiona los pasos de cadena/token y dirección de billetera en un único paso Configurar liquidación. Cadena, token y billetera se configuran juntos en un formulario y se guardan en una sola llamada API.

API

Cuatro nuevos endpoints del panel soportan estas funcionalidades:

Método	Endpoint	Descripción
POST	/api/dashboard/channels	Crear un canal manual; devuelve { channel, api_key }
PATCH	/api/dashboard/channels/:id/webhook-url	Actualizar URL de webhook
PUT	/api/dashboard/channels/:id/settlement	Establecer override de liquidación por canal
DELETE	/api/dashboard/channels/:id/settlement	Eliminar override (volver al predeterminado)

Las interfaces de comerciantes y clientes de MutoPay han sido completamente rediseñadas, y los comerciantes ahora tienen una página de pago personal que acepta cualquier monto, sin necesidad de una factura fija.

Enlaces Págame

Cada comerciante obtiene una página personal en mutopay.com/pay/@tunombre. Los visitantes ingresan cualquier monto y una nota opcional, útil para propinas, facturas freelance y pedidos abiertos. Configura tu página desde Panel → Configuración → Página Págame.

UI rediseñada

Todas las páginas orientadas a clientes y comerciantes ahora comparten un lenguaje de diseño consistente: tarjetas, tipografía y sistema de colores unificados en la página de pago, el panel del comerciante, el panel de administración y la página Págame.

Optimizado para móvil

Cada página, caja de pago, panel del comerciante y panel de administración, ahora es completamente responsive. Clientes y comerciantes pueden usar MutoPay en cualquier dispositivo.

Descripción del pago

Los comerciantes pueden adjuntar una descripción legible al crear un pago (ej. “Pedido #1042 – Widget Azul”). Aparece en la página de pago del cliente como contexto de lo que está pagando.

Marca del canal

Cada canal de comerciante ahora puede anular el nombre de negocio y eslogan predeterminados mostrados a los clientes. Útil para comerciantes con múltiples tiendas en una sola cuenta. Se gestiona desde Panel → Canales → editar canal.

MutoPay ahora cubre tres grandes cadenas no-EVM. Los clientes pueden pagar desde billeteras de TON, Solana y Tron, y los comerciantes pueden liquidar en sus tokens nativos.

Nuevas cadenas

• TON: acepta TON o USDT sobre TON. Los compradores se conectan a Tonkeeper, MyTonWallet o cualquier billetera compatible con TonConnect en un solo toque. Ideal para bots de Telegram y mini-apps.
• Solana: paga con cualquier token SPL, liquida en USDC nativo sobre Solana. Soporte para Phantom y Backpack.
• Tron: acepta y liquida USDT-TRC20, el riel de stablecoin más circulado en mercados emergentes.

Comparación de rutas

Cuando hay varias rutas disponibles, la página de pago ahora las muestra lado a lado: nombre del puente, monto de destino y tiempo estimado, para que los compradores elijan velocidad o precio.

Flujo de depósito manual

Para las rutas que no podemos firmar directamente (NEAR Intents y otros puentes basados en intenciones), la página de pago muestra una dirección de depósito copiable y el monto exacto, y avanza automáticamente cuando llega el depósito.

Nuevos eventos de webhook

• payment.kyc_required: el proveedor de enrutamiento aplicó una retención temporal mientras el comprador verifica su identidad. No se requiere acción del comerciante; el evento final payment.completed o payment.failed es la señal definitiva.
• payment.needs_manual_check: el proveedor devolvió un estado inesperado. Operaciones de MutoPay investigará antes de que el pago alcance un estado terminal.

Cada pago ahora alcanza un resultado determinista, ninguno puede quedar silenciosamente atascado en pending.

Página de pago

La conexión de la billetera fluye directamente al pago, sin necesidad de un segundo clic tras conectar.

Los pagos ahora pueden crearse en cualquiera de las más de 50 monedas fiat. El monto se convierte a USD con tipos de cambio de bancos centrales en tiempo real en el momento de crear el pago.

Características

• Más de 50 monedas fiat: fija precios en EUR, GBP, SAR, AED, JPY, AMD y más. La conversión se realiza en el servidor usando tipos de la Frankfurter API, procedentes de más de 30 bancos centrales.
• Tipos de cambio auditables: cada pago almacena el monto original, la moneda y el tipo de cambio utilizado en el momento de la creación. Visible en el panel de control, panel de administración y payloads de webhook.
• Moneda automática en WooCommerce: el plugin de MutoPay ahora envía la moneda configurada en tu tienda automáticamente. Una tienda en EUR crea pagos en EUR sin configuración adicional.
• API retrocompatible: el campo existente amount_usd sigue funcionando. Los nuevos campos amount + currency son aditivos.
• Caché de tipos resiliente: los tipos de cambio se cachean en Cloudflare KV con una ventana de frescura de 2 horas y un respaldo de 24 horas, para que los pagos sigan funcionando incluso si el proveedor de tipos no está disponible temporalmente.

Nos complace lanzar MutoPay v1.0, la pasarela de pagos cripto que convierte cualquier token en stablecoins.

Características

• API de pagos: crea enlaces de pago con una sola petición POST
• Soporte multi-cadena: Ethereum, Polygon, Arbitrum, Base, Optimism, Avalanche, BNB Chain
• Más de 1.000 tokens: acepta cualquier token, siempre recibe USDC, USDT o DAI
• Bridging cross-chain: enrutamiento automático a través del mejor protocolo disponible
• Panel de comerciante: monitorea pagos, gestiona claves API, configura webhooks
• Panel de administración: analíticas de toda la plataforma, gestión de comerciantes, configuración de comisiones
• Notificaciones webhook: firmadas con HMAC-SHA256, con reintento automático y backoff exponencial
• Autocustodia: los fondos se liquidan directamente en la billetera del comerciante