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

# Activar la cuenta de un comercio empresa

> Activa un canal de pago fiat para un comercio empresarial en las monedas MXN, ARS, COP, BRL, PEN, USD y EUR y sus proveedores de pago.

Usa este endpoint para activar uno o más canales de pago fiat para un comercio empresarial (tipo BUSINESS). El proceso es similar al flujo de activación de personas físicas, pero las cuentas empresariales normalmente requieren menos campos personales y, según el proveedor de pago, pueden requerir en cambio datos de registro de la empresa e información del UBO (beneficiario final).

> [!NOTE]
>
> Todas las solicitudes deben incluir el header `X-BH-TOKEN` y `Content-Type: application/json`.

## Endpoint

`POST https://api.velafi.com/v2/merchant/accounts`

## Campos principales de la solicitud

**merchantId** `string` *required*

El ID del comercio empresarial que se va a activar.

**fiat** `string` *required*

Moneda fiat de destino. Valores admitidos: `MXN`, `ARS`, `COP`, `BRL`, `PEN`, `EUR`, `USD`.

**trench** `string` *required*

Identificador del proveedor de pago o del tipo de cuenta. Debe coincidir con un valor admitido para el `fiat` elegido.

**callbackUri** `string`

URL de redirección después de que el comercio acepta un acuerdo de cumplimiento. La usan los canales de Lead Bank; si la omites, se usa una URL de redirección predeterminada de VelaFi.

**fieldList** `object`

Campos específicos del canal. El contenido varía según `fiat` y `trench`. Consulta los ejemplos por moneda más abajo.

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

**fiat** `string`

La moneda fiat que se activó.

**status** `number`

Estado del canal: `0` = inicializado (cuando se devuelve con un `verifyLink`, se requiere una verificación adicional de la empresa; consulta más abajo), `1` = pendiente (el canal se está abriendo o revisando), `2` = activo, `3` = fallido (consulta `failReason`), `4` = incompleto (se requieren pasos adicionales, por ejemplo en `verifyLink`). Consulta [Listar cuentas del comercio](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchant-accounts.md) periódicamente hasta que `status` sea `2`.

**verifyLink** `string`

Una URL que la empresa debe abrir para continuar. Se devuelve con `status: 0` cuando se requiere una verificación adicional de la empresa, y para los canales USD/EUR de Lead Bank, donde la empresa completa el acuerdo de cumplimiento requerido.

**failReason** `string`

Describe por qué falló la activación, si aplica.

## Cómo funciona la activación empresarial

Una activación empresarial sigue uno de dos caminos. La respuesta te indica cuál se aplicó.

**Verificación adicional de la empresa (`status: 0` con un `verifyLink`).** Para un comercio empresarial, los canales locales de MXN (`CLABE - FINCO PAY`, `CLABE - TESORED`), COP (`COP Account`), ARS (`CVU - Momentum`, `QR Argentina`), BRL (`BANCO GENIAL`) y PEN (`PEN Account`) normalmente requieren una verificación KYB adicional para ese canal. La respuesta devuelve `status: 0` y un `verifyLink`. Envía a la empresa al enlace para que complete la verificación. Cuando VelaFi la aprueba, el canal se abre automáticamente, así que no necesitas volver a llamar a este endpoint. En este camino, el `fieldList` de tu solicitud no se usa.

**Activación directa.** Si VelaFi habilitó la activación directa para tu cuenta, el canal se abre a partir de tu solicitud y `fieldList` debe contener los campos obligatorios del canal. Si falta un campo o es inválido, la solicitud se rechaza.

| Trench | Campos obligatorios de `fieldList` |
| - | - |
| `CLABE - FINCO PAY` | `alias` (hasta 40 caracteres) |
| `CLABE - TESORED` | `alias` (hasta 64 caracteres) |
| `COP Account` | `alias` (hasta 64 caracteres) |
| `CVU - Momentum` | `cuit`, `name`; `alias` es opcional |
| `QR Argentina` | `cuit` (hasta 40 caracteres) |
| `PEN Account` | `customerIdentificationType`, `customerIdentification`, `customerName`, `customerEmail`, `customerPhone` (solo dígitos, hasta 9) |
| `BANCO GENIAL` | Ninguno |

## Ejemplos por moneda

> [tab] MXN
>
> **MXN: SPEI vía Finco Pay** (`trench: "CLABE - FINCO PAY"`)
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "MXN",
>   "trench": "CLABE - FINCO PAY"
> }
> ```
>
> **MXN: SPEI vía Tesored** (`trench: "CLABE - TESORED"`)
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "MXN",
>   "trench": "CLABE - TESORED"
> }
> ```

> [tab] ARS
>
> **ARS: CVU vía Momentum** (`trench: "CVU - Momentum"`)
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "ARS",
>   "trench": "CVU - Momentum"
> }
> ```
>
> **ARS: transferencia QR 3.0** (`trench: "QR Argentina"`)
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "ARS",
>   "trench": "QR Argentina",
>   "fieldList": { "cuit": "123456789" }
> }
> ```

