> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt
> Use this file to discover all available pages before exploring further.
# KYB para Clientes Empresariales
> Incorpora clientes empresariales con verificación KYB. Envía documentos, registra UBOs y completa la verificación vía API o enlace alojado.
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.
1. Crear cliente empresarial con `businessInformation` y `addresses` completos
2. Generar enlace TOS/MSA → redirigir al representante empresarial para aceptar
3. Cargar documentos empresariales (certificado de incorporación, registro de accionistas, comprobante de domicilio)
4. Registrar cada UBO (individuos con ≥ 25% de propiedad)
5. Cargar documentos de identidad para cada UBO
6. Completar verificación de vivacidad facial para cada UBO (SDK de Sumsub, en el flujo)
7. Consultar `GET /v2/customer/{id}` hasta que `status` alcance `approved`
1. Crear cliente empresarial con `businessInformation` y `addresses` completos
2. Cargar documentos empresariales
3. Registrar cada UBO
4. Cargar documentos de identidad para cada UBO
5. Cargar documento de informe de vivacidad para cada UBO
6. Consultar `GET /v2/customer/{id}` hasta que `status` alcance `approved`
## Métodos de integración
Control total sobre cada paso. Usa esto para una UX de incorporación personalizada integrada en tu producto.
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
Llama a `POST /v2/customer` con `type: "business"`. Incluye el objeto `businessInformation` completo y ambos tipos de dirección en `addresses`.
```json theme={"dark"}
{
"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.
Genera un enlace TOS y redirige al representante empresarial para aceptar los Términos y Condiciones y el Acuerdo de Servicios Maestro.
```bash theme={"dark"}
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.
Carga los documentos empresariales requeridos. Usa `target="customer"` para todos los documentos de la entidad empresarial.
```bash theme={"dark"}
curl --location 'https://api.spherepay.co/v2/document' \
--header 'Authorization: Bearer ' \
--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`.
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.
```json theme={"dark"}
{
"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.
Carga documentos de identidad para cada UBO. Usa `target="business-representative"` — estos documentos pertenecen al individuo, no a la entidad empresarial.
```bash theme={"dark"}
curl --location 'https://api.spherepay.co/v2/document' \
--header 'Authorization: Bearer ' \
--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"'
```
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.
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`.
```json theme={"dark"}
{
"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.
Registra una cuenta bancaria para que la empresa pueda enviar o recibir fondos vía riel bancario.
Registra una dirección de billetera cripto para habilitar transferencias on-ramp y off-ramp.
Crea y gestiona transferencias una vez que el cliente haya registrado sus métodos de pago.
Entiende los estados de verificación, arreglos de criterios y qué desencadena los cambios de estado.