> ## 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 > Activa canales de pago en moneda fiat para un comercio y habilita depósitos y retiros bancarios locales en MXN, ARS, BRL, COP, PEN, USD y EUR. Activar la cuenta de pago fiat de un comercio le da acceso a canales bancarios locales en los países admitidos. Una vez activada, el comercio recibe una cuenta virtual dedicada (por ejemplo, un número CVU/CUIT para Argentina) y puede empezar de inmediato a enviar y recibir fondos por transferencia bancaria o por canales de pago locales. VelaFi concilia automáticamente los depósitos entrantes y los acredita al saldo de la cuenta del comercio. Se admiten cuentas de persona física y de empresa, así que puedes activar cuentas para usuarios finales y clientes corporativos dentro de la misma integración. ## Monedas admitidas | Moneda | País | Métodos de pago de ejemplo | | - | - | - | | `MXN` | México | SPEI mediante Finco Pay, SPEI mediante Tesored | | `ARS` | Argentina | CBU/CVU (Momentum), Transferencia 3.0 (QR) | | `BRL` | Brasil | Pix (Genial), Pix - Woovi (Avenia) | | `COP` | Colombia | PSE, ACH, Bre-B | | `PEN` | Perú | Transferencia bancaria | | `USD` | EE. UU. / Global | ACH, Wire, SEPA (Lead Bank); Wire, SEPA, FEDWIRE (CPN) | | `EUR` | Europa | SEPA (Lead Bank), SEPA (CPN) | > [!NOTE] > > Activar una cuenta `EUR` mediante Lead Bank también habilita transacciones en `USD` a través de la misma cuenta. *** ## Endpoint Las activaciones de persona física y de empresa usan el mismo endpoint: ``` POST https://api.velafi.com/v2/merchant/accounts ``` **Headers** ```http theme={null} X-BH-TOKEN: Content-Type: application/json ``` *** ## Activar para un comercio persona física Usa esta ruta cuando el `merchantType` del comercio sea `INDIVIDUAL`. ### Parámetros principales de la solicitud **merchantId** `string` *required* El ID del comercio que se devolvió cuando creaste el comercio. **fiat** `string` *required* La moneda fiat que se va a activar. Valores aceptados: `MXN`, `ARS`, `BRL`, `COP`, `PEN`, `USD`, `EUR`. **trench** `string` *required* El canal de pago (proveedor) que se usará para esta moneda. Los valores de trench disponibles dependen del `fiat` seleccionado. Consulta los ejemplos más abajo para ver la lista completa. **fieldList** `object` Campos adicionales específicos del canal que requiere el trench seleccionado. Los campos obligatorios varían según la moneda y el proveedor; consulta los ejemplos más abajo. **callbackUri** `string` Opcional. Para cuentas USD/EUR mediante Lead Bank, la URL a la que se redirige al usuario después de aceptar el acuerdo de la cuenta. Si la omites, se usa una URL de redirección predeterminada de VelaFi. ### Solicitudes de ejemplo (persona física) > [accordion] México MXN — SPEI (Finco Pay) > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "MXN", > "trench": "CLABE - FINCO PAY", > "fieldList": { > "alias": "my_alias" > } > } > ``` > [accordion] México MXN — SPEI (Tesored) > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "MXN", > "trench": "CLABE - TESORED", > "fieldList": { > "alias": "my_alias" > } > } > ``` > [accordion] Argentina ARS — CBU/CVU (Momentum) > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "ARS", > "trench": "CVU - Momentum", > "fieldList": { > "email": "user@example.com", > "cuit": "30000000001", > "name": "EXAMPLE COMPANY SA", > "alias": "my.alias" > } > } > ``` > [accordion] Argentina ARS — Transferencia 3.0 (QR) > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "ARS", > "trench": "QR Argentina", > "fieldList": { > "cuit": "123456789" > } > } > ``` > [accordion] Brasil BRL — Pix (Genial) > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "BRL", > "trench": "BANCO GENIAL" > } > ``` > [accordion] Colombia COP — PSE/ACH/Bre-B > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "COP", > "trench": "COP Account", > "fieldList": { > "alias": "my.alias" > } > } > ``` > [accordion] Perú PEN — Transferencia bancaria > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "PEN", > "trench": "PEN Account", > "fieldList": { > "customerIdentificationType": "00", > "customerIdentification": "12345678", > "customerName": "Tom", > "lastName": "Garcia", > "customerEmail": "tom@example.com", > "customerPhone": "975728895" > } > } > ``` > [accordion] EUR/USD — Lead Bank > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "EUR", > "trench": "Lead Bank", > "callbackUri": "https://yourapp.com/account/verified", > "fieldList": { > "email": "user@example.com", > "firstName": "Maria", > "lastName": "Lopez" > } > } > ``` > [!NOTE] > > **Brasil BRL — Pix (Woovi) para personas físicas:** primero llama a [Obtener la URL de prueba de vida de Woovi](https://docs.velafi.com/es/api-reference/merchant/get-woovi-liveness-url.md) y pide al comercio que complete la prueba de vida. Después llama a este endpoint con `trench: "Pix - Woovi"` y un objeto `personalInfo` (consulta [Activar persona física](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-individual.md)). Si la prueba de vida no está completa, la solicitud falla con el código de error `-5059`. *** ## Activar para un comercio empresa Usa esta ruta cuando el `merchantType` del comercio sea `BUSINESS`. El endpoint y los parámetros principales son idénticos; la estructura de `fieldList` cambia en los canales que requieren información detallada de la empresa y de los UBO (beneficiarios finales). Si tu cuenta no usa Reliance Mode, activar `CLABE - FINCO PAY`, `CLABE - TESORED`, `CVU - Momentum`, `QR Argentina`, `COP Account`, `BANCO GENIAL` o `PEN Account` para un comercio empresa devuelve `status: 0` y un `verifyLink` para una verificación adicional de la empresa, en lugar de abrir el canal directamente. Consulta [Activar empresa](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-business.md). ### Solicitudes de ejemplo (empresa) > [accordion] México MXN — SPEI (Finco Pay) > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "MXN", > "trench": "CLABE - FINCO PAY" > } > ``` > [accordion] Argentina ARS — CBU/CVU (Momentum) > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "ARS", > "trench": "CVU - Momentum" > } > ``` > [accordion] Brasil BRL — Pix (Woovi) — Ejemplo completo de empresa > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "BRL", > "trench": "Pix - Woovi", > "fieldList": { > "companyInfo": { > "companyName": "EXEMPLO TECNOLOGIA LTDA.", > "companyDescription": "Fintech payments provider", > "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": 50000, > "companyRegistrationNumber": "00000000000001", > "taxIdentificationNumberTin": "00000000000002", > "taxIdentificationDocumentUrl": "100001/00000000-0000-0000-0000-000000000002.pdf", > "certificateOfIncorporationDocumentUrl": "100001/00000000-0000-0000-0000-000000000003.pdf" > }, > "companyUbosInfo": [ > { > "personType": "CEO", > "firstName": "Ana", > "lastName": "Souza", > "email": "ana@example.com", > "phone": "+5511999999999", > "percentageOfOwnership": 1, > "nationality": "BR", > "taxIdentificationNumber": "000000000000000000", > "dateOfBirth": "1985-03-22", > "street1": "Rua das Flores, 42", > "city": "São Paulo", > "countryStateCode": "BR-SP", > "postcode": "01310-100", > "idType": "3", > "govIdCountryAbbr": "BR", > "govIdFrontUrl": "100001/00000000-0000-0000-0000-000000000001.jpg" > } > ] > } > } > ``` > [accordion] EUR/USD — Lead Bank (empresa) > > ```json theme={null} > { > "merchantId": "100001", > "fiat": "EUR", > "trench": "Lead Bank", > "callbackUri": "https://yourapp.com/account/verified", > "fieldList": { > "email": "finance@acme.com", > "companyName": "Acme Payments Ltd" > } > } > ``` *** ## Respuesta ### Campos de la respuesta **code** `number` Código de respuesta. `200` indica que la solicitud fue aceptada. **msg** `string` Mensaje de resultado legible, por ejemplo `SUCCESS`. **data** `object` **campos de data** **fiat** `string` La moneda que se activó. **status** `number` Estado del canal: `0` = inicializado (con un `verifyLink`, se requiere una verificación adicional de la empresa), `1` = pendiente, `2` = activo, `3` = fallido (consulta `failReason`), `4` = incompleto (por ejemplo, cuentas de Lead Bank que todavía necesitan los pasos en `verifyLink`). Consulta periódicamente [Listar cuentas del comercio](https://docs.velafi.com/es/api-reference/merchant/get-a-list-of-merchant-accounts.md) hasta que `status` sea `2`. **verifyLink** `string` Un enlace que el comercio debe abrir para continuar la activación. Para cuentas USD/EUR de Lead Bank, lleva al acuerdo de la cuenta; para comercios empresa que necesitan una verificación adicional de la empresa, se devuelve con `status: 0`. **failReason** `string` Descripción de cualquier falla. Vacío en caso de éxito. > [tab] MXN / ARS / COP / BRL / PEN > > ```json theme={null} > { > "code": 200, > "msg": "SUCCESS", > "data": { > "fiat": "MXN", > "status": 1, > "failReason": "" > } > } > ``` > [tab] USD / EUR > > ```json theme={null} > { > "code": 200, > "msg": "SUCCESS", > "data": { > "fiat": "USD", > "status": 4, > "verifyLink": "https://www.velafi.com/business/channel/verify?token=12ceff08f9621808b5a573972cdfb10f", > "failReason": "" > } > } > ``` *** ## Cómo se concilian los fondos Una vez que la cuenta de un comercio está activa, recibe datos bancarios dedicados, como un número CLABE para México o un CVU/CUIT para Argentina. El comercio puede indicar a sus pagadores que envíen transferencias bancarias a esos datos. VelaFi detecta y concilia automáticamente las transferencias entrantes con el saldo del comercio y acredita la cuenta sin que tengas que intervenir manualmente. > [!WARNING] > > Algunas monedas y configuraciones de trench requieren documentación adicional (por ejemplo, documentos de identidad para Brasil Pix - Woovi o actas constitutivas para cuentas de empresa). Escribe a [contact@velafi.com](mailto:contact@velafi.com) para obtener la lista completa de documentos requeridos por país y tipo de cuenta antes de iniciar la activación. ## Related topics - [Activar la cuenta de un comercio empresa](https://docs.velafi.com/es/api-reference/merchant/activate-merchant-account-for-business.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) - [Introducción](https://docs.velafi.com/es/docs/introduction.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.