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

# Comercios

> Crea y verifica comercios de personas físicas o empresas, elige un modo de gestión y activa canales de pago fiat en siete monedas y países.

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:

> [card] 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.

> [card] 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.

> [!WARNING]
>
> 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](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchants.md) para revisar el estado actual.

| Código de estado | Estado | Descripción |
| - | - | - |
| 1 | En autenticación | La verificación KYC/KYB está en curso. |
| 2 | Normal | La verificación se aprobó. El comercio está activo y puede operar. |
| 3 | Autenticación fallida | La verificación se rechazó. Obtén el motivo del rechazo y vuelve a enviarla. |
| 4 | Incompleta | La verificación se inició pero no se completó. Usa el enlace de KYC original o crea uno nuevo. |

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

> [!NOTE]
>
> 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.

> [!NOTE]
>
> 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.

| Endpoint | Caso de uso |
| - | - |
| [Activar cuenta del comercio (persona física)](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-individual.md) | Cuentas personales para comercios verificados con KYC |
| [Activar cuenta del comercio (empresa)](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-business.md) | Cuentas corporativas para comercios verificados con KYB |

**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](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchant-accounts.md) muestre el estado `2`, obtén los datos de depósito del canal con [Obtener cuenta Pending Fund](https://docs.velafi.com/es/api-reference/merchant/get-pending-fund-account.md). 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.

| País | Moneda | Tipo de cuenta virtual |
| - | - | - |
| 🇦🇷 Argentina | ARS | Número CVU + CUIT |
| 🇧🇷 Brasil | BRL | Clave Pix / cuenta bancaria |
| 🇨🇴 Colombia | COP | Cuenta bancaria local |
| 🇲🇽 México | MXN | CLABE |
| 🇵🇪 Perú | PEN | Cuenta bancaria |
| 🇺🇸 Estados Unidos | USD / EUR | USD: datos de ruteo ACH / FedWire; EUR: SEPA |

> [!TIP]
>
> Cada canal fiat admite tanto cuentas personales como empresariales, lo que te da flexibilidad en una amplia variedad de escenarios de pago.


## Related topics

- [Listar comercios](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchants.md)
- [Crear un comercio](https://docs.velafi.com/es/docs/guides/creating-merchant.md)
- [Listar cuentas de comercio](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchant-accounts.md)
- [Activar la cuenta de un comercio](https://docs.velafi.com/es/docs/guides/activating-merchant-account.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.