KYB para Clientes Empresariales

KYB (Know Your Business) es un proceso legal de verificación de identidad y cumplimiento requerido antes de que un cliente empresarial pueda enviar o recibir fondos a través de SpherePay. Es obligatorio por regulaciones de anti-lavado de dinero (AML) y requisitos regulatorios, y debe completarse una vez por empresa. KYB incluye no solo verificar la entidad empresarial en sí, sino también verificar a las personas que en última instancia la poseen o controlan.

Información requerida

SpherePay requiere la siguiente información para verificar a un cliente empresarial. Los campos marcados API se envían vía cuerpo de solicitud; los campos marcados Documento se cargan como archivos.

Campo	Origen	Notas
Nombre legal, nombre comercial y descripción de la empresa	API	`businessInformation.legalName`, `tradeName` y `description`
Tipo de entidad y código NAICS de industria	API	`businessInformation.entityType` y `naicsCode`
Sitio web y fecha de incorporación	API	`businessInformation.website` e `incorporatedOn`
Dirección física y de correspondencia	API	Arreglo `addresses` — se requieren los tipos `registered` y `operating`
Número de identificación empresarial	API	`businessInformation.identificationNumber` — los tipos aceptados varían por país
Ingresos anuales estimados y pagos mensuales esperados	API	`businessInformation.estimatedAnnualRevenueInUsd` y `expectedMonthlyPaymentsInUsd`
Propósito de la cuenta y fuente de fondos	API	`businessInformation.accountPurpose` y `primarySourceOfFunds`
Actividades reguladas y detalles de cumplimiento	API	`businessInformation.regulatedActivities` y campos de cumplimiento relacionados
Certificado de incorporación	Documento	`POST /v2/document` con `documentType: "incorporation_certificate"`
Registro de accionistas	Documento	`POST /v2/document` con `documentType: "shareholder_registry"`
Comprobante de domicilio empresarial	Documento	`POST /v2/document` con `documentType: "proof_of_address"`
Nombre, dirección residencial y fecha de nacimiento del UBO	API	Proporcionado en la solicitud de registro del representante empresarial
Número de identificación fiscal del UBO	API	`personalInformation.taxIdentificationNumber` en la solicitud de registro de UBO
Porcentaje de propiedad y rol del UBO	API	`representationDetails.ownershipPercentage` y `roles`
Documento de identidad emitido por el gobierno del UBO	Documento	`POST /v2/document` con `target: "business-representative"`

En ciertas circunstancias SpherePay puede solicitar documentación adicional — por ejemplo, para empresas en industrias reguladas o de alto riesgo, aquellas con estructuras de propiedad complejas, o las que operan en jurisdicciones de mayor riesgo. SpherePay se pondrá en contacto contigo directamente cuando esto aplique.

Resumen del flujo KYB

El flujo a continuación muestra los pasos requeridos para el KYB empresarial. El único paso que difiere entre modelos de incorporación es la aceptación de TOS y MSA.

Sphere-Managed (por defecto)
Platform-Managed (opt-in)

Crear cliente empresarial con businessInformation y addresses completos
Generar enlace TOS/MSA → redirigir al representante empresarial para aceptar
Cargar documentos empresariales (certificado de incorporación, registro de accionistas, comprobante de domicilio)
Registrar cada UBO (individuos con ≥ 25% de propiedad)
Cargar documentos de identidad para cada UBO
Completar verificación de vivacidad facial para cada UBO (SDK de Sumsub, en el flujo)
Consultar GET /v2/customer/{id} hasta que status alcance approved

Crear cliente empresarial con businessInformation y addresses completos
Cargar documentos empresariales
Registrar cada UBO
Cargar documentos de identidad para cada UBO
Cargar documento de informe de vivacidad para cada UBO
Consultar GET /v2/customer/{id} hasta que status alcance approved

Métodos de integración

KYB vía API

Control total sobre cada paso. Usa esto para una UX de incorporación personalizada integrada en tu producto.