> [tab] COP / BRL / PEN
>
> **COP: PSE / ACH / Bre-B** (`trench: "COP Account"`)
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "COP",
>   "trench": "COP Account"
> }
> ```
>
> **BRL: Pix vía Genial** (`trench: "BANCO GENIAL"`)
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "BRL",
>   "trench": "BANCO GENIAL"
> }
> ```
>
> **PEN: transferencia bancaria** (`trench: "PEN Account"`)
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "PEN",
>   "trench": "PEN Account"
> }
> ```

> [tab] BRL Woovi (empresa)
>
> **BRL: Pix vía Woovi**. Requiere la información completa de la empresa y de los UBO.
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "BRL",
>   "trench": "Pix - Woovi",
>   "fieldList": {
>     "companyInfo": {
>       "companyName": "EXEMPLO TECNOLOGIA LTDA.",
>       "companyDescription": "Fintech platform",
>       "countryStateOfIncorporation": "BR-SP",
>       "website": "example.com.br",
>       "socialMedia": "@example",
>       "street1": "Avenida Paulista, 1000",
>       "city": "São Paulo",
>       "countryStateCode": "BR-SP",
>       "postcode": "01310-100",
>       "reasonForAccountOpening": "ecommerce_retail_payments",
>       "sourceOfFunds": "sales_of_goods_and_services",
>       "numberOfEmployees": "11-50",
>       "estimatedAnnualRevenueUsd": "1m_to_10m",
>       "estimatedMonthlyVolumeUsd": 10000,
>       "companyRegistrationNumber": "00000000000001",
>       "taxIdentificationNumberTin": "00000000000002",
>       "taxIdentificationDocumentUrl": "100001/00000000-0000-0000-0000-000000000002.pdf",
>       "certificateOfIncorporationDocumentUrl": "100001/00000000-0000-0000-0000-000000000003.pdf"
>     },
>     "companyUbosInfo": [
>       {
>         "personType": "CEO",
>         "firstName": "Maria",
>         "lastName": "Silva",
>         "email": "maria@example.com",
>         "phone": "+5511999990000",
>         "percentageOfOwnership": 0.51,
>         "nationality": "BR",
>         "taxIdentificationNumber": "000000000000000000",
>         "dateOfBirth": "1985-03-20",
>         "street1": "Rua Augusta, 500",
>         "city": "São Paulo",
>         "countryStateCode": "BR-SP",
>         "postcode": "01305-000",
>         "idType": "1",
>         "govIdCountryAbbr": "BR",
>         "govIdFrontUrl": "100001/00000000-0000-0000-0000-000000000001.jpg"
>       }
>     ]
>   }
> }
> ```

> [tab] USD/EUR
>
> **USD/EUR: Lead Bank** (`trench: "Lead Bank"`)
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "EUR",
>   "trench": "Lead Bank",
>   "callbackUri": "https://your-app.com/agreement-callback",
>   "fieldList": {
>     "email": "admin@company.com",
>     "companyName": "Example Company Inc"
>   }
> }
> ```
>
> **Multimoneda: Circle Payment Network** (`trench: "Circle Payment Network"`)
>
> Admite: USD, HKD, EUR, SGD, NGN. Solo pagos (payout).
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "USD",
>   "trench": "Circle Payment Network"
> }
> ```

## Ejemplos de respuesta

```json Verificación adicional de la empresa (status 0) theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "fiat": "MXN",
    "status": 0,
    "verifyLink": "https://verify-sandbox.aiprise.com/?business_onboarding_session_id=xxx",
    "failReason": ""
  }
}
```

```json USD / EUR (requiere acuerdo) theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "fiat": "USD",
    "status": 4,
    "verifyLink": "https://www.velafi.com/business/channel/verify?token=12ceff08",
    "failReason": ""
  }
}
```

> [!WARNING]
>
> Las activaciones empresariales de BRL Woovi requieren un `companyInfo` completo y de 1 a 50 entradas en `companyUbosInfo`. Los campos de documentos (`certificateOfIncorporationDocumentUrl`, `taxIdentificationDocumentUrl` y el `govIdFrontUrl` de cada UBO) deben ser valores `fileUrl` devueltos por [Subir archivo](https://docs.velafi.com/es/api-reference/basic-configuration/upload-file.md). Las URL públicas se rechazan. Si faltan campos o son inválidos, la activación falla de inmediato.


## Related topics

- [Activar la cuenta de un comercio](https://docs.velafi.com/es/docs/guides/activating-merchant-account.md)
- [Activar la cuenta de un comercio persona física](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-individual.md)
- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Comercios](https://docs.velafi.com/es/docs/merchants.md)
- [Crear un comercio](https://docs.velafi.com/es/docs/guides/creating-merchant.md)


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