Saltar al contenido principal
En VelaFi, un comercio es una entidad verificada, persona física o empresa, que aprobó la revisión de cumplimiento y recibió un ID de comercio (MID) único. Toda llamada a la API relacionada con transacciones, gestión de cuentas y liquidaciones requiere un MID, por lo que crear el comercio es el paso fundamental antes de poder procesar cualquier pago.

Verificación KYC y KYB

VelaFi opera dentro de un ecosistema regulado, así que todo comercio debe completar la verificación de identidad antes de operar. Las personas físicas pasan por la verificación Know Your Customer (KYC); las empresas, por la verificación Know Your Business (KYB). Cuando envías una solicitud de creación de comercio, la API responde con una URL de redirección única que abre la página de verificación segura de VelaFi. Tienes dos opciones para mostrar esa página de verificación a tus usuarios:

Modo de redirección

Envía al usuario directamente a la URL de redirección que devuelve la API. Es la integración más rápida y no requiere cambios en tu front-end.

Modo integrado

Integra la página de verificación dentro de tu propia aplicación con un <iframe>. Así los usuarios permanecen en tu producto y obtienen una experiencia fluida y de marca blanca.
La URL de verificación tiene un tiempo limitado. Úsala en cuanto la recibas en la respuesta de la API: puede expirar o dejar de ser válida según la sesión y la configuración.
Cuando la verificación es exitosa, VelaFi asigna un MID permanente al comercio. Usa este MID en todas las solicitudes posteriores a la API.

Referencia de estados del comercio

Después de enviar una solicitud de creación de comercio, el comercio pasa por los siguientes estados. Consulta el endpoint Listar comercios para revisar el estado actual.

Modos de gestión de comercios

VelaFi ofrece dos modelos de operación. Elige el que mejor se adapte a la arquitectura de tu plataforma y a tu postura de cumplimiento.

Gestión de múltiples comercios

Después de que la cuenta de tu comercio principal completa la verificación KYB, puedes crear y gestionar subcomercios, ya sean personas físicas o entidades, bajo tu cuenta. Esto permite una gestión jerárquica de comercios con control de acceso flexible basado en roles. Casos de uso comunes:
  • Agregadores que gestionan el cumplimiento de varios clientes finales
  • Plataformas de infraestructura de pagos que ofrecen servicios a subcomercios
  • Operadores de marketplaces que gestionan el cumplimiento de cada vendedor de forma independiente

Modo Reliance

Si tienes una licencia de institución financiera, puedes solicitar que se habilite el modo Reliance. Este modo te da autonomía total sobre el flujo de incorporación de comercios, mientras VelaFi proporciona la infraestructura subyacente.
En el modo Reliance, tú eres responsable de la incorporación de comercios, la revisión continua y el monitoreo de cumplimiento. VelaFi no interviene en tu flujo: proporciona la infraestructura técnica, los canales de liquidación y el soporte regulatorio para que las transacciones sean seguras y cumplan la normativa.
El modo Reliance requiere una revisión de cumplimiento adicional por parte del equipo de cumplimiento de VelaFi antes de poder habilitarse en tu cuenta. Contacta a tu representante de VelaFi para iniciar la solicitud.

Activación de canales de pago fiat

Una vez creado y verificado un comercio, activa los canales de moneda fiat que necesites. Las monedas admitidas son MXN, ARS, BRL, COP, PEN, USD y EUR. La activación permite enviar y recibir fondos a través de los canales bancarios locales de cada país.
1

Elige tu endpoint de activación

Selecciona el endpoint que corresponda al tipo de comercio, persona física o empresa, y a la moneda fiat de destino.
2

Envía la solicitud de activación

Envía la solicitud con el MID del comercio, la moneda fiat y el trench (canal de pago). La respuesta devuelve el status del canal: los canales locales devuelven 1 (pendiente) o 2 (activo), y USD/EUR Lead Bank devuelve 4 con un verifyLink que el comercio debe completar. Los comercios de tipo empresa pueden recibir en su lugar 0 con un verifyLink para una verificación adicional de la empresa. Un 3 significa que la activación falló; consulta failReason.
3

Recibe los datos de la cuenta virtual

Cuando Listar cuentas del comercio muestre el estado 2, obtén los datos de depósito del canal con Obtener cuenta Pending Fund. Por ejemplo, los canales ARS devuelven un número CVU y un CUIT vinculados a la red bancaria de Argentina.
4

Fondea mediante transferencia bancaria

Los comercios pueden depositar fondos en su cuenta virtual con una transferencia bancaria estándar. VelaFi concilia automáticamente la transacción entrante y acredita el saldo de la cuenta del comercio.

Datos de la cuenta virtual por país

Cada canal fiat activado proporciona una cuenta virtual dedicada para que los pagos entrantes se asocien automáticamente al comercio correcto.
Cada canal fiat admite tanto cuentas personales como empresariales, lo que te da flexibilidad en una amplia variedad de escenarios de pago.