Termos mais procurados:
PUT /v2/webhook/:chave
na URL, ":chave" é a sua chave PIX na GN. Você consegue vê-la/gerá-la através do App da Gerencianet. Não é possível vê-la pelo site, somente pelo App
no body
"webhookUrl", você deve informar a url de callback do seu sistema, que irá receber as notificações de alterações de status da cobrança
Galera, quais parâmetros preciso passar na url e no body para criar um webhook? To com dificuldade nessa parte
Aconteceu comigo 6 vezes, mas como faço o tratamento para verificar se a soma dos pix recebidos menos a soma das possíveis devoluções bate com o valor devido, não realizei nenhuma baixa indevida. Você consegue verificar isso através de uma consulta GET /v2/cob e filtrando "inicio=data_inicial&fim=data_final&status=CONCLUIDA". Feito o filtro, faça uma varredura para verificar quais estão sem o array pix. Daí você verifica o txid dessas cobranças no seu sistema para ver se estão marcadas como pagas.
Edit: aconteceu da cobrança mudar o status, não a parte do usuário tentar pagar e dar o erro causando a mudança de status
Vou ver se consigo colocar nos issues lá. Obrigado pelo repositório, de grande ajuda!
Para quem precisar, segue o código da verificação extra do CONCLUIDA:
No código parece estar tudo 100%
Ele muda conforme o Status da Consulta na Gerencianet
Por garantia, colocamos mais logs ainda, salvando a Consulta original e uma verificação extra para o Status CONCLUIDA, verificando se tem o array do Pix, valor e se bate com o da cobrança também
Este é o primeiro relato similar que vejo, mas se tivesse acontecido comigo, dividiria a análise do caso em 3 partes.
- certificar se o cliente realmente não foi debitado, uma vez que pelo relato, ele não sabe o saldo anterior e, aparente, não sabe consultar o histórico de movimentações
- certificar se houve mudança de status na GN que justifique a baixa da cobrança
- certificar se o sistema está fazendo baixas apenas com base em notificações realmente pagas, pois nem toda cobrança com status "CONCLUIDA" está de fato paga
Minha impressão é que pode ter ocorrido o seguinte (HIPÓTESE):
Algumas cobranças passam para o status "CONCLUIDA" em determinadas situações, principalmente quando consumimos a rota PUT /v2/cob. Não era pra acontecer, mas acontece. Daí, pode ser que quando o cliente leu o location, a cobrança pode ter mudado de status para "CONCLUIDA". Então, quando ele tentou pagar deu erro, pois a cobrança não estava mais "ATIVA". Uma notificação de mudança de status ocorreu ao alterar para "CONCLUIDA" e o sistema processou a baixa sem verificar se o array de pix estava devidamente preenchido
