> ## 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 Empresariais > Cadastre clientes empresariais com verificação KYB. Envie documentos, registre UBOs e conclua a verificação via API ou link hospedado. KYB (Know Your Business) é um processo legal de verificação de identidade e conformidade obrigatório antes que um cliente empresarial possa enviar ou receber fundos pelo SpherePay. É exigido pelas regulamentações de prevenção à lavagem de dinheiro (AML) e requisitos regulatórios, e deve ser concluído uma vez por empresa. O KYB inclui não apenas a verificação da própria entidade empresarial, mas também a verificação dos indivíduos que, em última instância, a possuem ou controlam. ## Informações obrigatórias O SpherePay requer as seguintes informações para verificar um cliente empresarial. Os campos marcados como **API** são enviados via corpo da requisição; os campos marcados como **Documento** são enviados como arquivos. | Campo | Origem | Observações | | ------------------------------------------------------ | --------- | ---------------------------------------------------------------------------------- | | Nome legal, nome fantasia e descrição da empresa | API | `businessInformation.legalName`, `tradeName` e `description` | | Tipo de entidade e código NAICS | API | `businessInformation.entityType` e `naicsCode` | | Site e data de constituição | API | `businessInformation.website` e `incorporatedOn` | | Endereço físico e postal | API | Array `addresses` — tipos `registered` e `operating` são obrigatórios | | Número de identificação da empresa | API | `businessInformation.identificationNumber` — tipos aceitos variam por país | | Receita anual estimada e pagamentos mensais esperados | API | `businessInformation.estimatedAnnualRevenueInUsd` e `expectedMonthlyPaymentsInUsd` | | Propósito da conta e origem dos fundos | API | `businessInformation.accountPurpose` e `primarySourceOfFunds` | | Atividades reguladas e detalhes de conformidade | API | `businessInformation.regulatedActivities` e campos de conformidade relacionados | | Certificado de constituição | Documento | `POST /v2/document` com `documentType: "incorporation_certificate"` | | Registro de acionistas | Documento | `POST /v2/document` com `documentType: "shareholder_registry"` | | Comprovante de endereço comercial | Documento | `POST /v2/document` com `documentType: "proof_of_address"` | | Nome, endereço residencial e data de nascimento do UBO | API | Fornecido na requisição de registro do representante empresarial | | Número de identificação fiscal do UBO | API | `personalInformation.taxIdentificationNumber` na requisição de registro do UBO | | Percentual de participação e função do UBO | API | `representationDetails.ownershipPercentage` e `roles` | | Documento de identidade emitido pelo governo do UBO | Documento | `POST /v2/document` com `target: "business-representative"` | Em determinadas circunstâncias, o SpherePay pode solicitar documentação adicional — por exemplo, para empresas em setores regulados ou de alto risco, com estruturas societárias complexas ou que operam em jurisdições de maior risco. O SpherePay entrará em contato diretamente quando isso se aplicar. ## Visão geral do fluxo de KYB O fluxo abaixo mostra as etapas obrigatórias para o KYB empresarial. A única etapa que difere entre os modelos de onboarding é a aceitação do TOS e do MSA. 1. Criar cliente empresarial com `businessInformation` e `addresses` completos 2. Gerar link de TOS/MSA → redirecionar o representante empresarial para aceitar 3. Fazer upload de documentos da empresa (certificado de constituição, registro de acionistas, comprovante de endereço) 4. Registrar cada UBO (indivíduos com ≥ 25% de participação) 5. Fazer upload de documentos de identidade para cada UBO 6. Completar a verificação de vivacidade facial para cada UBO (Sumsub SDK, no fluxo) 7. Consultar `GET /v2/customer/{id}` até o `status` atingir `approved` 1. Criar cliente empresarial com `businessInformation` e `addresses` completos 2. Fazer upload de documentos da empresa 3. Registrar cada UBO 4. Fazer upload de documentos de identidade para cada UBO 5. Fazer upload do documento de relatório de vivacidade para cada UBO 6. Consultar `GET /v2/customer/{id}` até o `status` atingir `approved` ## Métodos de integração Controle total sobre cada etapa. Use para uma UX de onboarding personalizada incorporada no seu produto. Integração mais rápida. O SpherePay hospeda toda a experiência de verificação. *** ## KYB via API Use este guia para cadastrar um cliente empresarial passo a passo via API do SpherePay. O exemplo abaixo usa o modelo Sphere-Managed (padrão). **Antes de começar**, certifique-se de ter: * Uma chave de API do SpherePay * Os detalhes legais da empresa (nome, tipo de entidade, endereço, número de identificação) * Documentos da empresa prontos para upload (certificado de constituição, registro de acionistas, comprovante de endereço) * Informações dos UBOs e documentos de identidade para cada indivíduo qualificado Chame `POST /v2/customer` com `type: "business"`. Inclua o objeto `businessInformation` completo e ambos os tipos de endereço em `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 } } ``` Os valores aceitos para `businessInformation.identificationNumberType` variam por país — por exemplo, `ein` para os Estados Unidos, `uen` para Singapura ou `crn` para o Reino Unido. Gere um link de TOS e redirecione o representante empresarial para aceitar os Termos e Condições e o Contrato de Prestação de Serviços (MSA). ```bash theme={"dark"} POST https://api.spherepay.co/v2/customer/{id}/tos-link ``` Esta etapa pode ser feita em paralelo com o upload de documentos da empresa. Esta etapa se aplica apenas ao modelo Sphere-Managed. No Platform-Managed, a aceitação do TOS e do MSA deve ser incorporada nos próprios termos da sua plataforma antes do onboarding. Faça upload dos documentos empresariais obrigatórios. Use `target="customer"` para todos os documentos da entidade 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"' ``` Repita para os tipos de documento `shareholder_registry` e `proof_of_address`. Um **UBO (Ultimate Beneficial Owner)** é qualquer indivíduo que possua **25% ou mais** da empresa. Registre cada indivíduo qualificado via `POST /v2/business-representative`. Repita esta etapa 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 os indivíduos que atingirem o limite de 25% de participação devem ser registrados e verificados. Se mais de um indivíduo se qualificar, repita esta etapa para cada um. Faça upload dos documentos de identidade para cada UBO. Use `target="business-representative"` — esses documentos pertencem ao indivíduo, não à entidade 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 requer verificação de vivacidade. Verifique o array `required` do UBO via `GET /v2/business-representative/{id}`, depois realize **exatamente uma** das opções a seguir: * **`liveness_check` em required** — Gere um link de verificação facial para o UBO e redirecione-o para completar uma verificação de vivacidade interativa via Sumsub SDK. * **`liveness_report_document` em required** — Faça upload de um documento de relatório de vivacidade para o UBO do seu provedor de verificação de identidade. Repita para cada UBO registrado. Assim que todas as etapas obrigatórias estiverem concluídas para a empresa e seus UBOs, o SpherePay processa a verificação automaticamente — nenhuma chamada de submit é necessária. Consulte `GET /v2/customer/{id}` até o `status` atingir `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" } ``` Quando `required` estiver vazio e `status` for `approved`, o cliente empresarial está totalmente cadastrado e pronto para transferir. A análise do KYB normalmente leva de 2 a 7 dias úteis após todos os documentos e dados obrigatórios serem enviados. *** ## Próximos passos Assim que o perfil de verificação do cliente empresarial estiver `approved`, registre seus métodos de pagamento e inicie uma transferência. Registre uma conta bancária para que a empresa possa enviar ou receber fundos via rail bancário. Registre um endereço de carteira cripto para habilitar transferências de on-ramp e off-ramp. Crie e gerencie transferências assim que o cliente tiver registrado seus métodos de pagamento. Entenda os status de verificação, arrays de critérios e o que desencadeia mudanças de estado.