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
Número de registro da empresa	API	`businessInformation.registrationNumber` e `registrationNumberType` — obrigatórios para empresas EEA+. Distintos do ID fiscal. Consulte Empresas EEA+
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"`

Empresas EEA+ também devem fornecer um número de registro da empresa e concluir o KYC para diretores, signatários e pessoas de controle, não apenas para sócios com ≥ 25%. Consulte Empresas EEA+.

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 pessoas associadas (UBOs com ≥ 25% de participação; empresas EEA+ também exigem diretores, pessoas de controle e signatários)
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.Empresas EEA+ também devem fornecer registrationNumber e registrationNumberType. Eles são independentes do número de identificação fiscal. Consulte Empresas EEA+.

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

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.Você também pode registrar diretores, pessoas de controle e signatários autorizados. representationDetails.roles aceita ubo e director (até dois papéis distintos). ownershipPercentage aceita qualquer inteiro de 0 a 100; se o papel ubo estiver presente, a participação ainda deve ser ≥ 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 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. Empresas EEA+ têm requisitos adicionais de pessoas associadas — consulte Empresas EEA+.

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.

EEA+ businesses

O Sphere exige campos de KYB adicionais e requisitos de pessoas associadas para empresas constituídas na região EEA+, em linha com o MiCA. Empresas fora da EEA+ não são afetadas. accountPurpose já era obrigatório para todas as empresas — isso não muda. EEA+ é o EEE mais o Reino Unido, a Suíça, Andorra e vários territórios ultramarinos da UE (Ilhas Åland, Guiana Francesa, Guadalupe, Martinica, Mayotte, Reunião, São Martinho). O escopo é determinado pelo país do endereço registrado da empresa (country no endereço com type: "registered"). Os representantes empresariais herdam o escopo EEA+ da empresa-mãe. Consulte Região EEA+ para a definição completa.

Número de registro

Empresas EEA+ devem fornecer os dois campos abaixo em businessInformation em POST /v2/customer:

Campo	Status	Obrigatório
`registrationNumber`	Existente	Obrigatório para empresas EEA+ antes da verificação
`registrationNumberType`	Novo	Obrigatório sempre que `registrationNumber` for fornecido, e obrigatório para empresas EEA+ antes da verificação

O número de registro é armazenado e verificado separadamente do ID fiscal (identificationNumber). Não envie um número de IVA ou fiscal como número de registro. registrationNumberType é validado de acordo com o país do endereço registrado. Exemplos:

País	Valores aceitos de `registrationNumberType`
Áustria	`fn`
Bélgica	`bce`, `kbo`
Dinamarca	`cvr`
França	`siren`, `siret`
Alemanha	`crn`
Irlanda	`cro`
Itália	`cf`
Países Baixos	`kvk`
Noruega	`org`, `orgnr`
Suécia	`org`, `orgnr`
Polônia	`krs`
Portugal	`nipc`
Espanha	`cif`
Reino Unido	`crn`
Países sem conjunto de tipos definido	`other`

Comportamento de validação:

Uma empresa EEA+ sem registrationNumber ou registrationNumberType não pode ser enviada para verificação. O envio retorna 422.
Um registrationNumberType que não é válido para o país do endereço registrado retorna 422 listando os tipos permitidos.
Empresas fora da EEA+ podem continuar fornecendo registrationNumber sem um tipo. Esse comportamento não muda.

O item pendente aparece como o código de requisito registration_number em kyb_profile_a (somente EEA+). O Sphere exclui esse código para empresas fora da EEA+. Você pode preencher empresas EEA+ existentes com PATCH /v2/customer/{id}. A validação é executada no estado mesclado do cliente.

Representantes empresariais

Empresas EEA+ têm um escopo de pessoas associadas mais amplo do que empresas fora da EEA+. Papel de diretor. representationDetails.roles aceita director junto com ubo, com até dois papéis distintos. Percentual de participação. ownershipPercentage aceita qualquer inteiro de 0 a 100 (o mínimo anterior era 25). Se o papel ubo estiver presente, a participação ainda deve ser ≥ 25. Um representante sem o papel ubo — por exemplo, apenas diretor — pode ter 0–24. Chame POST /v2/business-representative com os novos valores de papel:

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

O exemplo destaca os novos valores de papel e participação. Inclua os demais campos do representante obrigatórios na criação (customerId, type, email, phone, address e personalInformation) como de costume. País de nascimento e nacionalidade. Para empresas EEA+, cada representante deve fornecer countryOfBirth e nationality em personalInformation. Até que sejam fornecidos, eles aparecem como country_of_birth e nationality no perfil ubo_kyc_profile_a do representante. O Sphere exclui esses códigos para representantes de empresas fora da EEA+. Você pode preencher representantes existentes com PATCH /v2/business-representative/{id}. A validação é executada no estado mesclado do representante.

Códigos de requisito no nível da empresa

Esses códigos aparecem no perfil kyb_profile_a do cliente empresarial somente para empresas EEA+. O Sphere os exclui para empresas fora da EEA+.

Código	Significado
`registration_number`	Forneça `businessInformation.registrationNumber` e `registrationNumberType`
`eea_control_person_present`	Pelo menos um representante com `isControlPerson: true`
`eea_ap_kyc_scope`	Pelo menos um diretor cadastrado, e cada diretor, signatário, pessoa de controle e sócio ≥ 25% conclui a verificação de identidade completa

Para empresas fora da EEA+, o escopo de KYC de pessoas associadas não muda: apenas sócios com ≥ 25%.

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.

Onboarding

Transferências

Automação

Webhooks

Dados de referência

Operacional

KYB para Clientes Empresariais

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

EEA+ businesses

Número de registro

Representantes empresariais

Códigos de requisito no nível da empresa

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

KYB via link hospedado

​KYB via API

​EEA+ businesses

​Número de registro

​Representantes empresariais

​Códigos de requisito no nível da empresa

​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

EEA+ businesses

Número de registro

Representantes empresariais

Códigos de requisito no nível da empresa

Próximos passos