Status do KYC e ativação de repasse
Os 4 estados possíveis do KYC, o que cada um significa, e quando o repasse fica ativo.
O status do KYC fica visível em /profile no card AsaasStatusCard. Veja o que cada estado significa e o que destrava em cada um.
Os 4 estados possíveis
Status (organizers.asaas_status) | O que significa | Repasse libera? |
|---|---|---|
pending_creation | Subconta sendo criada no Asaas. Estado transitório (segundos a 1 minuto) | ❌ Não |
pending_approval | Subconta criada, documentos em análise pelo Asaas | ❌ Não |
approved | KYC aprovado, documentos validados | ✅ Sim |
failed | Erro na criação ou rejeição dos documentos | ❌ Não |
pending_creation (transitório)
Estado curto. Sua organização foi cadastrada, mas o request POST /v3/accounts ainda está executando no Asaas.
Resolução: aguardar. Normalmente menos de 1 minuto.
Se ficar mais que 5 minutos nesse estado, é provavel falha técnica — Kineo monitora e re-tenta automaticamente. Em caso extremo, abra chamado.
pending_approval (aguardando documentos)
Subconta foi criada com sucesso. O Asaas está validando os documentos enviados (ou esperando você enviar os pendentes).
Você vê o onboardingUrl no AsaasStatusCard — clique pra completar o que falta:
- Documento com foto do responsável.
- Selfie segurando o documento.
- Comprovante de residência/endereço.
- Documentos da PJ (se for o caso).
O Asaas valida em 1-3 dias úteis após você enviar tudo. Você recebe notificação por e-mail quando muda pra approved ou se rejeitam algum doc.
approved (tudo certo)
KYC validado. Sua subconta está ativa.
- Repasse libera automaticamente após
event.date + 7 dias úteis(cron de0 6 * * *UTC). organizers.asaas_approved_atregistra a data da aprovação.- Webhook
ACCOUNT_STATUS_GENERAL_APPROVAL_APPROVEDfoi processado pela KineoPass.
Cadastre a conta bancária no Asaas (se ainda não fez) pra os repasses caírem onde você quer.
failed (erro)
Algo deu errado. organizers.asaas_last_error armazena o motivo:
| Erro típico | Causa | Solução |
|---|---|---|
email_already_exists | E-mail sintético duplicado (raríssimo, anti-duplicidade) | Kineo resolve automaticamente |
cnpj_invalid | CNPJ não existe na receita | Confirmar CNPJ e re-cadastrar |
incomeValue_out_of_range | Renda/faturamento fora do range esperado | Ajustar valor declarado |
address_incomplete | Endereço sem CEP ou bairro | Completar dados |
document_rejected | Documento enviado não foi aceito (foto borrada, dado divergente) | Reenviar documento corrigido |
A Kineo monitora failed e age automaticamente em casos óbvios. Em casos específicos, abrirá chamado pra alinhar.
Webhook por subconta
A KineoPass escuta os webhooks do Asaas pra cada subconta:
ACCOUNT_STATUS_GENERAL_APPROVAL_APPROVED→ muda status praapproved.ACCOUNT_STATUS_GENERAL_APPROVAL_REJECTED→ muda status prafailed.DOCUMENT_REJECTED→ mantémpending_approvalmas atualizaonboardingUrl.
E enquanto KYC não aprova?
Você pode:
- Criar eventos (não-publicados ou publicados).
- Receber inscrições (vão pra escrow normalmente).
- Operar o evento.
Você NÃO pode:
- Receber o repasse — o cron pula com
skipped_account_pendingaté KYC aprovar.
Quando KYC aprova após eventos já terem acontecido, o cron na próxima execução processa retroativamente os repasses pendentes que estavam represados.
Cutover produção 2026-05-31. A Kineo migrou de sandbox pra produção Asaas em 31/05/2026. Organizações que estavam em sandbox foram migradas com KYC novamente exigido (sandbox auto-aprovava; produção valida de verdade).