Como testar retorno de dados durante o desenvolvimento

Outro dia estava desenvolvendo uma integração com o BoaCompra aqui para o Magenteiro, e chegou a hora de testar o controller responsável por tratar os retornos enviados pelo site deles notificando alterações no pedido.

O problema é que até o momento o módulo de pagamento só existe na minha máquina e a URL é inacessível pelos servidores ou qualquer rede externa à minha.

A solução mais simples do mundo

Ao invés de quebrar cabeça tentando mapear os 3 roteadores para direcionar chamadas externas pro meu computador, acabei encontrando uma solução excelente e simples para o problema.

Webhook.site

O webhook.site cria uma URL única que captura e exibe todos os requests HTTP feitos para essa url. É ideal para testar webhooks e retornos vindos de webservices externos.

Desta forma, eu apenas precisei trocar a URL de retorno pela URL temporária do Webhook.site. Com os dados recebidos nas notificações eu posso então simular a mesma requisição, com os mesmos parâmetros, headers, e tudo mais localmente.

Simples, né?

Update: Testando localmente sem alterar roteadores (Outra ferramenta)

Pouco após publicar o artigo com a solução acima, recebi uma contribuição valiosa do Raphael Pereira e do Rodrigo Mourão (da Webjump).

Trata-se do ngrok. Com um único comando você tem um URL apontando para sua máquina e um inspetor de requisições bem bacana.

O serviço possuí vários planos, mas o plano gratuito já é suficiente para a maioria dos casos.

Uma vez instalado e autenticado no serviço, basta digitar ngrok http --host-header=minhalojamagento.local 80 ou ngrok http --host-header=minhalojamagento.local 443 (caso a url local seja SSL).

Até onde consegui testar, não foi possível carregar imagens, CSS e JS na url externa acessando de um outro dispositivo. Mas para testar requisições e retorno de dados, isso se mostrou ainda mais fácil e eficiente para muitos casos.

• Sobre
• Últimos Posts

Ricardo Martins

É desenvolvedor web há 16 anos e um dos primeiros certificados pela Magento no Brasil. Instrutor de mais de 11 cursos Magento (os principais no magenteiro.com/cursos) com mais de 14 mil alunos de 105 países, é também criador do módulo PagSeguro Transparente, usado em mais de 12 mil lojas.

Últimos posts por Ricardo Martins (exibir todos)

• Guest checkout bloqueado na API REST do Magento 2? Confira isso. - 7 de julho de 2026
• Você precisa testar esta plataforma de e-commerce - 9 de fevereiro de 2026
• A hora de montar o seu OnlyFans chegou! Veja 8 ideias pra começar o seu. - 4 de dezembro de 2024