Tutoriais/Financeiro/CadastroContasPIX

A rotina de Configuração de PIX é utilizada para habilitar o recebimento de valores via Pix através do sistema. Nesta tela, você vincula sua Chave Pix à conta bancária e, quando necessário, configura as credenciais de integração automática (API) com o banco.

PRÉ-REQUISITO

Antes de iniciar, certifique-se de ter selecionado a Conta Bancária correta na tela de pesquisa anterior.

1. Dados Principais

Nesta etapa, definem-se as características da chave e o modo de operação.

Campo / Parâmetro	Função e Instruções
Chave Pix	Informe a chave exatamente como cadastrada no banco (CPF, CNPJ, Celular, E-mail ou Chave Aleatória).
Tipo de Chave	Selecione o tipo correspondente à chave informada.
Tipo Pix	Define como o sistema irá gerar os QR Codes: Estático: Gera um código fixo e simples. Não realiza baixa automática e não exige credenciais de API. Dinâmico: Integração direta com o banco. Gera um QR Code único para cada venda, permite consulta de status e baixa automática do financeiro.

1.1. Credenciais para Pix Dinâmico

Caso selecione o tipo Dinâmico, campos adicionais serão exibidos conforme o banco selecionado. Estas informações são fornecidas pelo gerente da conta ou pelo portal de desenvolvedores do banco.

Campo / Parâmetro	Função e Instruções
Client ID	Identificador da aplicação.
Client Secret	Senha da aplicação ou Token de Produção.
Developer Key	Chave de desenvolvedor (Exclusivo para alguns bancos, como Banco do Brasil).
Certificado / Chave Privada	Locais para selecionar os arquivos de autenticação digital (extensões .pem, .key, .cer ou .pfx) salvos no computador.
Token Temporário	(Exclusivo Itaú) Campo utilizado para colar o código temporário gerado no site do banco, necessário para solicitar o certificado definitivo via sistema.

2. Gerenciamento de Arquivos e Certificados

Para bancos que exigem certificados digitais específicos para API (como Sicredi, Sicoob ou Itaú), utilize os botões auxiliares disponíveis na tela:

Exportar Arquivos: Salva uma cópia dos arquivos de certificado e chave privada gerados pelo sistema em uma pasta local. Utilize esta função para fazer backup ou caso precise enviar os arquivos manualmente para o banco.
Solicitar Certificado: (Específico para Itaú) Realiza a troca do Token Temporário pelas credenciais definitivas de produção.

SEGURANÇA

Os arquivos de Chave Privada garantem a segurança das transações. Mantenha-os em local seguro e nunca os compartilhe com pessoas não autorizadas.

3. Taxas e Contabilidade

Configure os custos operacionais e a integração contábil na aba Taxas.

Campo / Parâmetro	Função e Instruções
Taxa (%)	Percentual cobrado pelo banco sobre cada recebimento Pix.
Conta Contábil da Taxa	Conta de despesa (Plano de Contas) onde será lançado o valor da tarifa bancária automaticamente. Obrigatório se a empresa utiliza integração contábil e houve preenchimento de taxa percentual.

4. Diagnóstico e Testes

Para garantir que a configuração está correta antes de iniciar as vendas, utilize o botão Mais Opções (Disponível no modo Dinâmico):

Testar Certificado: Valida se o arquivo de certificado selecionado está legível e dentro da validade.
Testar Chave Privada: Verifica a integridade do arquivo de chave.
Homologação: O sistema tenta criar uma cobrança de teste (geralmente de valor simbólico) no ambiente de homologação do banco para confirmar se as credenciais estão funcionando.