Termos mais procurados:
Sim, o webhook é melhor, porém não é muito elegante fazer if() para saber se é uma devolução, se é um pagamento, se é um envio de pix. Eu mesmo ainda não finalizei essa parte por conta desse retorno que não retorna tipo nem status....os GET's seriam uma melhor solução para mim. Mas preciso usar os webhooks.
joia, tentarei
o de produção continua o https://pix.gerencianet.com.br/webhooks/chain-pix-prod.crt ?
Segue todos os escopos da API PIx:
Alterar Cobrança = cob.write
Consultar Cobrança = cob.read
Alterar Cobrança com Vencimento = cobv.write
Consultar Cobrança com Vencimento = cobv.read
Alterar Payload = payloadlocation.write
Consultar Payload = payloadlocation.read
Alterar Pix = pix.write
Consultar Pix = pix.read
Alterar Webhook = webhook.write
Consultar Webhook = webhook.read
Consultar Saldo da Conta = gn.balance.read
Alterar Chave Aleatória = gn.pix.evp.write
Consultar Chave Aleatória = gn.pix.evp.read
Alterar Configurações da API = gn.settings.write
Consultar Configurações da API = gn.settings.read
Solicitar relatórios = gn.reports.write
Consultar relatórios = gn.reports.read
A API de emissões é ativada por padrão, então neste caso, você não precisa de passar nenhuma informação para que o cliente emita cobranças cartão, boletos, carnês...
Em relação ao Boleto sem Pix = O cliente tem que deixar desativado o Bolix dentro da conta Digital
Boa tarde
Este endpoint
/cadastro/conta-simplificada/:identificador/credenciais
Retorna as informações para produção, correto ?
Tem os escopos integrados
Enum:
cob.write, payloadlocation.write, payloadlocation.read,
cob.read, pix.write, pix.read, pix.send, webhook.write, webhook.read,
gn.pix.send.read, gn.balance.read, gn.pix.evp.write, gn.pix.evp.read, gn.settings.write,
gn.settings.read, gn.barcode.read, gn.barcode.pay.write,gn.barcode.pay.read
Aonde vejo o significado de cada um ?
Posso alterar após o cadastro ?
Boa tarde pessoal, alguém conseguiu usar o nginx para validar o certificado do cliente da efí no webhook?
eu configurei e testei com outro certificado de cliente e deu tudo certo mas com o da efi da falha
eu obtive o mesmo erro no outro certificado quando não tinha todas as cadeias presentes no arquivo, mas assim que adicionei funcionou, sabem se esse da efí está faltando mais cadeias intermediarias ou a root?
Eu sei que o nginx não consegue validar caso esteja faltando alguma cadeia.
erro informado pelo nginx: FAILED:unable to verify the first certificate
crt usado da efí: https://pix.gerencianet.com.br/webhooks/chain-pix-sandbox.crt
Bom dia, @israelcosta.
Acredito então, como não vai configurar no Apache ou Nginx o mTLS, você deverá registrar sua webhook URL com o atributo x-skip-mtls-checking=true
Veja mais detalhes e pontos de atenção em nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#skip-mtls
Segundo ponto, os callbacks são enviados pela Efí via POST /pix quando há uma alteração no status do Pix. Então nestas rotas você deve esperar Route:post.
Por último, adicione também a rota POST '/webhook', pois é feito uma requisição de teste nela também.
Quem já trabalhou com Laravel sabe dizer se funciona dessa maneira ao invés de suar Alias?
use Illuminate\Http\RedirectResponse;
// Redireciona /webhook/pix/ para /webhook
Route::get('/webhook/pix/', function () {
return new RedirectResponse('/webhook');
});
// Redireciona /webhook/pix para /webhook
Route::get('/webhook/pix', function () {
return new RedirectResponse('/webhook');
});
No meu caso estou utilizando Laravel
SSLVerifyClient require
SSLVerifyDepth 3
# Tratando o /pix, redirecionando as requisições sempre para /webhook
Alias "/webhook/pix/" "/var/www/webhook/index.php"
Alias "/webhook/pix" "/var/www/webhook/index.php"
Poderia me explicar essa linha?
# Tratando o /pix, redirecionando as requisições sempre para /webhook
Alias "/pix/" "/var/www/webhook/index.php"
Alias "/pix" "/var/www/webhook/index.php"
No test que fiz aqui em sendbox (hom), quando o webhook chamou minha API ela não veio no payload o sendId que eu gerei para fazer o sendPix.
Payload que recebi:
Este webhook eu posso cadastrar uma única vez, certo ? não precisa "recadastrar" toda vez que um pix for enviado né ?
Só uma dúvida,
Eu já estou utilizando o endpoint de PUT /v2/cob/:txid (createCharge) com o webhook cadastrado com a chave da minha empresa.
Agora quando eu faço o envio do pix PUT/v2/gn/pix/:idEnvio (pixSend) tenho que cadastrar outro webhook com chave pix do favorecido (chave de quem vai receber o pix) ?
Agora você precisa colocar a tratativa para receber as notificações na rota /webhook/pix
Exato. Essa é uma definição do banco central, que ao enviar a notificação deve ser adicionado o /pix no final da sua URL registrada.
Ou seja, na request PUT https://api-pix.gerencianet.com.br/v2/webhook/:chave você irá passar o body com sua URL, exemplo:
Bom dia @lyrax_dev, tudo bem?
Em seu caso será necessário implementar um webhook juntamente ao seu bot para que ele seja notificado de todas transações referentes à chave Pix utilizada para realizar essas emissões. Para que seu código consiga atrelar o pagamento ao pedido recomendo que utilize o txid.
Para que possamos lhe auxiliar da melhor forma possível pedimos que dê mais detalhes quanto à dificuldade que está enfrentando no processo de integração.
Caso deseje você pode criar um # atendimento para um atendimento privado.
Boa tarde, na notificação que a APi retorna para o WebHook vem somente esses atributos:
{
"pix": [
{
"endToEndId": "E18236120202306111751s061d2234ff",
"txid": "11fd8cebbe7648f29119b8bdb79792e3",
"chave": "2b14b01e-e585-48ff-86ac-3b63b540850c",
"valor": "0.01",
"horario": "2023-06-11T17:51:18.000Z"
}
]
}
Ou tem mais atributos opcionais?
Bom dia, @higris!
Você pode criar um certificado com Certbot (https://certbot.eff.org/instructions) para preencher os campos referentes ao certificado do domínio.
Já o certificado público da Efí, você pode baixar diretamente através dos links abaixo:
Produção: https://pix.gerencianet.com.br/webhooks/chain-pix-prod.crt
Homologação: https://pix.gerencianet.com.br/webhooks/chain-pix-sandbox.crt
Você os encontra também em nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#exemplos-de-configura%C3%A7%C3%B5es-de-servidor
Boa tarde time. Eu estou implementando o webhook para PIX e estou com certas dificuldades de entender / implementar elas. Estou seguindo o github do gn-node.js.
Nessa função que criei, basicamente copia e cola do github. Ao tentar rodar a mesma, eu recebo o seguinte erro :
{
chave: 'format',
caminho: '.body.webhookUrl',
mensagem: 'a validação do formato falhou "url"'
}
Não sei se o fato de eu estar usando localhost para a webhookurl está ocasionando isso, mas por enquanto minha aplicação só funciona em localhost, então gostaria de idéia ou feedback de voces, mais experts kk, estou começando a jornada por agora.
Se veem que precisa de mais algum dado pra checar, só pedir que eu envio !
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
Existem duas maneiras de você verificar se uma cobrança foi paga.
A primeira seria cadastrando uma URL para receber notificações: https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks
A outra seria você consultar sobre a cobrança em nosso endpoint: https://dev.gerencianet.com.br/docs/api-pix-endpoints#consultar-cobran%C3%A7a
