Histórico de mensagens sobre url de notificação

Olá, @leandro535! Bom dia!

Para receber notificações de carnê ou boleto, você define a URL no momento da criação da cobrança. Então, sempre que houver uma mudança de status da cobrança, a Efí dispara um POST para essa URL. Essa notificação vem com um token específico, que permanece o mesmo durante todo o ciclo de alterações da transação.

Para simplificar, você pode usar este exemplo da SDK de PHP para consultar o token da notificação e obter os detalhes atualizados da cobrança. Aqui está o link.

Além disso, você pode conferir mais detalhes na documentação técnica aqui.

Temos também um vídeo sobre o assunto neste link.

To dando uma olhada aq. Só não entendi uma parte, ele pede um URL de notificação, como esse URL é definida? Ou como eu consigo ela?

Principal diferença do webhook é que ele se aplica a todos os Pix de uma determinada chave Pix, não é URL de notificação para cada transação. Isso que pode estar confundindo o @alex_684067_87631 .

Além disso, quando você estiver registrando a webhook URL no endpoint PUT /v2/webhook/:chave, na sua URL você pode acrescentar algum parâmetro para diferenciar a URL de cada cliente, e assim fazer alguma tratativa na sua aplicação. Exemplo:

@.andregomes, quando você registra o webhook no endpoint PUT /v2/webhook/:chave, você está basicamente associando uma chave Pix a uma URL específica. No seu caso, a URL permanecerá a mesma, mas a chave será única para cada conta de cliente.

Assim que nossa API enviar a notificação, o JSON incluirá essa chave. Isso permitirá que você identifique de qual conta é aquele recebimento. Além disso, através do txid, você poderá saber a qual cobrança se refere.

Bom dia, @hempel2043! Como vai?
Conforme o Rubens mencionou, é necessário que a emissão do carnê/boleto seja feita através da API. Assim, você poderá definir a URL de notificação para receber as atualizações. Os boletos emitidos através da interface da Efí não podem ser gerenciados via API.

Bom dia, @vini.montanheiro! Tudo certo e com você?
Sempre que há uma alteração no status de uma cobrança, uma notificação é enviada para a URL especificada. O reenvio pode ocorrer em dois cenários: quando há uma solicitação explícita de reenvio ou quando a notificação anterior enviada para a URL retorna um status de falha.

Bom dia @jhon0029 ! Esse endpoint é utilizado para configurar seu webhook. Se sua url de webhook estiver correta, ao consumir este endpoint, o retorno da API será a propria url, ou seja o mesmo body da requisição enviado e você receberá uma notificação dessa forma:

Boa tarde, @hlyras!

Sugerimos as duas formas de validação a seguir, mas recomendamos fortemente que as utilize em conjunto:

Verifique o IP de comunicação: Você pode restringir a comunicação ao domínio do webhhook cadastrado para aceitar apenas mensagens do IP utilizado pela Efí.
IP utilizado atualmente em nossas comunicações: '34.193.116.226'.

Adicione uma hash à URL cadastrada no webhook: Crie um hmac (uma identificação própria) que será acrescentado ao final da URL no momento do cadastro do webhook. Essa hash será utilizada para validar a origem da notificação. Assim, todos os webhooks enviados ao seu servidor terão essa identificação final e sua aplicação deve validar a presença da mesma.

Exemplo:
URL de notificação original: https://seu_dominio.com.br/webhook
Como deverá ser cadastrada com a hash: https://seu_dominio.com.br/webhook?hmac=xyz&ignorar=. O termo ignorar= servirá para tratar a adição do /pix no final da URL.

Bom dia @rian2965, tudo bem?

Você pode consumir o endpoint POST /v1/plan/:id/subscription/one-step para emitir a cobrança e ao mesmo tempo atribuir a URL de notificação com o atributo metadata.

Uma vez que a cobrança tenha uma URL de notificação, todas as alterações nela irão fazer com que seja disparado um POST para sua URL, nesta notificação terá um token que deve ser consultado para verificar a situação da cobrança

Opa, boa noite

tenho duas duvidas referentes as assinaturas

no endpoint de criar uma assinatura e pagar pelo bolix, eu consigo informar a url de notification?
atualmente eu faço isso em 2 passos, primeiro crio e depois atribuo

após assinar, o cliente vai ficar recebendo a cobrança no cartão. Então todo mês, após o primeiro pagamento, sempre que ele pagar será recebido uma post notificação no meu sistema?

Você pode configurar uma URL de notificação, para receber em seu servidor a cada alteração de status, ou pode também buscar os detalhes da cobrança por meio deste endpoint: https://dev.efipay.com.br/docs/api-cobrancas/boleto#retornar-informa%C3%A7%C3%B5es-de-transa%C3%A7%C3%A3o-existente

O token não se perde não.
Verifique em sua conta, no menu API > Sua aplicação > em Homologação na Notificações se você usou a mesma URL de produção.
Provavelmente estamos enviando a notificação pra mesma URL de produção sua, e quando sua aplicação consulta o token de notificação de homologação em produção, não é encontrado.

As notificações permitem que você receba informações quando o status de uma transação for alterado, como quando um boleto for Pago ou ficar Inadimplente, por exemplo. Logo, basta cadastrar uma URL de Notificação ao criar uma cobrança. Neste link da documentação fornecemos mais detalhes: https://dev.efipay.com.br/docs/api-cobrancas/notificacoes

Boa tarde, estou criando uma rota na minha api pra gerar boletos utilizando o sdk typescript e o endpoint

Sobre a informação do pagamento, você deve configurar uma URL de notificação, no momento em que envia a requisição de emissão, e a cada alteração no status da cobrança enviaremos uma notificação do tipo POST para esta sua URL configurada

@guilherme_efi estou recebendo o retorno correto na minha url de notificação desta forma: id: {"status": "success", "message":"Webhook succeed"} mas percebi que não tá conseguindo pegar o id da transação pra eu fazer update no status do pix... sabe o que pode ser?

obrigado @guilherme_efi a propósito, sabe porque minha notificação de pagamento está retornando isso, já conferi e não achei nada errado na url de notificação do pix:
3500010
property_does_not_exists
Propriedade: "notification". A propriedade [notification] informada não existe.

Alguém poderia me ajudar sobre uma dúvida das notificações do Pix.

Configurei uma url de notificações com o skip-MTLs ativo seguindo esta estrutura: http://urldosite/notifications.php

Porém quando recebo a resposta, vem somente um requisição em branco, e no webhook inbox chega normalmente a notificação.

Alguém consegue me ajudar com isso?

Boa tarde, @yuri_efi . Preciso alterar as url de notificação de boletos e carnês, mas ao que parece não é possível pelo API. Como faço?