KYB vía enlace alojado

Integración más rápida. SpherePay aloja toda la experiencia de verificación.

KYB vía API

Usa esta guía para incorporar a un cliente empresarial paso a paso a través de la API de SpherePay. El ejemplo a continuación usa el modelo Sphere-Managed (por defecto). Antes de comenzar, asegúrate de tener:

Una clave API de SpherePay
Los detalles legales de la empresa (nombre, tipo de entidad, dirección, número de identificación)
Documentos empresariales listos para cargar (certificado de incorporación, registro de accionistas, comprobante de domicilio)
Información de UBO y documentos de identidad para cada individuo calificado

Crear un cliente empresarial

Llama a POST /v2/customer con type: "business". Incluye el objeto businessInformation completo y ambos tipos de dirección en addresses.

{
  "type": "business",
  "email": "contact@acmecorp.example.com",
  "phone": "+14155551234",
  "addresses": [
    {
      "type": "registered",
      "country": "USA",
      "line1": "123 Main Street",
      "line2": "Suite 100",
      "city": "Chicago",
      "state": "IL",
      "postalCode": "60601"
    },
    {
      "type": "operating",
      "country": "USA",
      "line1": "456 Market Street",
      "line2": "Floor 10",
      "city": "Chicago",
      "state": "IL",
      "postalCode": "60602"
    }
  ],
  "businessInformation": {
    "legalName": "Acme Corporation Inc.",
    "tradeName": "Acme Corp",
    "entityType": "corporation",
    "description": "Enterprise software solutions for supply chain management.",
    "naicsCode": "511210",
    "website": "https://acmecorp.example.com",
    "incorporatedOn": "2020-03-15",
    "identificationNumberType": "ein",
    "identificationNumber": "12-3456789",
    "identificationNumberCountry": "USA",
    "estimatedAnnualRevenueInUsd": "1000000_9999999",
    "expectedMonthlyPaymentsInUsd": "50000",
    "accountPurpose": "investment_purposes",
    "primarySourceOfFunds": "sales_of_goods_and_services",
    "primarySourceOfFundsDescription": "Revenue from software licensing and consulting",
    "isDao": false,
    "regulatedActivities": ["none_of_the_above"],
    "participatesInRegulatedFinancialActivity": false,
    "operatesInProhibitedCountries": false
  }
}

Los valores aceptados de businessInformation.identificationNumberType varían por país — por ejemplo, ein para Estados Unidos, uen para Singapur, o crn para el Reino Unido.

Aceptar los Términos de Servicio y el MSA

Genera un enlace TOS y redirige al representante empresarial para aceptar los Términos y Condiciones y el Acuerdo de Servicios Maestro.

POST https://api.spherepay.co/v2/customer/{id}/tos-link

Este paso puede realizarse en paralelo con la carga de documentos empresariales.

Este paso aplica solo al modelo Sphere-Managed. En Platform-Managed, la aceptación de TOS y MSA debe estar integrada en los propios términos de tu plataforma antes de la incorporación.

Cargar documentos empresariales

Carga los documentos empresariales requeridos. Usa target="customer" para todos los documentos de la entidad empresarial.

curl --location 'https://api.spherepay.co/v2/document' \
--header 'Authorization: Bearer <your_api_key>' \
--form 'target="customer"' \
--form 'targetId="customer_2f283221a9d44ada800ac7f11f640402"' \
--form 'documentType="incorporation_certificate"' \
--form 'file=@"/path/to/your/document.pdf"'

Repite para los tipos de documento shareholder_registry y proof_of_address.

Registrar representantes empresariales (UBOs)

Un UBO (Ultimate Beneficial Owner) es cualquier individuo que posea el 25% o más de la empresa. Registra cada individuo calificado vía POST /v2/business-representative. Repite este paso para cada UBO.

