Termos mais procurados:
Então, independente da forma como seu cliente tenha escolhido pagar (QRCode Pix ou Código de Barras), você pode consultar o status do Boleto através da rota GET /v1/charge/:id. Ou, caso já tenha configurado uma URL de Notificação, através da rota GET /v1/notification/:token.
Olá, @mathheusdr! Bom dia!
Não é possível utilizar seu localhost como URL de notificação, pois o caminho precisa estar acessível publicamente para que a API encontre-o e estabeleça a comunicação necessária para o envio das notificações.
Bom dia, @carlosdombosco! Tudo joia?
Assim como ocorre na emissão de boletos e canês, é possível sim associar uma URL de notificação na criação de assinaturas através da API e o nome do atributo para informar a URL é o mesmo: metadata -> notification_url
Nas assinaturas, iremos emitir a cobrança de acordo com a periodicidade que você informou e sempre que as cobranças forem emitidas, iremos enviar uma notificação informando sobre esta emissão.
Bom dia @lucasbernieri tudo certo?
No momento da crianção da cobrança você precisa definir uma URL de notificações.
Dessa forma, quando houver uma alteração no status da cobrança, será enviado para aquela URL um post contendo o token de notificação.
Você então utiliza esse token para consultar na nossa API que retornará o status atualizado da cobrança.
Na nossa documentação você encontra mais detalhes sobre esse processo: https://dev.gerencianet.com.br/docs/notificacoes-recebendo
Bom dia pessoal, estou com algumas dúvidas relacionadas com a integração via API para o PIX.
Usando o SDK PHP, já consegui gerar as cobranças, associadas com uma chave PIX gerada dentro da minha conta, mas estou um pouco confuso sobre a parte de webhooks de notificação e diferenças entre homologação e produção.
Sobre a parte de Webhooks, eu entendi que preciso cadastrar via API qual é a URL que o Gerencianet deverá notificar quando houver algum evento relacionado com a chave PIX. Até consegui realizar alguns testes utilizando a coleção do postman, gerando a cobrança e recebendo a notificação post da Gerencianet.
Um ponto relacionado com a aplicação que estou trabalhando é que o cliente está em um servidor compartilhado. Vi na documentação que é possível utilizar o parâmetro
Boa tarde @snarloff tudo certo?
O token é enviado pela nossa API para a URL de notificação informada no momento da criação da cobrança.
Você também consegue visualizar através do menu API > selecione sua aplicação > Histórico de notificações
Sim, ao cadastrar a transação você informa uma URL de notificação. Essa URL vai ser acionada quando algo mudar; o que mudou (ex: pagamento, contestação, notificação de fraude) você vem tem que usar uma API da Efí para confirmar o que aconteceu.
Certo. Neste caso, @carlos06_3, você consegue associar uma URL de notificação para estas cobranças que você esta emitindo.
Quando você realiza o cadastro da URL, a cada alteração no status da cobrança, iremos notificar através da URL informada.
Você consegue consultar mais informações sobre as notificações, acessando: https://dev.gerencianet.com.br/docs/notificacoes-recebendo
Bom dia, @sheikzadarevo! Tudo bem?
A URL de notificação não é definida na emissão da cobrança Pix.
Você deve associar uma URL de notificação a sua chave Pix, então as cobranças Pix que tiverem um txid e sua chave Pix, nós iremos enviar a notificação para a URL registrada. Essa configuração pode ser feita uma única vez através do endpoint PUT/v2/webhook/:chave (https://dev.gerencianet.com.br/docs/api-pix-endpoints#configurar-o-webhook-pix).
Pontuando que para registrar sua URL de notificação, seu servidor deve possuir algumas configurações para atender a comunicalção com mTLS. Você encotra mais detalhes em nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks
Tem como definir url de notificação ?
@Consultoria Técnica
Bom dia @sr.brunomendes ! Tudo bem? A API Pix e a API Emissão utilizam mecanismos diferentes para notificação. No caso da API de Emissão, você pode cadastrar a URL de notificação no momento da emissão da cobrança, no atributo notification_url. Neste link da nossa Documentação disponibilizamos mais detalhes sobre este fluxo: https://dev.gerencianet.com.br/docs/notificacoes-recebendo
Bom dia, a uns dias atrás perguntei sobre a informação da URL de notificação através da API ao invés da utilização do SDK. Todas as minhas requisições de criação do pagamento estão sendo via endpoint (com Guzzle). Existe algum exemplo de criação da action da URL de notificação em PHP?
Boa noite, encontrei a informação do url de notificação, obrigado, agora estou com outra dúvida existe a possibilidade de pesquisa por cpf dos boletos emitidos e trazer o status desses boletos, ou pesquisa por faixa de data utilizando a API ?
Olá, @israelcosta. Bom dia, como vai?
Primeiramente, para que recebe as notificações a cerca do Pix vocÊ deve configurar uma webhook URL associada a uma chave Pix da sua conta Efí. Desta forma, cobranças Pix com essa chave que forem pagas ou tiveram devoluções, acionaremos seu webhok para notificação.
No link a seguir você encontra os detalhes para configurar o webhook: https://dev.gerencianet.com.br/docs/api-pix-endpoints#configurar-o-webhook-pix
Depois de ter os webhook configurado, você pode testar no ambiente de homologação, basta criar a cobrança atendendo as seguintes regras:
Se o valor da cobrança está entre R$ 0.01 à R$ 10.00:
-A cobrança é confirmada, informação virá via Webhook.
Se o valor da cobrança é maior que R$ 10.00:
-A cobrança permanece ativa, sem confirmação. Como não há webhook nesses casos, nada é feito
Bom dia, alguém tem algum exemplo de criação da cobrança pix com url de notificação usando Guzzle?
Como é sua URL de notificação ?
Bom dia pessoal, seguinte, eu já fiz a integração do boleto e do pix, graças a Deus está ok, a questão da url de notificação tb está ok, mas a parte do pix eu não consegui, eu tenho um servidor debian 11, rodo meu sistema em PHP, instalei o certificado manual e não rodou a questão do webhook
Neste caso, você esta fazendo um mal uso da nossa API, ou seja, esta realizando requisições desnecessárias.
Você consegue contornar a sua situação através do nosso sistema de webhook: https://dev.gerencianet.com.br/docs/notificacoes-recebendo
Com uma URL de notificação cadastrada, você não precisará mais de ficar consultando os boletos em nossa API, pois sempre que ocorrer alguma alteração de status em uma determinada cobrança, iremos notificar o seu sistema.
Exato!
Você consegue cadastrar a URL de notificação
Boa tarde, @everaldojunior! Você fala em alterar a sua URL de notificação?
