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

# Changelog

> Resumen de nuevas funcionalidades y cambios de ON RAMP.

Consulta los cambios incorporados en cada versión y accede a la documentación correspondiente para conocer contratos, ejemplos y formas de prueba.

<Update label="20 de julio de 2026" description="v2.2.0">
  ## Cripto, payouts y prefunding

  Esta versión mejora el registro y seguimiento de operaciones cripto, flexibiliza las referencias de Payout ACH v3 y automatiza el procesamiento de prefunding.

  ### Registro automático de depósitos cripto

  Los depósitos recibidos en las direcciones de una wallet ahora se registran automáticamente cuando son confirmados por la red blockchain. Cada depósito queda asociado al negocio y la wallet correspondientes, con información del monto, activo, blockchain y hash de la transacción.

  <Card title="Ver flujo de depósitos cripto" icon="download" href="/wallet#depositos-cripto">
    Consulta cómo recibir fondos y dar seguimiento a su confirmación.
  </Card>

  ### Webhooks cripto con hash de transacción

  Las notificaciones de depósitos y retiros cripto ahora pueden incluir `transactionHash`, además de `amount`, `asset`, `blockchain` y, cuando corresponde, `walletId`. El hash permite verificar la operación directamente en un explorador blockchain.

  <Card title="Ver contratos de Webhooks" icon="bell" href="/webhooks#payloads-de-transacciones-crypto">
    Revisa los payloads actualizados de `deposit_crypto` y `withdrawal_crypto`.
  </Card>

  ### Red predeterminada de nuevas wallets por ambiente

  Las nuevas wallets incorporan `USDC` como activo predeterminado. La blockchain asignada depende del ambiente: `Ethereum` en Sandbox y `Polygon` en Producción. Este cambio no modifica los assets de wallets ya existentes.

  <Warning>
    Antes de transferir fondos, verifica siempre el valor de `blockchain` devuelto
    por la API y utiliza la misma red en la wallet de origen.
  </Warning>

  ### Respuesta controlada de balances de payout

  La consulta de balances de Payout ACH y Payout QR ahora mantiene una respuesta válida cuando el proveedor de saldos no está disponible temporalmente. En ese escenario, la API devuelve los balances en cero hasta que la consulta pueda restablecerse.

  <Card title="Consultar balances de payout" icon="scale-balanced" href="/consultas#payouts-balance">
    Revisa la ruta y el contrato de respuesta de balances.
  </Card>

  ### Referencias flexibles en Payout ACH v3

  El campo obligatorio `external_reference` de Payout ACH v3 ahora acepta referencias de texto definidas por el partner y ya no exige el formato UUID v4. Esto permite utilizar identificadores propios de órdenes u operaciones.

  <Card title="Ver Payout ACH v3" icon="building-columns" href="/payout#payout-ach">
    Consulta el request, sus validaciones y la respuesta del payout.
  </Card>

  ### Procesamiento automático de prefunding

  Las operaciones de prefunding ahora continúan automáticamente con su procesamiento bancario después de confirmarse la recepción de fondos. El número de referencia generado por el proveedor queda asociado a la transacción para facilitar su trazabilidad.
</Update>

<Update label="13 de julio de 2026" description="v2.1.0">
  ## Wallets, cripto y PIX

  Esta versión amplía la API v2 con nuevas operaciones de wallets, depósitos y payouts cripto, y pagos instantáneos PIX.

  ### Administración de wallets

  Se agregaron endpoints para crear y listar wallets, asociar assets por blockchain y consultar balances disponibles.

  <Card title="Ver documentación de Wallets" icon="wallet" href="/wallet">
    Revisa los endpoints, contratos y ejemplos de creación y consulta.
  </Card>

  ### Depósitos cripto

  Las direcciones asociadas a una wallet ahora pueden utilizarse para recibir depósitos cripto y consultar posteriormente su balance.

  <Card title="Ver flujo de depósitos cripto" icon="download" href="/wallet#depositos-cripto">
    Consulta cómo obtener una dirección, transferir fondos y validar el depósito.
  </Card>

  ### Payouts cripto

  Se agregó el envío de `USDC` y `USDT` desde una wallet interna hacia una dirección externa en Polygon, Ethereum o TRON.

  <Card title="Ver documentación de Payout Crypto" icon="arrow-up-right" href="/payout-crypto">
    Revisa el request, response, validaciones y ejemplo Sandbox.
  </Card>

  ### Payouts PIX

  Se incorporaron pagos instantáneos en `BRL` hacia Brasil, con fondeo mediante balance o conversión cripto.

  <Card title="Ver documentación de Payout PIX" icon="bolt" href="/payout#payout-pix">
    Consulta las claves PIX admitidas y las respuestas de cada modalidad de
    fondeo.
  </Card>

  ### Webhooks cripto

  Las notificaciones de depósitos y retiros cripto ahora incluyen `amount`, `asset`, `blockchain` y, cuando corresponde, `walletId`.

  <Card title="Ver contratos de Webhooks" icon="bell" href="/webhooks#payloads-de-transacciones-crypto">
    Revisa los payloads de `deposit_crypto` y `withdrawal_crypto`.
  </Card>

  <Warning>
    Si tu integración ya procesa webhooks cripto, utiliza `asset` y `blockchain`
    en lugar de depender de `currency`.
  </Warning>
</Update>
