> ## 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.
# Clientes e Onboarding no SpherePay
> Crie e verifique clientes antes de qualquer transferência. Conheça o KYC para pessoas físicas e o KYB para empresas na API do SpherePay.
Antes que um cliente (`customer`) possa enviar ou receber fundos pelo SpherePay, ele deve ser criado e verificado. O SpherePay opera sob regulamentações de prevenção à lavagem de dinheiro (AML) e know-your-customer (KYC), o que significa que todo cliente que inicia ou recebe uma transferência deve ter sua identidade confirmada antes de qualquer movimentação de fundos. Isso se aplica tanto a pessoas físicas quanto a empresas.
## O que é um cliente?
No SpherePay, um **cliente** é uma entidade — seja uma pessoa física ou uma empresa registrada — que sua plataforma cadastra para enviar ou receber fundos. Você cria um registro de cliente via API e depois completa as etapas de verificação obrigatórias antes que esse cliente possa participar de qualquer transferência.
Um cliente cujo perfil de verificação não seja `approved` não pode iniciar ou receber transferências. Complete o onboarding antes de construir qualquer lógica de transferência.
## Tipos de cliente
O SpherePay suporta dois tipos de cliente. Escolha o tipo que corresponde ao seu usuário final.
| | Pessoa Física | Empresa |
| ---------------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| **Processo de verificação** | KYC (Know Your Customer) | KYB (Know Your Business) |
| **Documentos de identidade** | Documento de identidade emitido pelo governo, número de identificação fiscal | Certificado de incorporação, registro de acionistas, documentos de identificação dos UBOs |
| **Verificação de UBO** | Não aplicável | Obrigatória para todos os indivíduos com ≥ 25% de participação |
| **Tempo típico de análise** | 0–2 dias úteis | 2–7 dias úteis |
## Modelos de onboarding
O SpherePay suporta dois modelos de onboarding que determinam como as etapas de conformidade — verificação de identidade, verificações de vivacidade, acordos legais e verificação de contato — são tratadas.
| | Sphere-Managed | Platform-Managed |
| ------------------------------------------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------ |
| **Disponibilidade** | Padrão — disponível para todas as novas integrações | Opt-in — requer aprovação de conformidade do Sphere |
| **Verificação de vivacidade** | Verificação de vivacidade facial no fluxo via Sumsub SDK | Faça upload de um relatório de vivacidade do seu próprio provedor de KYC |
| **[Termos de Serviço](https://spherepay.co/terms)** | Link de TOS hospedado gerado pelo Sphere | Incorporado nos próprios termos da sua plataforma |
| **Verificação de contato (OTP)** | O Sphere gerencia OTP de telefone e e-mail | Tratado pela sua plataforma upstream |
| **[MSA (apenas empresas)](https://spherepay.co/legal/msa/latest)** | Assinatura de MSA no fluxo via link hospedado | Concluído com o Sphere antes do onboarding |
Todas as novas integrações de API usam o Sphere-Managed por padrão. O onboarding Platform-Managed é opt-in e requer qualificação — entre em contato com seu Solutions Engineer dedicado para iniciar o processo de aprovação.
## Métodos de integração
Ambos os tipos de cliente suportam dois métodos de integração. Escolha um e use-o de forma consistente — misturar métodos para o mesmo cliente não é suportado.
| | API | Link Hospedado |
| ----------------------- | --------------------------------------------------------- | ------------------------------------------------------ |
| **Você controla** | Cada etapa de coleta e envio de dados | Apenas o redirecionamento — o SpherePay cuida do resto |
| **Esforço de frontend** | Alto | Mínimo |
| **Melhor para** | UX de onboarding personalizada incorporada no seu produto | Integração mais rápida |
## Após a aprovação
Assim que o status do perfil de verificação de um cliente atingir `approved`, ele poderá:
* Registrar uma conta bancária para enviar ou receber fundos via rail bancário
* Registrar uma carteira cripto para habilitar transferências de on-ramp e off-ramp
* Iniciar uma transferência
Cadastre pessoas físicas por meio de verificação de identidade. Escolha entre integração por API ou link hospedado, com conformidade Sphere-Managed ou Platform-Managed.
Cadastre empresas com documentos da empresa, registro de UBOs e verificação de identidade via API ou link hospedado.
Use o link de onboarding hospedado do SpherePay para verificar clientes sem construir uma UI personalizada.
Entenda o que cada status de verificação significa e o que desencadeia transições entre estados.