Cobrancas e gateway de pagamento
O Tesselys permite que sua empresa gere cobrancas diretamente para seus clientes, integrando com gateways de pagamento como Asaas e Inter. Cada empresa configura suas proprias credenciais, garantindo total isolamento dos dados financeiros.
Visao geral
O fluxo de cobrancas funciona assim:
- Voce configura o gateway de pagamento com as credenciais da sua empresa.
- Cria cobrancas vinculadas a lancamentos financeiros e clientes.
- O cliente recebe o link de pagamento (PIX, boleto ou cartao).
- O Tesselys recebe a confirmacao automatica via webhook e atualiza o status.
As credenciais do gateway sao exclusivas da sua empresa. O Tesselys nunca compartilha credenciais entre empresas diferentes.
Configurando o gateway de pagamento
- Acesse Financeiro > Cobrancas > Configuracoes do Gateway.
- Selecione o provedor (Asaas, Inter, entre outros).
- Preencha os dados:
| Campo | Obrigatorio | Descricao |
|---|---|---|
| Provedor | Sim | Gateway de pagamento escolhido |
| API Key | Sim | Chave de API fornecida pelo gateway |
| Webhook Secret | Sim | Chave para validacao de notificacoes do gateway |
| Ambiente | Sim | Producao ou sandbox (para testes) |
A API Key e armazenada com criptografia AES-256-GCM. Mesmo assim, trate suas credenciais com cuidado e nunca compartilhe com terceiros.
Metodos de pagamento suportados
| Metodo | Asaas | Inter |
|---|---|---|
| PIX | Sim | Sim |
| Boleto bancario | Sim | Sim |
| Cartao de credito | Sim | Nao |
A disponibilidade de metodos depende do gateway escolhido e da configuracao da sua conta no provedor.
Gerando cobrancas
- Acesse Financeiro > Cobrancas.
- Clique em Nova Cobranca.
- Preencha:
| Campo | Obrigatorio | Descricao |
|---|---|---|
| Cliente (Pessoa) | Sim | Para quem a cobranca sera enviada |
| Lancamento financeiro | Sim | Lancamento de receita vinculado |
| Valor | Sim | Valor da cobranca (preenchido automaticamente pelo lancamento) |
| Vencimento | Sim | Data limite para pagamento |
| Metodo de pagamento | Sim | PIX, boleto ou cartao de credito |
| Descricao | Nao | Texto descritivo que aparece para o cliente |
Ao salvar, a cobranca e enviada ao gateway e um link de pagamento e gerado automaticamente.
Voce pode gerar cobrancas a partir da tela de lancamentos financeiros. Abra o lancamento de receita e clique em Gerar Cobranca para preencher os dados automaticamente.
Status das cobrancas
As cobrancas passam pelos seguintes status:
| Status | Descricao |
|---|---|
| PENDING | Cobranca criada, aguardando pagamento |
| CONFIRMED | Pagamento confirmado pelo gateway |
| RECEIVED | Valor recebido na conta do gateway |
| OVERDUE | Vencimento ultrapassado sem pagamento |
| REFUNDED | Pagamento devolvido ao cliente |
| CANCELLED | Cobranca cancelada manualmente |
A transicao entre status acontece automaticamente via webhooks do gateway. Voce nao precisa atualizar manualmente.
Webhooks de pagamento
O Tesselys recebe notificacoes automaticas do gateway quando o status de uma cobranca muda. Para que isso funcione:
- Configure a URL de webhook fornecida pelo Tesselys no painel do seu gateway.
- O campo Webhook Secret garante que apenas notificacoes legitimas sejam processadas.
Quando um pagamento e confirmado, o Tesselys automaticamente:
- Atualiza o status da cobranca
- Marca o lancamento financeiro vinculado como liquidado
- Registra a data e detalhes do pagamento
Acompanhamento
Na tela de cobrancas, voce tem uma visao completa:
- Filtros por status: veja cobrancas pendentes, confirmadas, vencidas, etc.
- Filtros por periodo: analise cobrancas de um intervalo de datas
- Totalizadores: valores totais por status para controle financeiro rapido
Perguntas frequentes
Posso usar mais de um gateway ao mesmo tempo?
Voce configura um gateway por vez. Para trocar de provedor, atualize as credenciais nas configuracoes. Cobrancas ja emitidas continuam vinculadas ao gateway original.
O que acontece se o webhook falhar?
O gateway reenvia a notificacao automaticamente. O Tesselys tambem valida o status periodicamente para garantir consistencia.
Posso cancelar uma cobranca ja emitida?
Sim. Abra a cobranca e clique em Cancelar. A solicitacao e enviada ao gateway. Cobrancas ja pagas nao podem ser canceladas, apenas reembolsadas.
O cliente recebe email de cobranca?
Depende da configuracao do seu gateway. A maioria dos provedores envia automaticamente um email ao cliente com o link de pagamento.