{
  "customerId": "customer_2f283221a9d44ada800ac7f11f640402",
  "type": "individual",
  "email": "james.wilson@acmecorp.example.com",
  "phone": "+13125559876",
  "address": {
    "line1": "742 North Wabash Avenue",
    "line2": "Apt 4B",
    "city": "Chicago",
    "state": "IL",
    "postalCode": "60611",
    "country": "USA"
  },
  "personalInformation": {
    "taxIdentificationNumber": "987654321",
    "taxIdentificationNumberType": "ssn",
    "taxIdentificationNumberCountry": "USA"
  },
  "representationDetails": {
    "roles": ["ubo"],
    "ownershipPercentage": "50",
    "isControlPerson": true,
    "isSigner": true,
    "title": "CEO",
    "relationshipEstablishedAt": "2020-03-15"
  }
}

Todos los individuos que cumplan el umbral de propiedad del 25% deben ser registrados y verificados. Si más de un individuo califica, repite este paso para cada uno.

Cargar documentos de identidad del UBO

Carga documentos de identidad para cada UBO. Usa target="business-representative" — estos documentos pertenecen al individuo, no a la entidad empresarial.

curl --location 'https://api.spherepay.co/v2/document' \
--header 'Authorization: Bearer <your_api_key>' \
--form 'target="business-representative"' \
--form 'targetId="associatedPerson_4914a2f6226e42cc8d207ead9573b29f"' \
--form 'documentType="id_card"' \
--form 'side="front"' \
--form 'file=@"/path/to/your/document.jpg"' \
--form 'country="SGP"'

Completar la verificación de vivacidad del UBO

Cada UBO requiere verificación de vivacidad. Verifica el arreglo required del UBO vía GET /v2/business-representative/{id}, luego realiza exactamente una de las siguientes opciones:

liveness_check en required — Genera un enlace de verificación facial para el UBO y redirígelelo para completar una verificación de vivacidad interactiva vía el SDK de Sumsub.
liveness_report_document en required — Carga un documento de informe de vivacidad para el UBO de tu proveedor de verificación de identidad.

Repite para cada UBO registrado.

Consultar resultado de verificación

Una vez que todos los pasos requeridos estén completos tanto para la empresa como para sus UBOs, SpherePay procesa la verificación automáticamente — no se necesita ninguna llamada de envío. Consulta GET /v2/customer/{id} hasta que status alcance approved.

{
  "id": "customer_2f283221a9d44ada800ac7f11f640402",
  "email": "contact@acmecorp.example.com",
  "verificationProfiles": [
    {
      "name": "kyb_profile_a",
      "status": "approved",
      "criteria": {
        "complete": [
          "email_address",
          "phone_number",
          "operating_address",
          "registered_address",
          "legal_name",
          "identification_number",
          "business_representatives",
          "incorporation_cert_document",
          "shareholder_registry_document",
          "proof_of_address_document"
        ],
        "pending": [],
        "required": [],
        "errors": []
      }
    }
  ],
  "type": "business"
}

Cuando required esté vacío y status sea approved, el cliente empresarial está completamente incorporado y listo para transferir.

La revisión KYB generalmente toma 2–7 días hábiles después de que se envíen todos los documentos y datos requeridos.

Qué sigue

Una vez que el perfil de verificación del cliente empresarial sea approved, registra sus métodos de pago e inicia una transferencia.

Cuentas bancarias

Registra una cuenta bancaria para que la empresa pueda enviar o recibir fondos vía riel bancario.

Billeteras

Registra una dirección de billetera cripto para habilitar transferencias on-ramp y off-ramp.

API de Transferencias

Crea y gestiona transferencias una vez que el cliente haya registrado sus métodos de pago.

Perfil de verificación

Entiende los estados de verificación, arreglos de criterios y qué desencadena los cambios de estado.

​Información requerida

​Resumen del flujo KYB

​Métodos de integración

KYB vía API

KYB vía enlace alojado

​KYB vía API

​Qué sigue

Cuentas bancarias

Billeteras

API de Transferencias

Perfil de verificación

Información requerida

Resumen del flujo KYB

Métodos de integración

KYB vía API

Qué sigue