Repository files navigation

Esse código é um exemplo de servidor que recebe webhooks doBoleto Simples.

Ele complementa aDocumentação da API mas pode ser usado para testes e debug enquanto se desenvolve uma integração noambiente de Sandbox.

$ git clone https://github.com/BoletoSimples/boletosimples-webhook-test.git

Entre no diretório baixado:

$ cd boletosimples-webhook-test

Configure na variável de ambiente a Chave Secreta do webhook. Exemplo:

$ export WEBHOOK_SECRET_KEY=2ef97bc3ec0bb91ba9c61afa301bda735a0fdbf2fbee154c7e738ef39be0211c

Atenção: Substitua o valor2ef97bc... pela chave secreta do webhook que você deseja testar.

Para iniciar o servidor rode:

$ shotgun config.ru

Abra o navegador na página:

$ http://localhost:9393

Se tudo correr bem, você deve ver essa documentação.

ngrok é um aplicativo que cria um túnel entre a internet e o seu computador, permitindo que as resquisições do webhook cheguem do servidor online ao seu servidor local.

Apósinstalar o ngrok, rode:

$ ngrok 9393

Abra o navegador na página:

$ http://localhost:4040

Você deve ver o painel do ngrok.

Configure a URL do webhook com o host fornecido pelo output do ngrok em Forwarding e o path /callbacks/boletosimples.

Exemplo:

http://boletosimples-webhook-test-rafael.ngrok.com/callbacks/boletosimples

Atenção: Essa configuração não deve ser feita no ambiente de produção, deve ser feita apenas no ambiente de sandbox para propósito de teste e debug.

Pronto! A partir de agora, você irá receber as notificações dos eventos do Boleto Simples no seu servidor local.

Esse código é livre para ser usado dentro dos termos da licençaMIT license.

Comentários são bem-vindos. Envie seu feedback através doissue tracker do GitHub

Rafael Lima trabalhando noBoletoSimples

Blog:http://rafael.adm.br

Twitter:http://twitter.com/rafaelp