Onboarding KYC Asaas
Como o cadastro da sua organização é feito no Asaas, nosso parceiro de pagamento. KYC aprovado é pré-requisito pra receber repasse.
Pra receber repasse na KineoPass, sua organização precisa ter conta digital ativa no Asaas (instituição de pagamento regulada pelo Banco Central) com KYC aprovado. No MVP, o cadastro é feito pela equipe Kineo — fluxo self-service de organizador é carry-over.
Quem cria a organização
Em breve Cadastro pelo próprio organizador (via cadastro self-service no site) está no roadmap.
Hoje, o cadastro acontece assim:
Você fala com a Kineo em contato@kineopass.com.br pra abrir sua organização.
Envia documentação inicial (CNPJ ou CPF, responsável legal, dados bancários, endereço).
A Kineo cria a sua organização no painel admin (/admin/organizers/new) com wizard de 6 seções: dados, notificação, endereço, dados Asaas PF/PJ, taxa Kineo, owner.
Ao salvar, a Kineo dispara POST /v3/accounts no Asaas — cria sua subconta sincronamente.
Você recebe um link de acesso ao painel KineoPass + login + senha inicial pra trocar.
A subconta Asaas
Sua subconta no Asaas é separada da conta-mãe da Kineo. O que isso significa:
- Você tem acesso direto ao app/site do Asaas com suas credenciais.
- Pode sacar os repasses pra qualquer conta bancária tradicional via Pix ou TED.
- Tem extrato próprio das transações que vieram da KineoPass.
A KineoPass não tem acesso ao seu saldo após o repasse — uma vez transferido, é sua responsabilidade.
Aprovação do KYC
A criação da subconta é síncrona (acontece imediatamente). Mas o KYC aprovado depende de validação dos documentos:
- Sandbox/desenvolvimento: auto-aprova documentos automaticamente (
onboardingUrl: null). - Produção (ativo desde 2026-05-31): validação real pelo time Asaas, geralmente em 1-3 dias úteis.
Pendência? O sistema mostra onboardingUrl no AsaasStatusCard do seu perfil — clique pra completar o que falta direto no Asaas.
Status na sua conta
Em /profile no painel do organizador, o card AsaasStatusCard mostra:
- Status atual:
pending_creation,pending_approval,approved,failed. - Última atualização.
- Link de onboarding (se houver documento pendente).
Status detalhado em Status do KYC.
E se a criação falha?
Erros mais comuns:
- CNPJ inválido ou inativo.
- Endereço incompleto.
incomeValue(renda/faturamento mensal) fora de range esperado.
Em qualquer falha, organizers.asaas_last_error armazena o motivo retornado pelo Asaas. A Kineo investiga e ajusta — geralmente resolução em 1 dia útil.
Anti-duplicidade. A KineoPass faz tripla verificação pra evitar criar subcontas duplicadas (DB + GET no Asaas + catch de erro de duplicação). Você não tem como cadastrar a mesma organização duas vezes — isso é proposital.