Author Image

alisonoliveira10655

Jan 29, 2021

Configuração e Implementação da URL de Callbacks do Webhook

callbackswebhookconfiguraçãoimplementaçãoApacheSSLcertificadonotificaçõescobranças PIX

Pessoal. Alguém conseguiu configurar e implementar a URL de callbacks do webhook?

Respostas (3):
Avatar discord do usuario guilherme_efi

guilherme_efi

29/01/2021

Boa tarde, <@!802052811718262814>!
Tente seguir estes passos, que estão mais detalhados par aconfigurar o Apache.
Primeiramente você deve acessar o arquivo de configuração do apache, geralmente fica em /etc/apache2/mods-enabled
Nele você irá fornecer o caminho da chave privada server_ssl.key.pem e uma pública server_ssl.crt.pem da sua certificadora SSL do seu domínio.

SSLCertificateFile /caminho_certificado/server_ssl.crt.pem
SSLCertificateKeyFile /caminho_certificado/server_ssl.key.pem

Neste mesmo arquivo do apache, adicione o caminho para o arquivo com a chave pública da Gerencianet para que ocorra o "Hand-Shake". Este arquivo você mesmo criará com a nossa chave (https://pix.gerencianet.com.br/webhooks/chain-pix-sandbox.crt - Produção) e salvará em um diretório de sua escolha.
SSLCACertificateFile /caminho_certificado/chain-pix-prod.crt

Se preferir deixar apenas uma rota de sua url para notificações, ex http://seudominio.com.br/webhook" class="link-msg">http://seudominio.com.br/webhook (as notificações serão enviadas para esta rota) você pode adicionar:
SSLVerifyClient none

 SSLVerifyClient require -- Indica que todas as requisições nesta rota irão requerer um certificado para o "Hand-Shake"
 SSLVerifyDepth 3

Se preferir que todas as notificações sejam enviadas para sua URL sem um subdiretório, ex http://seudominio.com.br, basta adicionar as seguintes informações
SSLVerifyClient require
SSLVerifyDepth 3

Com basicamente isto configurado no Apache, você realiza a requisição da rota PUT/v2/webhook/:chave passando no body { "webhookUrl": "http://seudominio.com.br/webhook"; } que seu webhook estará cadastrado para sua chave Pix. A partir daí, as cobranças Pix criadas com sua chave que estejam associados a um txid serão notificados em sua URL.

Para confirmar que seu webhook foi cadastrado, basta consumir a rota GET /v2/webhook/:chave para exibir informações acerca do webook pix vinculado à sua chave

Avatar discord do usuario cezaosimao

cezaosimao

29/01/2021

Para quem não tem grande conhecimento de programação ajudaria incorporar no SDK PHP as chamadas do Webhook, como já está feito para as outras, é possível??

Avatar discord do usuario rubenskuhl

rubenskuhl

30/01/2021

A configuração de Webhook tem grande interdependência com a configuração de webserver... complexo para eles colocarem no SDK.