As formas de pagamento que o cliente final usa pra pagar (boleto, Pix, cartão, débito em conta) são configuradas em cima de dois cadastros: Carteira e Carteira Modelo.
- A Carteira (Recebimento > Carteira de Cobrança) guarda os dados bancários — cedente, convênio, agência, conta.
- A Carteira Modelo é a forma de cobrança em si — cada modelo representa uma opção concreta (Boleto, Boleto+Pix, Pix, Cartão, Débito em conta, Pix Automático). Ela fica dentro da Carteira, na aba "Configurações para cobranças".
Não confunda com "Carteira Forma de Pagamento": apesar do nome parecido, esse é outro cadastro — usado só internamente pra mapear capital/juros/desconto pras contas contábeis certas, não tem relação com o que o cliente vê pra pagar.
Pré-requisito
- Ter os dados/credenciais do gateway ou banco em mãos (as informações variam por gateway — consulte o manual de homologação específico do seu gateway, se usar um).
- Certificado digital (.pem/.key/.crt), quando o gateway exigir (Sicredi e Efí, por exemplo).
- Acesse Recebimento > Carteira de Cobrança e clique em "Adicionar carteira". O wizard tem 4 passos.
-
Configurações da carteira: descrição, CNPJ/razão social, o banco ou gateway, e os dados bancários (agência, conta, convênio, cedente).
-
Configuração de cobrança: escolha o Tipo de cobrança (Boleto, Boleto+Pix, Pix, Cartão, Débito em conta, Pix Automático — as opções mudam conforme o banco/gateway escolhido no passo anterior), conta contábil, chave Pix (se aplicável) e instruções do boleto.
-
Gateway (só aparece se o tipo escolhido for de gateway): ambiente (Homologação ou Produção) e as credenciais fornecidas pelo próprio gateway (Client ID, Client Secret, tokens). Se o gateway exigir certificado, use o botão "Importar certificado" na tela de Carteira Modelo depois de criada.
-
Resumo: confirme e grave.
- Depois de criada, volte na Carteira Modelo e clique em "Testar gateway" antes de colocar em produção — o sistema tenta autenticar de verdade com as credenciais informadas.
Criar a Carteira Modelo não é suficiente sozinho — depende de onde ela vai ser usada:
-
Como forma de cobrança do contrato (o boleto que o cliente recebe todo mês): ajuste o campo de Carteira Modelo no cadastro do contrato do cliente, ou troque o padrão do sistema em Configurações > Cliente > Carteira modelo padrão (vale pra contratos novos).
-
Como opção de pagamento avulso no Portal do Cliente (aquele botão "Pagar" que o cliente usa fora do boleto): vá em Configurações > Área do Cliente, aba Cliente, e selecione a Carteira Modelo em Carteira modelo (Boleto), Carteira modelo (Pix) ou Carteira modelo (Cartão), conforme o caso.
Atenção: só carteiras modelo configuradas com gateway aparecem como opção no Portal do Cliente. Uma carteira de boleto bancário tradicional (registrado direto no banco, sem gateway) não entra nessas opções — ela serve pra gerar a fatura mensal, não pra pagamento avulso instantâneo.
Asaas, Banco do Brasil (boleto e Pix), Banrisul, Cielo, Cresol, Efí (Pix Automático), GalaxPay, Itaú, Juno, Mercado Pago, ModoBank, Safe2Pay, Santander, Sicoob (inclusive Pix), Sicredi (boleto, cartão, Pix e Pix Automático) e WidePay.
Onde acompanhar o que está acontecendo
-
Financeiro Gateway (Recebimento > Financeiro Gateway) — histórico/busca de qualquer requisição feita a qualquer gateway, útil pra investigar cobrança que não confirmou.
-
Pix Automático — histórico específico das autorizações de recorrência do Pix Automático (recurso ainda em amadurecimento, sem menu fixo).
Erros comuns
-
"Gateway: Não foi possível encontrar o gateway de pagamento." — a Carteira Modelo está com um tipo de integração que o sistema não reconhece; confira se o gateway escolhido está correto.
- Cobrança fica "pendente" sem confirmar — normalmente é credencial errada ou certificado expirado; use o botão "Testar gateway" pra confirmar antes de suspeitar de outra causa.
- Forma de pagamento nova não aparece pro cliente no Portal — confira se ela foi selecionada em Configurações > Área do Cliente (criar a Carteira Modelo sozinha não é suficiente).