Controle de pagamentos via boleto
- Gerar o boleto de cobrança
- Gravar dados da cobrança em banco de dados (assinante, vencimento, valor, etc)
- Obter o arquivo-retorno do banco (todo dia útil)
- Processar o arquivo-retorno (aqui você fica sabendo os detalhes dos pagamentos)
- Atualizar o banco de dados com as informações obtidas (marcar cobranças pagas, etc)
- Verificar os pagamentos em atraso (ainda não pago após data de vencimento) e efetuar o bloqueio
Gerando o boleto
Sempre do lado do cliente, estive envolvido com geração de boletos usando PHP desde 2007, tendo utilizado os serviços do Banco do Brasil, Bradesco e Caixa Econômica Federal, nas modalidades sem registro e registrada.
No ano passado, fiz um Bundle de geração de boletos para o Symfony 2 que faz o mesmo serviço que o BoletoPHP: a partir dos dados de cobrança informados, gera o boleto correspondente. Porém, esta é só uma parte do sistema.
As informações que seguem são válidas para os bancos mencionados acima, dentro da experiência que tive. Creio que os demais sigam o mesmo modelo.
Obtendo o arquivo-retorno
Para controlar as mensalidades, ou seja, saber quais boletos foram pagos, você precisa obter o arquivo-retorno que é gerado todo dia útil pelo banco, e contém as informações sobre os boletos processados naquele dia.
Como você obtém o arquivo-retorno do banco?
Ou através de Internet Banking, ou de algum software proprietário a ser instalado por um técnico do banco. Infelizmente, não há uma API ou outra maneira mais simples e passível de ser automatizada por parte do cliente. A rotina de obter o arquivo-retorno do banco, e em seguida enviar o mesmo para o seu sistema processá-lo, é uma tarefa manual.
A resposta exata sobre a forma de obtenção desses arquivos será dada pelo próprio banco, seja quando for feita a contratação da carteira de cobrança, ou em qualquer outro momento.
Gerando e enviando o arquivo-remessa
Nos contratos de carteira registrada, é necessário também gerar e enviar para o banco o chamado arquivo-remessa, para que os boletos gerados pelo seu sistema sejam registrados no sistema do banco. Os envios são feitos de maneira similar (Internet Banking ou software proprietário). Na Caixa Econômica há um processo de homologação para validar a formatação dos seus arquivos-remessa. Depois de uma fase de testes, é ativada a fase de "produção", quando os arquivos-remessa enviados passam a ser efetivamente registrados.
Também no ano passado, no mesmo sistema em Symfony 2, implementei uma classe para gerar arquivos-remessa a partir dos dados de cobrança e dos boletos gerados pelo sistema - porém esse código não está em domínio público.
Padrão CNAB
Tanto os arquivos enviados para o banco (arquivo-remessa, apenas para a carteira registrada) quanto os arquivos recebidos do banco (arquivo-retorno diário) seguem uma formatação padrão.
O padrão CNAB (Centro Nacional de Automação Bancária) tem algumas variações - CNAB 240, CNAB 400, etc. Nos sites do Banco do Brasil e da Caixa Econômica Federal estão disponibilizados os documentos técnicos que detalham o padrão utilizado para essa comunicação entre o banco e o cliente.
Cada banco deve manter uma documentação semelhante, a qual é necessária para implementar qualquer solução que precise gerar ou processar arquivos "retorno" e/ou "remessa".
Processando o arquivo-retorno
Como existem variações entre cada banco, não existe uma solução pronta para todos. É preciso estar com a documentação técnica, e fazer a implementação de acordo. Assim como temos "vários tipos de boletos" no BoletoPHP... temos vários "tipos de arquivo-retorno" e vários "tipos de arquivo-remessa".
Eu já fiz implementações de processamento de arquivo-retorno, em PHP, para os três bancos mencionados, dos quais os meus clientes eram clientes. Esta é outra parte do sistema cujo código não está em domínio público.
Não é difícil, mas é trabalhoso - há muitos detalhes, muitos campos... não é nada agradável.
Em suma
O que você vai precisar é:
Diálogo com o banco a fim de obter acesso aos arquivos-retorno
Rotina de obter o arquivo e enviar para o seu sistema
Implementação de script que processe os arquivos-retorno recebidos pelo sistema