Configurar os provedores de pagamento Pix, Cielo e PagSeguro

  • Cenário FIN-17

  • Prévia: em revisão na OCA

  • Perfil: Administrador (implantação)

  • Mais tarefas do perfil: Administrador (implantação)

  • Odoo 16.0

Etapa 12 de 12 do processo Cobrança: boleto, CNAB e PIX. Anterior: Conciliar o pagamento efetivo da nota por evento ECONF.

Habilita, em Modo de Teste, os três provedores de pagamento brasileiros do Faturamento: Pix pela API do Banco Central (cobrança imediata com QR code), cartão pela Cielo e cartão pelo PagSeguro. É o pré-requisito para o cliente pagar a fatura pelo portal.

Visão geral: Emitir boletos e acompanhar remessa e retorno CNAB

Importante

Prévia: módulos novos em revisão na OCA (PRs OCA/l10n-brazil#4799, #4794 e #4797), ainda fora da versão oficial 16.0. Telas e regras podem mudar. Credenciais fictícias: nada é enviado a banco ou operadora.

Vídeo

Duração: 2 min 23 s. Sem áudio: a narração está nas legendas, na faixa de baixo do vídeo.

Antes de começar

  • Conta no banco ou adquirente com as credenciais da aplicação (no vídeo, valores fictícios).

  • Módulos payment_bacen_pix, payment_cielo e payment_pagseguro instalados: eles ainda estão em revisão na OCA (PRs 4799, 4794 e 4797).

  • Atenção à empresa ativa: os provedores pertencem à Sua Empresa (São Paulo). Com outra empresa ativa a lista vem vazia.

Exemplo usado neste cenário

Com a empresa Sua Empresa (São Paulo) ativa, os três provedores recebem credenciais fictícias e passam de Desabilitado para Modo de Teste. Nenhuma credencial é real e nada é enviado ao banco, à Cielo ou ao PagSeguro.

Como os valores são calculados:

  • Cenário de configuração: não há valor fiscal a calcular.

  • O Soft Descriptor é o texto da fatura do cartão: a Cielo trunca em 13 caracteres e o PagSeguro em 17. KMEE DEMO tem 9.

  • Chave Pix e credenciais são obrigatórias para sair de Desabilitado (Modo de Teste ou Habilitado).

Passo a passo

  1. Abra o aplicativo Faturamento pelo menu de aplicativos.

  2. No menu Configuração, escolha Provedores de serviços de pagamento.

  3. Abra o cartão Bacen (PIX).

  4. Na aba Credenciais, confira o Pix Provider: Banco do Brasil.

  5. Informe a Pix Key fictícia pix.ficticio@exemplo.com.br.

  6. Informe o ID do Cliente e o Client Secret fictícios.

  7. Marque o Estado Modo de Teste e clique em Salvar.

  8. Volte para a lista pela trilha e abra o cartão Cielo.

  9. Informe o ID Comerciante Cielo, a Chave Comerciante Cielo e o Soft Descriptor KMEE DEMO.

  10. Marque o Estado Modo de Teste e clique em Salvar.

  11. Volte para a lista pela trilha e abra o cartão PagSeguro.

  12. Informe o API Token fictício e o Soft Descriptor KMEE DEMO.

  13. Marque o Estado Modo de Teste e clique em Salvar.

  14. Volte para a lista e confira os três provedores em Modo de Teste.

Resultado esperado

Bacen (PIX), Cielo e PagSeguro ficam em Modo de Teste na Sua Empresa (São Paulo), com as credenciais fictícias gravadas. Em Modo de Teste o Odoo usa o ambiente de testes de cada provedor; com credenciais reais, passe o Estado para Habilitado para produção.

Se houver erro

  • A lista de provedores vem vazia ou o formulário dá erro de acesso. A empresa ativa não é a dona dos provedores (Sua Empresa, São Paulo). Troque a empresa ativa no topo da tela ou crie o provedor para a empresa desejada.

  • O Odoo não deixa salvar em Modo de Teste e marca campos em vermelho. Chave Pix, ID do Cliente e Client Secret (Pix) são obrigatórios fora de Desabilitado. Preencha os campos obrigatórios antes de trocar o Estado.

  • O Pix recusa a conta ao receber. Chave Pix, credenciais ou certificado não conferem com o cadastro no banco. Confira os dados no portal de desenvolvedores do banco; Banco Inter exige Certificate e Private Key.

Limites deste cenário

Só o cadastro dos provedores. Pagar a fatura (QR code, cartão) passa pelo ambiente de testes do provedor e exige credencial real: não é filmado, e nenhuma cobrança é feita. Cobrança Pix com vencimento (cobv), Pix Automático e baixa por CNAB não existem nestes módulos (ver Cobrar por PIX e baixar o recebimento). O Pix cobre Banco do Brasil e Banco Inter. Os provedores só aceitam pagamentos em reais.

Módulos: payment_bacen_pix, payment_cielo, payment_pagseguro. Os valores do exemplo foram conferidos automaticamente na execução gravada; a conferência não substitui a validação do contador da sua empresa.