Incorporación de vendedores de marketplace con KYB (ES-1)

Los marketplaces prosperan o fracasan por la calidad de su oferta. Incorporar vendedores rápidamente es lo que hace crecer el catálogo, pero incorporar a los vendedores equivocados es lo que hace que una plataforma sea multada, defraudada o excluida por su socio de pago. Los vendedores comerciales aumentan aún más los riesgos: un vendedor que es una empresa registrada significa que no solo está verificando a una persona, sino que está verificando una entidad, identificando a sus propietarios, examinándola para detectar sanciones y revisando sus documentos antes de que el dinero comience a fluir. Hecho a mano, eso son días de trabajo por vendedor. Hecho solo como una búsqueda en el registro, es una brecha de cumplimiento esperando ser explotada.

La API de Verificación Comercial de Didit convierte la incorporación de vendedores de marketplace en una única sesión KYB. Verifique la empresa, identifique y realice KYC a cada propietario, examine la entidad y revise los documentos, todo en la API unificada /v3/, por $2.00 por empresa. Esta guía explica cómo incorporar vendedores comerciales correctamente sin ralentizar el proceso.

Puntos clave

• Una sesión por vendedor. Una única sesión KYB cubre el registro, la identificación de UBO, el KYC del propietario, el AML de la entidad y la verificación de documentos.
• $2.00 por empresa. La verificación completa tiene un precio fijo por entidad de vendedor, sin mínimos; el costo escala con el volumen de vendedores.
• KYC a cada propietario. KYB de ciclo cerrado genera una sesión KYC vinculada para cada UBO, por lo que verifica a los humanos detrás del vendedor antes de los pagos, una característica única de Didit.
• Detecte las entidades fraudulentas. El AML a nivel de entidad ($0.20) marca una empresa vendedora sancionada o con informes adversos, incluso cuando sus directivos parecen limpios.
• Verifique los documentos, no solo los almacene. Los documentos KYB ($0.20 cada uno) se leen con OCR y se verifican contra manipulaciones.
• Diseñado para escalar. Los estados por característica le permiten redirigir reenvíos y revisiones sin fallar toda la incorporación; los webhooks mantienen sus registros de vendedores sincronizados.

Qué hace KYB para vendedores

Para un marketplace, un vendedor comercial es una entidad a la que está a punto de pagar. KYB responde a las preguntas que protegen esos pagos: ¿Es esta una empresa real y en buen estado? ¿Quién la posee en última instancia? ¿La entidad o algún propietario está en una lista de sanciones? ¿Sus documentos son auténticos? El modelo de sesión de Didit responde a las cuatro en un solo lugar a través de cuatro características: kyb_registry, kyb_key_people, kyb_company_aml y kyb_documents, y, con el KYC vinculado activado, también verifica las identidades reales de los propietarios.

El resultado es un vendedor en el que puede confiar lo suficiente como para pagar: una empresa verificada, un esquema de propiedad resuelto, entidad y propietarios examinados, y documentos verificados contra manipulaciones, todo producido a partir de una sesión en lugar de cinco herramientas.

Por qué es importante

Los marketplaces que manejan pagos son tratados cada vez más como flujos de dinero regulados. Los socios de pago y los adquirentes exigen la debida diligencia del vendedor; los regímenes AML requieren la identificación y verificación de los beneficiarios finales de las contrapartes comerciales; y la realidad del fraude es que los malos vendedores se esconden detrás de entidades fantasma precisamente porque la incorporación rara vez va más allá del registro. Una plataforma que paga a una entidad vendedora no verificada, sancionada o ficticia asume la pérdida y la exposición regulatoria.

La tensión es la velocidad. Los vendedores abandonan la incorporación que lleva demasiado tiempo, por lo que la verificación debe ser exhaustiva y rápida. La forma de obtener ambas es ejecutar cada verificación en una sola sesión con un enrutamiento preciso por característica: recopilar lo necesario, verificarlo automáticamente y solo involucrar a un humano donde aparezca una señal de riesgo real.

Detalles técnicos

La incorporación del vendedor comienza con una sesión KYB en la API unificada /v3/, vinculada a su registro interno de vendedor a través de vendor_data.

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your_kyb_workflow_id",
    "vendor_data": "seller_44120",
    "callback": "https://yourmarketplace.com/sellers/kyb/callback"
  }'

El resultado de la sesión le brinda todo lo necesario para decidir sobre un pago, incluido el KYC vinculado de los propietarios:

{
  "session_id": "kyb_91ab30c4",
  "status": "APPROVED",
  "vendor_data": "seller_44120",
  "kyb_registry": { "status": "APPROVED", "company_status": "ACTIVE" },
  "kyb_company_aml": { "status": "APPROVED" },
  "kyb_documents": { "status": "APPROVED" },
  "kyb_key_people": {
    "status": "APPROVED",
    "ubos": [
      { "name": "Ana Ferreira", "ownership_percentage": 70.0,
        "linked_kyc": { "session_id": "kyc_aa10", "status": "APPROVED" } },
      { "name": "Bruno Costa", "ownership_percentage": 30.0,
        "linked_kyc": { "session_id": "kyc_aa11", "status": "APPROVED" } }
    ]
  }
}

