> ## 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 comercio persona física o empresa, inicia la verificación KYC/KYB y recibe un Merchant ID para usar en todas las llamadas posteriores a la API. Toda entidad que envíe o reciba dinero a través de VelaFi debe estar registrada como **comercio** y aprobar la verificación de identidad. VelaFi usa este proceso para cumplir con las regulaciones de Conoce a tu Cliente (KYC) y Conoce tu Negocio (KYB). Una vez completada la verificación, la plataforma asigna a la entidad un **Merchant ID (MID)** único. Debes incluir este MID en cada llamada posterior a la API relacionada con transacciones, administración de la cuenta y liquidaciones. ## Por qué se requieren los comercios VelaFi opera dentro de un ecosistema financiero regulado. Cada registro de comercio vincula a una persona o empresa real con su actividad de on-ramp, off-ramp y pagos globales. La revisión de cumplimiento garantiza que todas las partes cumplan con los estándares de prevención de lavado de dinero (AML) y de combate al financiamiento del terrorismo (CFT) antes de que se mueva cualquier fondo. *** ## Crear un comercio Envía una solicitud `POST` a `/v2/merchants` para registrar un nuevo comercio persona física o empresa e iniciar el flujo de verificación. **Endpoint** ``` POST https://api.velafi.com/v2/merchants ``` **Headers** ```http theme={null} X-BH-TOKEN: Content-Type: application/json ``` ### Parámetros de la solicitud **merchantName** `string` *required* Nombre completo o razón social del comercio. Debe ser único dentro de tu cuenta. **email** `string` *required* Correo electrónico del comercio. Debe ser único dentro de tu cuenta. **merchantType** `string` *required* Tipo de entidad del comercio. Valores aceptados: `INDIVIDUAL`, `BUSINESS`. **callbackUrl** `string` *required* URL a la que VelaFi llama cuando termina el proceso de KYC/KYB (con éxito o con falla). VelaFi envía una notificación POST a esta URL. **industryType** `string` Sector de la industria del comercio. **Obligatorio cuando `merchantType` es `BUSINESS`.** 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`. **flow** `string` Flujo de KYC, solo para comercios `INDIVIDUAL`. Valores aceptados: `PROFESSIONALS` (predeterminado), `CONSUMERS`. **languageCode** `string` Idioma de la interfaz de verificación KYC/KYB. Valores aceptados: `en` (predeterminado), `es`, `pt`, `zh`. **remark** `string` Nota opcional de texto libre para adjuntar a este registro de comercio. **industryTypeRemark** `string` Obligatorio cuando `industryType` es `other`. Proporciona una descripción breve de la industria real del comercio. ### Ejemplo de solicitud ```bash cURL theme={null} curl -X POST https://api.velafi.com/v2/merchants \ -H "X-BH-TOKEN: " \ -H "Content-Type: application/json" \ -d '{ "merchantName": "Acme Payments Ltd", "email": "payments@acme.com", "merchantType": "BUSINESS", "callbackUrl": "https://acme.com/webhooks/kyc", "languageCode": "en", "industryType": "fintech", "remark": "Primary merchant account" }' ``` ```json Cuerpo de la solicitud theme={null} { "merchantName": "Acme Payments Ltd", "email": "payments@acme.com", "merchantType": "BUSINESS", "callbackUrl": "https://acme.com/webhooks/kyc", "languageCode": "en", "industryType": "fintech", "remark": "Primary merchant account" } ``` ### Campos de la respuesta **code** `number` Código de respuesta. `200` indica éxito. **msg** `string` Mensaje de resultado legible, por ejemplo `SUCCESS`. **data** `object` **campos de data** **merchantId** `number` Merchant ID (MID) único asignado a este comercio. Guarda este valor: lo necesitas para todas las llamadas posteriores a la API. **kycLink** `string` URL que lleva a la página segura de verificación KYC/KYB de VelaFi. Redirige a tu usuario a esta URL o insértala en un iframe. ```json Ejemplo de respuesta theme={null} { "code": 200, "msg": "SUCCESS", "data": { "merchantId": 100001, "kycLink": "https://www.velafi.com/verify?velafi_token=abc123" } } ``` *** ## Completar la verificación KYC/KYB Después de una llamada exitosa a `POST /v2/merchants`, dirige a tu usuario a la URL de `kycLink` para completar la verificación de identidad. Tienes dos opciones de integración: > [tab] Modo de redirección > > Redirige el navegador del usuario directamente a la URL de `kycLink`. Es la integración más sencilla: el usuario completa la verificación en la página alojada por VelaFi y regresa a tu `callbackUrl` al terminar. > > ```javascript theme={null} > window.location.href = data.kycLink; > ``` > [tab] Modo incrustado (iframe) > > Inserta la URL de `kycLink` en un `