Histórico de mensagens sobre webhook

é prq passo minha chave pix com a url no corpo e recebe: 400 Bad Request: "{"nome":"webhook_nao_encontrado","mensagem":"Nenhum webhook encontrado para a chave informada"

Bom dia! Na documentação https://dev.efipay.com.br/docs/api-pix/webhooks não encontre o endpoint pra criar o webhook. apenas configurar, cancelar etc...

Boa noite!!!
Estou tentando gerar uma assinatora por link e está retornando o erro 3500000: Erro interno no servidor.
No dia 08/09/2023, estava rodando o mesmo código e fucionava perfeitamente.
Rota: /plan/11119/subscription/one-step/link [POST]
Sandbox: true
Dados de entrada:
{
"items": [
{
"name": "Assinatura - Mensal",
"value": 1300,
"amount": 1
}
],
"metadata": {
"custom_id": "5",
"notification_url": "http://api.webhookinbox.com/i/U1qO3tMZ/in/"
},
"settings": {
"payment_method": "all",
"expire_at": "2023-09-16",
"request_delivery_address": false
}
}

Dados de saída
{
"code": 3500000,
"error": "server_error",
"error_description": "Erro interno do servidor."
}

/loc/id não retorna status. Você pode saber se foi pago com GET em /cob, GET em /pix e webhook, mas em homologação só o webhook.

Booa tarde, @dinaelmiranda! Tudo bem?
Consegue sim, mas neste caso você vai precisar de desativar a validação mtls no momento do cadastro do webhook.

Consigo testar o webhook do pix sem configurar um servidor, apenas com as ferramentas de teste (WebHookTeste, WebHookInbox etc...) ?

A conselho a pesquisar sobre webhook, assim você é notificado quando houver a confirmação do pagamento e não precisaria fazer 10 solicitações para ver se o pagemento foi feito

Não. Ao emitir uma cobrança, você precisa informar um chave, então a confirmação de pagamento desta cobrança vai ser enviada para o webhook vinculado a chave informada.
Como a devolução esta associada a uma cobrança, que por sua vez esta associada a uma chave, o webhook de devolução vai ser enviada para a mesma url.

Boa tarde, @alessandrodev! Tudo bem?
Não, neste caso, como o cadastro do webhook é por chave, toda a movimentação (envvio, recebimento e devolução) relacionada a esta chave, vai ser enviada para o webhook cadastrado.
O conteudo de cada tipo de notificação é diferente: https://dev.efipay.com.br/docs/api-pix/webhooks#requisi%C3%A7%C3%A3o

Mas o ponto é que todos são enviados para a mesma rota webhook/pix consigo cadastrar uma rota especifica para cada um? algo tipo webhook/pix/devolucoes ou webhook/pix?type=devolucoes para justamente não receber todas as variancias em um mesmo endpoint?

Bom dia, @alessandrodev! A estratégia adotada depende muito das suas regras de negócio, por exemplo, você pode ter um webhook exclusivo para tratar recebimentos e outro exclusivo para tratar envios, se você utilizar o Split ainda pode ter um exclusivo para ele.

Caso prefira organizar todos em um único ponto, você teria o payload padrão de recebimento (endToEndId, txid, chave, valor, horario e infoPagador).

Se for um recebimento com split você terá tudo isso acrescido do gnExtras contendo pagador e split.

Para devolução é preciso que o recebimento já tenha existido, você pode adotar uma conferência interna do txid ou verificar a existência da propriedade devolucoes.

Já o envio de Pix terá as propriedades tipo e status e não terá o txid (virá em gnExtras o identificador do envio -> idEnvio).

Mais informações sobre o recebimento de callbacks na documentação: https://dev.efipay.com.br/docs/api-pix/webhooks/#recebendo-callbacks

Eles acionam webhook, como descrito na documentação.

Eu preciso executar uma logica de negócio apenas quando o pix for "CONFIRMADO" e eu não quero fazer gambiarra validando se existe o atributo "devolucoes" , "gnExtras" e etc para simplesmente saber se a chamada do webhook refere-se ao pix recebido

Galera, qual estratégia vocês adotaram no endpoint webhook/pix para identificar a etapa/categoria refere-se a request?

Por exemplo eu vou ter nessa mesma rota diferentes payload (dados no body), para estorno, criação, pagamento confirmado e pelo que vi na doc não existe um atributo comum para todos os dados que identificam a etapa do processo, ao meu ver deveria ter um atributo { etapa: "DEVELOCAO" | "PIX_RECEBIDO" | "PIX_ENVIADO" } para facilitar a identificação no webhook.

Não lembro a partir de quando a Efí anunciou a nova CA... mas se você já tinha webhook cadastrado com a antiga, vale a antiga.

Para a API de emissões, talvez o glitch.com fosse uma plataforma interessante para o webhook. Eu fiz no glitch.com um webhook para WhatsApp que está rodando bem legal. Só não acho que tenha como colocar API Pix por causa do mTLS, mas como você perguntou no canal de cartões, imagino que seja esse o foco.

Olá amigos, como fazer para usar o webhook para pagamentos com Link externo do gerencianet ?

Não @elicast5242 . Para o boleto e cartão você pode usar essa mesmo esquema do token, mas para o Pix funciona de uma forma diferente. Recomendo que você faça a leitura de nossa documentação para entender essa diferença: https://dev.efipay.com.br/docs/api-pix/webhooks . Se ficar com alguma dúvida pode enviar aqui no chat, precisando eu descrevo algum exemplo mais prático de como funciona no Pix, para você

NestJS sempre aparece aqui no canal como exemplo de que não conseguiram configurar CA privada para o webhook... entao algo intermediário para mTLS será necessário. Seja o API Gateway da AWS, o equivalente dele na Oracle Cloud ou o mtls.pix.ae.