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

# Crear un comercio

> Registra un nuevo comercio, persona física o empresa, dentro del marco de cumplimiento de VelaFi y recibe un enlace único de verificación KYC/KYB.

Usa este endpoint para crear una nueva entidad de comercio e iniciar el proceso de verificación KYC (persona física) o KYB (empresa). Una vez que envías los campos obligatorios, VelaFi asigna un Merchant ID único y devuelve un enlace de verificación alojado que tu usuario final debe completar. También puedes volver a generar un enlace de verificación para un comercio existente pero no verificado enviando solo su `merchantId` y su `callbackUrl`.

> [!NOTE]
>
> Todas las solicitudes deben incluir el header `X-BH-TOKEN` con un token de negocio obtenido de `GET /v2/token/generate` y `Content-Type: application/json`.

## Endpoint

`POST https://api.velafi.com/v2/merchants`

## Parámetros de la solicitud: comercio nuevo (KYC/KYB)

**merchantName** `string` *required*

Nombre para mostrar único del comercio.

**email** `string` *required*

Dirección de correo electrónico única de la cuenta del comercio.

**merchantType** `string` *required*

Tipo de entidad del comercio. Valores aceptados: `INDIVIDUAL`, `BUSINESS`.

**callbackUrl** `string` *required*

URL a la que VelaFi llama cuando se completa la verificación KYC/KYB.

**languageCode** `string`

Idioma de la interfaz de KYC/KYB. Valores aceptados: `en` (predeterminado), `es`, `pt`, `zh`.

**flow** `string`

Flujo de verificación KYC, solo para comercios `INDIVIDUAL`. Valores aceptados: `PROFESSIONALS` (predeterminado), `CONSUMERS`.

**remark** `string`

Nota de texto libre que se adjunta al registro del comercio.

**industryType** `string` *required*

La categoría de industria del comercio. Valores aceptados:

`payment_psp`, `fintech`, `lending`, `fx_or_otc`, `e-commerce`, `gaming_or_entertainment`, `crypto_or_web3`, `supply_chain`, `import_or_export`, `payroll_or_hr`, `media_or_advertising`, `remittance_or_money_transfer`, `treasury_or_asset_management`, `wholesale_or_b2b_marketplace`, `logistics_and_courier`, `digital_content_or_streaming`, `travel_or_booking`, `online_marketplace`, `investment_and_crowdfunding`, `real_estate_and_proptech`, `accounting_or_billing`, `freelancer_platform`, `saas_or_api`, `online_education`, `outsourcing_agency`, `other`

**industryTypeRemark** `string`

Obligatorio cuando `industryType` es `other`. Describe la industria específica del comercio.

## Parámetros de la solicitud: comercio no verificado (volver a generar el enlace)

Usa esta variante cuando el comercio ya existe pero todavía no ha completado la verificación.

**merchantId** `number` *required*

El ID del comercio existente.

**callbackUrl** `string` *required*

URL a la que VelaFi llama cuando se completa la verificación KYC/KYB.

**languageCode** `string`

Idioma de la interfaz de KYC/KYB. Valores aceptados: `en` (predeterminado), `es`, `pt`, `zh`.

## Campos de la respuesta

**code** `number`

Código de respuesta de estilo HTTP. `200` indica éxito.

**msg** `string`

Mensaje de estado legible, por ejemplo `SUCCESS`.

**data** `object`

**campos de data**

**merchantId** `number`

El identificador único asignado al comercio.

**kycLink** `string`

URL alojada que el comercio debe visitar para completar la verificación KYC/KYB.

## Ejemplos

```bash Comercio nuevo: cURL theme={null}
curl -X POST https://api.velafi.com/v2/merchants \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantName": "Tom",
    "email": "tom@example.com",
    "merchantType": "INDIVIDUAL",
    "callbackUrl": "https://your-app.com/kyc-callback",
    "languageCode": "en",
    "flow": "PROFESSIONALS",
    "industryType": "fintech"
  }'
```

```bash Comercio no verificado: cURL theme={null}
curl -X POST https://api.velafi.com/v2/merchants \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": 100001,
    "callbackUrl": "https://your-app.com/kyc-callback",
    "languageCode": "en"
  }'
```

```json Comercio nuevo: respuesta theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "merchantId": 100001,
    "kycLink": "https://www.velafi.com/verify?velafi_token=abc123"
  }
}
```

```json Comercio no verificado: respuesta theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "merchantId": 100001,
    "kycLink": "https://www.velafi.com/verify?velafi_token=xyz789"
  }
}
```

> [!TIP]
>
> Dirige a tu usuario final a la URL de `kycLink` en cuanto la recibas. Los enlaces vencen y no se pueden reutilizar una vez que comienza la verificación.


## Related topics

- [Crear un comercio](https://docs.velafi.com/es/docs/guides/creating-merchant.md)
- [Crear una cuenta](https://docs.velafi.com/es/docs/guides/creating-account.md)
- [Inicio rápido](https://docs.velafi.com/es/docs/quickstart.md)
- [Crear un retiro cripto](https://docs.velafi.com/es/api-reference/crypto-wallet/create-crypto-withdrawal.md)
- [Crear un webhook](https://docs.velafi.com/es/api-reference/webhooks/create-webhook-endpoints.md)


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