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
Número de registro de la empresa	API	`businessInformation.registrationNumber` y `registrationNumberType` — requeridos para empresas EEA+. Distintos del ID fiscal. Consulta Empresas EEA+
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"`

Las empresas EEA+ también deben proporcionar un número de registro de la empresa y completar KYC para directores, firmantes y personas de control, no solo para propietarios con ≥ 25%. Consulta Empresas EEA+.

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 personas asociadas (UBOs con ≥ 25% de propiedad; las empresas EEA+ también requieren directores, personas de control y firmantes)
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.Las empresas EEA+ también deben proporcionar registrationNumber y registrationNumberType. Estos son independientes del número de identificación fiscal. Consulta Empresas EEA+.

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

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.También puedes registrar directores, personas de control y firmantes autorizados. representationDetails.roles acepta ubo y director (hasta dos roles distintos). ownershipPercentage acepta cualquier entero de 0 a 100; si el rol ubo está presente, la propiedad debe seguir siendo ≥ 25.

{
  "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. Las empresas EEA+ tienen requisitos adicionales de personas asociadas — consulta Empresas EEA+.

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.

EEA+ businesses

Sphere exige campos KYB adicionales y requisitos de personas asociadas para empresas constituidas en la región EEA+, en línea con MiCA. Las empresas fuera de EEA+ no se ven afectadas. accountPurpose ya era requerido para todas las empresas — eso no cambia. EEA+ es el EEE más el Reino Unido, Suiza, Andorra y varios territorios de ultramar de la UE (Islas Åland, Guayana Francesa, Guadalupe, Martinica, Mayotte, Reunión, San Martín). El alcance se determina por el país de la dirección registrada de la empresa (country en la dirección con type: "registered"). Los representantes empresariales heredan el alcance EEA+ de la empresa matriz. Consulta Región EEA+ para la definición completa.

Número de registro

Las empresas EEA+ deben proporcionar ambos campos bajo businessInformation en POST /v2/customer:

Campo	Estado	Requerido
`registrationNumber`	Existente	Requerido para empresas EEA+ antes de la verificación
`registrationNumberType`	Nuevo	Requerido siempre que se proporcione `registrationNumber`, y requerido para empresas EEA+ antes de la verificación

El número de registro se almacena y verifica por separado del ID fiscal (identificationNumber). No envíes un número de IVA o fiscal como número de registro. registrationNumberType se valida según el país de la dirección registrada. Ejemplos:

País	Valores aceptados de `registrationNumberType`
Austria	`fn`
Bélgica	`bce`, `kbo`
Dinamarca	`cvr`
Francia	`siren`, `siret`
Alemania	`crn`
Irlanda	`cro`
Italia	`cf`
Países Bajos	`kvk`
Noruega	`org`, `orgnr`
Suecia	`org`, `orgnr`
Polonia	`krs`
Portugal	`nipc`
España	`cif`
Reino Unido	`crn`
Países sin conjunto de tipos definido	`other`

Comportamiento de validación:

Una empresa EEA+ sin registrationNumber o registrationNumberType no puede enviarse a verificación. El envío devuelve 422.
Un registrationNumberType que no es válido para el país de la dirección registrada devuelve 422 con los tipos permitidos.
Las empresas fuera de EEA+ pueden seguir proporcionando registrationNumber sin un tipo. Ese comportamiento no cambia.

El elemento pendiente aparece como el código de requisito registration_number en kyb_profile_a (solo EEA+). Sphere excluye este código para empresas fuera de EEA+. Puedes completar empresas EEA+ existentes con PATCH /v2/customer/{id}. La validación se ejecuta sobre el estado combinado del cliente.

Representantes empresariales

Las empresas EEA+ tienen un alcance de personas asociadas más amplio que las empresas fuera de EEA+. Rol de director. representationDetails.roles acepta director junto con ubo, con hasta dos roles distintos. Porcentaje de propiedad. ownershipPercentage acepta cualquier entero de 0 a 100 (el mínimo anterior era 25). Si el rol ubo está presente, la propiedad debe seguir siendo ≥ 25. Un representante sin el rol ubo — por ejemplo, solo director — puede tener 0–24. Llama a POST /v2/business-representative con los nuevos valores de rol:

{
  "representationDetails": {
    "roles": ["ubo", "director"],
    "ownershipPercentage": "40",
    "isControlPerson": true,
    "isSigner": true,
    "title": "Managing Director"
  }
}

El ejemplo destaca los nuevos valores de rol y propiedad. Incluye los demás campos del representante requeridos en la creación (customerId, type, email, phone, address y personalInformation) como de costumbre. País de nacimiento y nacionalidad. Para empresas EEA+, cada representante debe proporcionar countryOfBirth y nationality bajo personalInformation. Hasta que se proporcionen, aparecen como country_of_birth y nationality en el perfil ubo_kyc_profile_a del representante. Sphere excluye estos códigos para representantes de empresas fuera de EEA+. Puedes completar representantes existentes con PATCH /v2/business-representative/{id}. La validación se ejecuta sobre el estado combinado del representante.

Códigos de requisito a nivel de empresa

Estos códigos aparecen en el perfil kyb_profile_a del cliente empresarial solo para empresas EEA+. Sphere los excluye para empresas fuera de EEA+.

Código	Significado
`registration_number`	Proporciona `businessInformation.registrationNumber` y `registrationNumberType`
`eea_control_person_present`	Al menos un representante con `isControlPerson: true`
`eea_ap_kyc_scope`	Al menos un director registrado, y cada director, firmante, persona de control y propietario ≥ 25% completa la verificación de identidad completa

Para empresas fuera de EEA+, el alcance de KYC de personas asociadas no cambia: solo propietarios con ≥ 25%.

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.

Incorporación

Transferencias

Automatización

Webhooks

Datos de referencia

Operacional

KYB para Clientes Empresariales

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

EEA+ businesses

Número de registro

Representantes empresariales

Códigos de requisito a nivel de empresa

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

KYB vía enlace alojado

​KYB vía API

​EEA+ businesses

​Número de registro

​Representantes empresariales

​Códigos de requisito a nivel de empresa

​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

EEA+ businesses

Número de registro

Representantes empresariales

Códigos de requisito a nivel de empresa

Qué sigue