Estados de la sesión. NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED, EXPIRED.

Webhooks. Suscríbase a status.updated y data.updated (session_kind: business) para la verificación del vendedor, y a los webhooks de sesión estándar para el KYC vinculado de cada propietario. Use business.status.updated para rastrear el estado de la entidad vendedora después de la incorporación.

Precio. $2.00 por empresa. Desglosado: AML de empresa $0.20, documentos KYB $0.20 cada uno, Personas clave gratis, KYC de propietario vinculado a tarifas estándar de Verificación de Usuario.

Flujo de incorporación para un marketplace

1. El vendedor inicia la incorporación. Usted crea una sesión KYB asociada a su ID de vendedor.
2. La empresa es verificada. El registro confirma que la entidad es real y ACTIVE; los documentos se recopilan, se leen con OCR y se verifican contra manipulaciones.
3. Los propietarios son identificados y verificados. Personas Clave resuelve los UBOs, y una sesión KYC vinculada verifica a cada uno, cerrando el vínculo entre la entidad y los humanos.
4. Todos son examinados. El AML de la entidad examina a la empresa; el AML en el KYC de cada propietario examina a las personas.
5. Usted decide sobre los pagos. Una sesión APPROVED con propietarios verificados y un examen limpio autoriza al vendedor para los pagos; una característica IN_REVIEW o RESUB_REQUESTED se dirige precisamente a lo que necesita atención.

Después de la incorporación, el vendedor se convierte en una entidad gestionada que puede mantener ACTIVE, FLAGGED o BLOCKED a través de la API de negocios a medida que cambia su estado.

Casos de uso

• Los marketplaces de productos que incorporan vendedores verifican la entidad comercial y sus propietarios antes de habilitar la liquidación.
• Los marketplaces de servicios y trabajos temporales con proveedores comerciales ejecutan KYB en proveedores incorporados para satisfacer la debida diligencia del socio de pago.
• Las plataformas de creadores y comercio que pagan a cuentas comerciales confirman que la entidad y sus beneficiarios finales son reales y han sido examinados.
• Los marketplaces B2B y mayoristas verifican las empresas contrapartes y sus propietarios antes de extender términos comerciales o pagos.

Cómo integrar con Didit

1. Construya el flujo de trabajo. En la Consola de Negocios, cree un flujo de trabajo KYB con registro, AML de empresa, documentos y personas clave habilitados, además de KYC vinculado para UBOs.
2. Cree la sesión. POST /v3/session/ con su workflow_id de KYB y una referencia vendor_data que coincida con su ID de vendedor.
3. Maneje los webhooks. Escuche los webhooks status.updated / data.updated (session_kind: business) del vendedor y los webhooks KYC vinculados de cada propietario; condicione los pagos al resultado combinado.
4. Gestione el vendedor. Use GET /v3/businesses/{vendor_data}/ y PATCH .../update-status/ para mantener al vendedor ACTIVE, FLAGGED o BLOCKED a medida que cambia su estado.

Debido a que todo está en la API unificada /v3/, verificar la empresa vendedora, realizar KYC a sus propietarios y monitorearla después son un flujo continuo: una plataforma de identidad y fraude, de principio a fin.

Preguntas frecuentes

¿Cuánto cuesta incorporar un vendedor comercial?

$2.00 por empresa para la verificación KYB completa. Las sesiones KYC de propietario se facturan a tarifas estándar de Verificación de Usuario; el AML de empresa y los documentos KYB cuestan $0.20 cada uno si los compra por separado.

¿Tengo que verificar a los propietarios del vendedor, o solo a la empresa?

Puede hacer ambas cosas en un solo flujo. KYB de ciclo cerrado identifica a los UBOs y genera una sesión KYC vinculada para cada uno, por lo que verifica a los humanos detrás del vendedor antes de pagar.

¿Detectará una empresa vendedora sancionada?

Sí. El AML a nivel de entidad (kyb_company_aml) examina a la propia empresa, detectando una firma designada incluso cuando sus directivos parecen limpios.

¿La incorporación es lenta si hace todo esto?

No. Cada verificación se ejecuta en una sola sesión, y los estados por característica le permiten redirigir un único reenvío o revisión sin fallar toda la incorporación, de forma exhaustiva y rápida.

¿Cómo mantengo actualizado el estado de un vendedor después de la incorporación?

El vendedor se convierte en una entidad gestionada que puede establecer como ACTIVE, FLAGGED o BLOCKED a través de la API de gestión de negocios, con webhooks business.status.updated en cada cambio.

¿Listo para empezar?

Lea la descripción general de Verificación de Negocios en la documentación, vea cómo encaja con el resto de la plataforma en la página del producto Verificación de Negocios, y consulte los precios transparentes por llamada en la página de precios. Cuando esté listo, comience gratis: 500 verificaciones KYC gratuitas cada mes y verificación de negocios por $2.00 por empresa.