> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Novedades y cambios en la API y la documentación de Meru

<Update label="2026-08-12">
  ## Webhooks: política de versionado y fecha de eliminación de los nombres heredados

  Los nombres de evento deprecados —`payout.update`, `balance.updated` y `card.transaction.refund`—
  se eliminarán el **15 de noviembre de 2026**. Hasta esa fecha se entregan tanto el nombre nuevo
  como el heredado, así que apunta tus handlers a los nombres nuevos antes de que llegue.

  La referencia de webhooks ahora también documenta cómo se versionan y deprecan los eventos. Los
  eventos se versionan **por tipo de evento**: los cambios incompatibles se publican como un tipo
  nuevo con un sufijo de versión, por ejemplo `payin.updated.v2`, nunca como una modificación de uno
  existente. Agregar un campo opcional no es un cambio incompatible, así que tu handler debe ignorar
  los campos que no reconozca. Las deprecaciones se anuncian con al menos **90 días** de
  anticipación, ambos eventos se entregan en paralelo durante toda la ventana, y no se elimina nada
  hasta que los suscriptores hayan migrado.
</Update>

<Update label="2026-08-12">
  ## Billeteras de autocustodia

  Nueva sección **Autocustodia** que documenta los SDKs para agregar una billetera de stablecoins
  a tu app web o móvil. Tus usuarios guardan y envían stablecoins en dólares, inician sesión con
  email o passkey, y nunca ven una frase semilla ni una comisión de red: la clave de la billetera
  se crea en el dispositivo del usuario y nunca sale de ahí. Incluye la introducción, una guía de
  inicio rápido, autenticación, passkeys, el flujo de la billetera y el handler de backend, con
  SDKs para Web, React Native, Flutter, iOS y Android.

  También se agrega la página de la **billetera white-label**, un producto de billetera con tu
  marca impulsado por Meru, actualmente en construcción.
</Update>

<Update label="2026-07-24">
  ## Webhooks: nombres de eventos estandarizados

  Se están estandarizando algunos nombres de eventos de webhooks: `payout.update` → `payout.updated`,
  `card.transaction.refund` → `card.transaction.refunded`, y `balance.updated` se divide en
  `payin.updated` (depósitos fiat) y `crypto_deposit.updated` (depósitos on-chain). Durante la transición
  se entregan tanto el nombre nuevo como el heredado para el mismo evento, cada uno con un `data.eventId`
  compartido para deduplicación. Los nombres heredados quedan deprecados y se eliminarán el 15 de noviembre de 2026.
</Update>

<Update label="2026-06-24">
  ## Referencia de webhooks

  La referencia de webhooks ahora cubre todos los eventos que enviamos —
  `payout.update`, `balance.updated`, `customer.status.updated`,
  `customer.product.request.updated` y `card.transaction.*` — separados en una
  página por evento, cada uno con su payload, estados y un ejemplo.
</Update>

<Update label="2026-06-23">
  ## Filtro por rango de fechas y export

  Los endpoints de listado de payins y payouts ahora aceptan los filtros
  `startDate` y `endDate` (ISO 8601). Los nuevos endpoints `GET /v1/payins/export`
  y `GET /v1/payouts/export` descargan el rango completo filtrado en CSV (por
  defecto) o JSON.
</Update>

<Update label="2026-06-23">
  ## Referencia de webhooks

  La documentación de webhooks ahora refleja los payloads reales: los eventos
  `payout.update` y `balance.updated`, la lista completa de estados de payout,
  los campos de `data` y cómo verificar las firmas de las solicitudes.
</Update>

<Update label="2026-06-22">
  ## Documentación en español

  La referencia de la API de Meru ya está disponible en español. Usa el selector de
  idioma en la barra de navegación para cambiar entre inglés y español.
</Update>