Skip to main content

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.

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.

Webhooks: nombres de eventos estandarizados

Se están estandarizando algunos nombres de eventos de webhooks: payout.updatepayout.updated, card.transaction.refundcard.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.

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.

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.

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.

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.