Pagamentos KYC

Perfil: Painel comum | Rota: /pagamentos e /parceiros/completar/* (parceiro), /interno/operacao/pagamentos/* (interno) | Última revisão: 2026-09-16

Para que serve

Configurar credenciamento financeiro: dados da empresa, documentos, conta bancária e status de repasse.

Antes de começar

• Perfis A e B acessam pelo painel interno, em /interno/operacao/pagamentos/*, e preenchem em nome de uma rede ou de um estacionamento. Eles não têm escopo próprio: o seletor de escopo é obrigatório.
• Perfis C usam a rede titular por padrão; seletor aparece se houver estabelecimento com CNPJ diferente da rede.
• Perfis D com mais de um estabelecimento escolhem o estacionamento na lista ou no seletor.
• Perfil E (manobrista) não tem acesso a estas telas.

Passo a passo

1. Acesse Pagamentos no menu ou Pagamentos / KYC na lista de estabelecimentos.
2. Se solicitado, busque e selecione a rede ou o estacionamento no seletor.
3. Confirme o banner de contexto (nome e CNPJ) antes de enviar dados.
4. Complete as etapas: empresa → documentos → dados bancários → status.
5. Use Trocar no banner para alterar o escopo sem sair do fluxo.

O que muda para A e B

• No topo de todas as telas do fluxo aparece um aviso de preenchimento interno, com o nome do parceiro e o lembrete de que o aceite dos termos é registrado em auditoria com o usuário do operador, não com o do parceiro.
• A navegação entre as etapas é livre: o sistema não empurra para a etapa pendente nem bloqueia etapas à frente. Dá para abrir direto documentos ou banco.
• A visão geral de pagamentos abre mesmo com o credenciamento incompleto, para que o estado parcial fique visível.
• A etapa de estabelecimento leva ao cadastro operacional interno (/interno/operacao/estabelecimentos/cadastro), não ao fluxo de parceiro.

O que você pode fazer aqui

• Enviar KYC e documentos para o escopo selecionado.
• Consultar requirements pendentes e status de repasse.

O que você NÃO pode fazer

• Burlar o seletor de escopo (A/B) — o sistema bloqueia até escolher rede ou estabelecimento.
• Aceitar os termos em nome de um parceiro sem autorização rastreável do representante legal — o aceite fica gravado com o seu usuário.
• Assumir que cadastro de estacionamento substitui KYC — split só após credenciamento completo.

Erros comuns

• Dados gravados no estabelecimento errado: verifique o banner de contexto antes de cada POST.
• Selecione a rede ou o estacionamento: perfil A/B sem escopo na sessão.
• Acesso negado no wizard: perfil E, que está fora da permissão payments.kyc.

Ver também

• Docs/features/merchant-context/overview.md
• Docs/features/stripe-connect-custom/kyc-preenchimento-interno.md
• Cadastro operacional em estabelecimentos/cadastro (independente do KYC)