Saltar al contenido principal
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: 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.

​
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.

​
2026-10-30 — Los simuladores de depósito de sandbox requieren autenticación

  • Los simuladores de depósito de sandbox /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

​
2026-09-18 — Prueba de vida de Pix - Woovi

​
2026-09-14 — Consultas de alias y CVU de Argentina

​
2026-09-07 — Desglose de comisiones en el detalle de la orden

  • GET /v2/order/detail 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

​
2026-04-23 — Detalles de fallo de la orden

  • GET /v2/order/detail ahora devuelve failCode y failReason para órdenes de fiat a cripto y de cripto a fiat.

​
2026-04-22 — Comentarios en retiros cripto

​
2026-04-17 — Metadatos de plantillas de pago

​
2026-02-28 — Marca de tiempo de expiración de la orden

  • GET /v2/order/detail 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.

​
2026-01-17 — IDs de cotización

  • Las cotizaciones cripto (GET /v2/user/crypto-quote) y las cotizaciones fiat (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

​
2025-12-12 — ID de orden bancaria en el detalle de la orden

  • GET /v2/order/detail ahora devuelve bankOrderId para órdenes de fiat a cripto y de cripto a fiat.

​
2025-12-01 — Registros de flujos fiat

​
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

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.
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.
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.
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

Se actualizó la estructura de la respuesta de la API para incluir información de límites del comercio y campos relacionados.
Se actualizó el flujo KYC/KYB para la creación de comercios. Se agregaron ejemplos mejorados de solicitud y respuesta de la API.
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.
Se actualizó el flujo de activación de las cuentas fiat de comercios que son personas físicas.
Se actualizó el flujo de activación de las cuentas fiat de comercios que son empresas, con requisitos de flujo afinados.
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.
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.
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.

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.

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.

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.

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.
​
string
Nombre de la entidad que envía los fondos.
​
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.

​
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

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