> ## Documentation Index > Fetch the complete documentation index at: https://docs.velafi.com/llms.txt > Use this file to discover all available pages before exploring further. # Registro de cambios > Historial completo de versiones de la API de VelaFi: nuevos endpoints, flujos actualizados, nuevos webhooks y mejoras de documentación en todas las versiones. Esta página registra cada cambio significativo en la plataforma de la API de VelaFi, incluidos nuevos endpoints, actualizaciones de flujos, nuevos webhooks y mejoras de documentación. Revisa este registro de cambios cada vez que actualices tu integración o quieras aprovechar nuevas funciones. Los cambios se listan en orden cronológico inverso. *** ## 2026-10-30 — Webhook de retiros cripto * Nuevo evento de webhook [`CRYPTO_WITHDRAW_WEBHOOK`](https://docs.velafi.com/es/api-reference/webhooks/crypto-withdraw-message-push): te notifica cuando un retiro cripto desde la billetera de un comercio es exitoso, falla o se cancela. Cubre los retiros hechos a través de la API o del panel, los elementos de pagos masivos y los retiros automáticos de on-ramp. Regístralo con [`POST /v2/webhook`](https://docs.velafi.com/es/api-reference/webhooks/create-webhook-endpoints). *** ## 2026-10-30 — Cuentas verificadas obligatorias para los endpoints de billetera cripto * Los endpoints de billetera cripto ahora devuelven `-5043` si tu cuenta no ha aprobado KYC/KYB: `GET /v2/assets/depositAddress`, `POST /v2/assets/internalTransfer`, `GET /v2/assets/internalTransferOrders`, `GET /v2/assets/withdrawQuota`, `POST /v2/assets/withdraw`, `GET /v2/assets/depositOrders` y `GET /v2/assets/withdrawalOrders`. Consulta [Códigos de error](https://docs.velafi.com/es/docs/error-codes.md). *** ## 2026-10-30 — Los simuladores de depósito de sandbox requieren autenticación * Los [simuladores de depósito de sandbox](https://docs.velafi.com/es/docs/sandbox.md#sandbox-testing-tools) `/v2/platform/test/deposit` y `/v2/platform/test/crypto/deposit` ahora solo aceptan `POST`, requieren el header `X-BH-TOKEN` y una dirección IP en la lista blanca, y están limitados a 20 solicitudes por minuto. * El simulador cripto ahora solo acepta `USDT` y `USDC`. *** ## 2026-09-23 — Detalles de reembolso y fallo en los registros de fondeo * [`GET /v2/merchant/funding/records`](https://docs.velafi.com/es/api-reference/merchant/retrieve-funding-records) ahora devuelve `refundedAmount`, `failCode` y `failReason` para cada registro. *** ## 2026-09-18 — Prueba de vida de Pix - Woovi * Renombrado: [`POST /v2/merchant/woovi/liveness`](https://docs.velafi.com/es/api-reference/merchant/get-woovi-liveness-url): obtén la URL de prueba de vida para una activación de Pix - Woovi (proporcionada por Avenia). *** ## 2026-09-14 — Consultas de alias y CVU de Argentina * Nuevo [`GET /v2/merchant/check/alias`](https://docs.velafi.com/es/api-reference/beneficiary/check-alias): resuelve un alias argentino a su CBU/CVU, estado y titulares de la cuenta. * Nuevo [`GET /v2/merchant/check/cvu`](https://docs.velafi.com/es/api-reference/beneficiary/check-cvu): consulta el CUIT y el nombre del titular de un CVU o CBU. *** ## 2026-09-07 — Desglose de comisiones en el detalle de la orden * [`GET /v2/order/detail`](https://docs.velafi.com/es/api-reference/order/retrieve-a-specific-order) ahora incluye `orderFeeDetail` para órdenes de fiat a cripto y de cripto a fiat, con `grossAmount`, `netAmount` y `feeLines`. * Para órdenes de fiat a fiat, incluye `onRampOrderFeeDetail` y `offRampOrderFeeDetail`. *** ## 2026-05-28 — Simulador de depósito cripto en sandbox * El nuevo endpoint exclusivo de sandbox `/v2/platform/test/crypto/deposit` agrega fondos cripto de prueba a un comercio. Consulta [Herramientas de prueba en sandbox](https://docs.velafi.com/es/docs/sandbox.md#sandbox-testing-tools). *** ## 2026-04-23 — Detalles de fallo de la orden * [`GET /v2/order/detail`](https://docs.velafi.com/es/api-reference/order/retrieve-a-specific-order) ahora devuelve `failCode` y `failReason` para órdenes de fiat a cripto y de cripto a fiat. *** ## 2026-04-22 — Comentarios en retiros cripto * [`POST /v2/assets/withdraw`](https://docs.velafi.com/es/api-reference/crypto-wallet/create-crypto-withdrawal) acepta un `remark` opcional. * `GET /v2/assets/withdrawalOrders` lo devuelve. *** ## 2026-04-17 — Metadatos de plantillas de pago * Nuevo [`GET /v2/payments/templates/metamessage`](https://docs.velafi.com/es/api-reference/beneficiary/get-payment-templates-metamessage): metadatos a nivel de campo para la plantilla de un método de pago. *** ## 2026-02-28 — Marca de tiempo de expiración de la orden * [`GET /v2/order/detail`](https://docs.velafi.com/es/api-reference/order/retrieve-a-specific-order) devuelve `orderExpireTimestamp` mientras una orden espera su depósito cripto (`orderStatus` `32`). *** ## 2026-02-05 — Simulador de depósito fiat en sandbox * El nuevo endpoint exclusivo de sandbox `/v2/platform/test/deposit` simula un depósito bancario a la cuenta fiat activada de un comercio. Consulta [Herramientas de prueba en sandbox](https://docs.velafi.com/es/docs/sandbox.md#sandbox-testing-tools). *** ## 2026-01-17 — IDs de cotización * Las [cotizaciones cripto](https://docs.velafi.com/es/api-reference/quote/get-user-quote-for-crypto-fiat.md) (`GET /v2/user/crypto-quote`) y las [cotizaciones fiat](https://docs.velafi.com/es/api-reference/quote/get-user-quote-for-fiat-fiat.md) (`GET /v2/user/fiat-quote`) aceptan un parámetro opcional `createQuoteId` y devuelven `quoteId`. * `POST /v2/order/fiat_to_crypto`, `POST /v2/order/crypto_to_fiat` y `POST /v2/order/fiat_to_fiat` aceptan `quoteId`. *** ## 2026-01-08 — Cuentas virtuales * Nuevo [`POST /v2/merchant/virtual/accounts`](https://docs.velafi.com/es/api-reference/merchant/create-multiple-virtual-account): crea una cuenta virtual bajo una cuenta fiat activada. * Nuevo [`GET /v2/merchant/virtual/addfunds`](https://docs.velafi.com/es/api-reference/merchant/get-multiple-virtual-account): lista las cuentas virtuales de un comercio. *** ## 2025-12-12 — ID de orden bancaria en el detalle de la orden * [`GET /v2/order/detail`](https://docs.velafi.com/es/api-reference/order/retrieve-a-specific-order) ahora devuelve `bankOrderId` para órdenes de fiat a cripto y de cripto a fiat. *** ## 2025-12-01 — Registros de flujos fiat * Nuevo [`GET /v2/merchant/fiat/flows`](https://docs.velafi.com/es/api-reference/merchant/get-a-list-merchant-fiat-flow): libro de movimientos del saldo fiat de un comercio. *** ## 2025-11-18 — Actualizaciones de guías y de la referencia de la API Esta versión incluye mejoras amplias de documentación que cubren el flujo de alta de comercios, una guía de límites completamente nueva y páginas actualizadas de la referencia de la API para la gestión de límites de comercios. ### Guías > [accordion] 1. Guía paso a paso > > Se actualizó la descripción del flujo de alta para mayor claridad y para reflejar el proceso más reciente de configuración de comercios. > [accordion] 2. Crear tu comercio > > Se actualizó el proceso de creación de comercios con KYC/KYB, con indicaciones más claras sobre los pasos y requisitos de verificación. > [accordion] 3. Activar la cuenta del comercio > > Se actualizó el flujo de activación de la cuenta del comercio con una explicación más clara de los requisitos para activar la cuenta fiat. > [accordion] 4. Límites — Nueva guía > > Se agregó una nueva guía que presenta los niveles de límite de los comercios, los criterios de aprobación y las instrucciones para solicitar aumentos de límite. ### Referencia de la API > [accordion] 5. Cuenta — Obtener los detalles de la cuenta > > Se actualizó la estructura de la respuesta de la API para incluir información de límites del comercio y campos relacionados. > [accordion] 6. Comercio — Crear comercio > > Se actualizó el flujo KYC/KYB para la creación de comercios. Se agregaron ejemplos mejorados de solicitud y respuesta de la API. > [accordion] 7. Comercio — Obtener una lista de comercios > > Se actualizaron los campos de la API relacionados con los límites del comercio, incluidos el estado del límite y los motivos de aprobación o rechazo. > [accordion] 8. Comercio — Activar la cuenta del comercio (persona física) > > Se actualizó el flujo de activación de las cuentas fiat de comercios que son personas físicas. > [accordion] 9. Comercio — Activar la cuenta del comercio (empresa) > > Se actualizó el flujo de activación de las cuentas fiat de comercios que son empresas, con requisitos de flujo afinados. > [accordion] 10. Comercio — Obtener una lista de cuentas del comercio > > Se actualizaron los campos de respuesta de la API relacionados con los límites de las cuentas del comercio y el seguimiento del estado del límite. > [accordion] 11. Comercio — Aumentar el límite del comercio > > Se actualizó el proceso de aumento del límite del comercio con una lógica de aprobación revisada y definiciones de parámetros mejoradas. *** ## 2025-06-13 — Flujo de creación de comercios con KYC/KYB Esta versión migra el flujo de creación de comercios al modelo KYC/KYB e introduce el endpoint Activar la cuenta del comercio. > [!NOTE] > > Los endpoints publicados antes del **2025-06-13** seguirán funcionando temporalmente, pero está programado que queden obsoletos. Migra al nuevo flujo KYC/KYB lo antes posible para evitar interrupciones. > [card] Actualización del flujo: creación de comercios > > El proceso de creación de comercios se actualizó para adoptar el modelo KYC/KYB. Consulta la guía **Crear tu comercio** para ver los pasos actualizados y los requisitos de verificación. > [card] Actualización de la API: endpoint Crear comercio > > El endpoint de la API `create merchants` se actualizó para alinearse con el nuevo proceso KYC/KYB. Actualiza tu integración para usar el esquema de solicitud revisado. > [card] Nueva guía: activar una cuenta del comercio > > Un nuevo paso de la guía cubre la activación de las cuentas fiat una vez que la entidad del comercio se crea correctamente, para que el comercio quede totalmente operativo para transacciones fiat. > [card] Nuevo endpoint: Activar la cuenta del comercio > > Un nuevo endpoint de la API permite a los comercios activar su cuenta fiat después de completar la configuración inicial del comercio. Esto es obligatorio antes de que el comercio pueda procesar transacciones fiat. *** ## 2025-05-08 — Campos del webhook de registros de fondeo y endpoint de transferencia Esta versión mejora el webhook Funding Records Message Push con información más completa del pagador y agrega un endpoint de transferencia interna de fondos. ### Webhook Funding Records Message Push El payload del webhook ahora incluye dos campos nuevos que proporcionan información más detallada del registro de fondeo para un mejor seguimiento y gestión del origen de los fondos. **payerName** `string` Nombre de la entidad que envía los fondos. **payerAccount** `string` Cuenta bancaria de la entidad que envía los fondos. ### Nuevo endpoint: transferencia interna de fondos Se agregó el endpoint `POST /v2/merchant/transfer` para iniciar transferencias internas de fondos entre cuentas. ```http theme={null} POST /v2/merchant/transfer ``` *** ## 2025-04-14 — Sistema Pending Fund Esta versión introduce el sistema Pending Fund: un nuevo método de pago, tres nuevos endpoints de la API y un webhook dedicado para notificaciones de eventos en tiempo real. ### Nuevo método de pago: VelaFi Pending Fund (ID: 70) Al crear una orden vía API, ahora puedes seleccionar **VelaFi Pending Fund** (ID de pago `70`) como método de pago o de recepción. Usar fondos precargados permite procesar las transacciones más rápido, ya que evita los retrasos de confirmación de transferencias externas. ### Nuevos endpoints de la API **1. Consultar Pending Fund** Consulta el saldo y el estado de tu **cuenta Pending Fund** (fondos pendientes) vía API. También puedes precargar fondos en la cuenta para evitar retrasos por la confirmación de transferencias externas durante las transacciones en vivo. **Ubicación:** Referencia de la API → Comercio **2. Reclamar Pending Fund** Retira en cualquier momento los saldos disponibles de la **cuenta Pending Fund** a un método de pago específico. Esto ofrece una gestión de fondos flexible y bajo demanda. **Ubicación:** Referencia de la API → Comercio **3. Consultar registros de fondeo** Obtén registros detallados de todas las **actividades relacionadas con Pending Fund**, incluidos depósitos, retiros, uso y reembolsos, para una trazabilidad completa y transparencia financiera. **Ubicación:** Referencia de la API → Comercio ### Nuevo webhook: Funding Records Message Push > [card] Funding Records Message Push > > Recibe notificaciones de webhook en tiempo real para eventos de Pending Fund. Cada notificación entrega datos estructurados de la transacción a tu endpoint, lo que mejora la automatización operativa y el monitoreo de fondos. > > **Ubicación:** Webhooks ## Related topics - [Listar registros de fondeo](https://docs.velafi.com/es/api-reference/merchant/retrieve-funding-records.md) - [Webhooks](https://docs.velafi.com/es/docs/guides/webhooks.md) - [Listar flujos fiat](https://docs.velafi.com/es/api-reference/merchant/get-a-list-merchant-fiat-flow.md) - [On-ramp (fiat a cripto)](https://docs.velafi.com/es/docs/guides/on-ramp.md) - [Activar la cuenta de un comercio empresa](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-business.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.