Configuração de Contas Split (Subcontas) nas Adquirentes
🛠️ Como criar a conta split do produtor
Siga o passo a passo no painel de admin:
Acesse o Painel de Admin
Acesse a aba de Produtores.
Localize o produtor desejado
Clique em Ver mais informações
Vá até a aba Contas Split
Clique em "Criar conta"

A plataforma enviará os dados do produtor para a adquirente, que criará a subconta vinculada a ele.
⏳ Status pendente e verificação de identidade
Em algumas adquirentes, após a criação da conta, o status pode ficar como pendente.

Isso ocorre porque o produtor ainda precisa realizar a verificação de identidade (prova de vida).
O que o produtor deve fazer
O produtor deve acessar o próprio painel e seguir o caminho:
Perfil -> Configurações -> Meus documentos -> Verificação de identidade
Nessa nova aba, ele deverá seguir as instruções para concluir a verificação.

Após a conclusão dos passos, o status da subconta no painel admin muda para Analyzing, indicando que o produtor fez a verificação de identidade, e agora a adquirente está confirmando as informações.

⚠️ Importante:
Mesmo que documentos como RG e conta bancária já estejam aprovados, a verificação de identidade ainda será obrigatória quando solicitada pela adquirente.
Somente após a conclusão dessa etapa a conta será validada para vendas.
Caso o produtor já tenha concluído a verificação de identidade em uma adquirente, mas ainda tenha outra adquirente vinculada sem essa verificação, o aviso em vermelho no topo do painel continuará sendo exibido.
Para que a mensagem desapareça e ele possa vender normalmente, é necessário:
O admin deve criar a subconta para esse produtor no seu painel
O produtor deve concluir a verificação de identidade referente a outra adquirente
ouRemover essa adquirente pendente das configurações desse produtor

Somente após isso o produtor poderá seguir com as vendas utilizando a adquirente que já está validada.
❗ Observações importantes
Erro ao gerar QR Code: IP não autorizado (Pagar.me)
Se aparecer o erro:
"IP de origem não autorizado a realizar essa operação"
Isso indica que a Pagar.me ainda não liberou os IPs da nossa plataforma para se comunicar com a conta da sua empresa.
Para resolver, é necessário adicionar os nossos IPs no painel da pagar.me:
https://id.pagar.me/signin → Configurações → Conta → IPs permitidos.
(https://docs.pagar.me/docs/ip-allowlist)
Caso não consiga realizar a configuração por esse caminho, entre em contato com o suporte da Pagar.me e solicite a liberação manual dos IPs:
3.220.74.68
44.214.72.54
Após a liberação, a geração do QR Code deverá funcionar normalmente.
Pagar.me – Função Split não habilitada
Se estiver utilizando a Pagar.me, é necessário garantir que a função de Split de pagamentos esteja habilitada na sua conta junto à adquirente.
Essa ativação é feita diretamente com o suporte da Pagar.me.
Caso a função não esteja ativa, ao tentar criar a subconta ocorrerá o erro:
"The account must have split settings enabled, in order to create a recipient".
"Recebedor não completou as etapas previas a obtenção do QRCode" - Pagar.me
Essa mensagem de "Recebedor não completou as etapas prévias à obtenção do QR Code" é retornada diretamente pela Pagar.me.
Normalmente, ela indica que o recebedor ainda não concluiu ou não teve aprovadas todas as etapas de validação exigidas pela adquirente, como o envio e a aprovação da documentação necessária para a geração do QR Code de prova de vida.
Asaas – Modo White Label não habilitado
Já se sua operação utiliza a adquirente Asaas, então será necessário solicitar ao suporte da própria adquirente a ativação do modo White Label na sua conta master.
Essa configuração é essencial para que os produtores consigam realizar a verificação de identidade diretamente pelo gateway.
Caso o modo White Label não esteja habilitado, ao tentar gerar o QR Code para a verificação, o sistema retornará o seguinte erro vindo da adquirente:
"Não foi possível encontrar o link de KYC"

Nessa situação, basta entrar em contato também com o suporte da adquirente, no caso a Asaas, e solicitar a ativação do modo White Label para a sua conta.
Pagar.me - The recipient could not be created

Esse erro indica que o número da agência bancária do produtor está muito longo para o formato aceito pela Pagar.me.
Para resolver:
Verifique os dados bancários do produtor:
A agência deve ter no máximo 4 dígitos
Remova qualquer hífen ou caractere especial
Use apenas números
Exemplo de preenchimento:

Como corrigir na sua plataforma:
Acesse os dados do produtor
Vá até as informações bancárias
Confirme os dados enviados e caso esteja incorreto, rejeite as informações bancárias e informe o motivo

Após as devidas correções, clique em Deletar Conta e tente criar a conta split novamente.
Botão de gerar QR indispoível
Caso a opção de Gerar QR não esteja clicável, isso significa que não foi feito o passo anterior de "Criar conta" ou teve algum erro na criação de subconta. Para confirmar basta verificar qual foi o retorno da adquirente após a criação da subconta.
