KYB para Clientes Empresariais

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.

Sphere-Managed (padrão)
Platform-Managed (opt-in)

Criar cliente empresarial com businessInformation e addresses completos
Gerar link de TOS/MSA → redirecionar o representante empresarial para aceitar
Fazer upload de documentos da empresa (certificado de constituição, registro de acionistas, comprovante de endereço)
Registrar cada UBO (indivíduos com ≥ 25% de participação)
Fazer upload de documentos de identidade para cada UBO
Completar a verificação de vivacidade facial para cada UBO (Sumsub SDK, no fluxo)
Consultar GET /v2/customer/{id} até o status atingir approved

Criar cliente empresarial com businessInformation e addresses completos
Fazer upload de documentos da empresa
Registrar cada UBO
Fazer upload de documentos de identidade para cada UBO
Fazer upload do documento de relatório de vivacidade para cada UBO
Consultar GET /v2/customer/{id} até o status atingir approved

Métodos de integração

KYB via API

Controle total sobre cada etapa. Use para uma UX de onboarding personalizada incorporada no seu produto.

KYB via link hospedado

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

Criar um cliente empresarial

Chame POST /v2/customer com type: "business". Inclua o objeto businessInformation completo e ambos os tipos de endereço em 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
  }
}

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.

Aceitar os Termos de Serviço e o MSA

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).

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.

Fazer upload de documentos da empresa

Faça upload dos documentos empresariais obrigatórios. Use target="customer" para todos os documentos da entidade 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"'

Repita para os tipos de documento shareholder_registry e proof_of_address.

Registrar representantes empresariais (UBOs)

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.

{
  "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.

Fazer upload de documentos de identidade dos UBOs

Faça upload dos documentos de identidade para cada UBO. Use target="business-representative" — esses documentos pertencem ao indivíduo, não à entidade 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 a verificação de vivacidade dos UBOs

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.

Consultar o resultado da verificação

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.

{
  "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.

Contas bancárias

Registre uma conta bancária para que a empresa possa enviar ou receber fundos via rail bancário.

Carteiras

Registre um endereço de carteira cripto para habilitar transferências de on-ramp e off-ramp.

API de Transferências

Crie e gerencie transferências assim que o cliente tiver registrado seus métodos de pagamento.

Perfil de verificação

Entenda os status de verificação, arrays de critérios e o que desencadeia mudanças de estado.

​Informações obrigatórias

​Visão geral do fluxo de KYB

​Métodos de integração

KYB via API

KYB via link hospedado

​KYB via API

​Próximos passos

Contas bancárias

Carteiras

API de Transferências

Perfil de verificação

Informações obrigatórias

Visão geral do fluxo de KYB

Métodos de integração

KYB via API

Próximos passos