Termos mais procurados:
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
Fala pessoal, Boa noite.
Gostaria de retirar uma duvida referente ao SSL que precisa ser configurado para o Webhook.
Atualmente estou criando um aplicativo em flutter e utilizando o Functions (firebase) para realizar algumas chamadas de API, e é onde estou configurando os endpoints necessários para o pix funcionar corretamente.
E eu gostaria de saber como posso obter esse SSL sem a necessidade de precisar contratar mais um serviço para realizar a hospedam de uma api.
Esses campos de SSL são estritamente necessários ?
const httpsOptions = {
cert: fs.readFileSync(""), // Certificado fullchain do dominio
key: fs.readFileSync("/"), // Chave privada do domínio
ca: fs.readFileSync(""), // Certificado público da Gerencianet
minVersion: "TLSv1.2",
requestCert: true,
rejectUnauthorized: false, //Mantenha como false para que os demais endpoints da API não rejeitem requisições sem MTLS
};
Bom dia, @accessoft! Como vai?
Nossa sugestão é a mesma que o Rubens mencionou.
Para habilitar o endpoint de envio de Pix em produção, é necessário preencher este formulário (https://sejaefi.link/rkgAjSstbn). Após o preenchimento, basta aguardar que nossa equipe entrará em contato.
Caso você queira testar o endpoint de envio de Pix em ambiente de homologação, é possível simular todos os status retornados pela nossa API e webhook.
Se o valor do Pix está entre R$ 0.01 à R$ 10.00:
- Pix é confirmado, informação virá via Webhook.
Se o valor do Pix está entre R$ 10.01 à R$ 20.00:
- Pix é rejeitado, informação virá via Webhook.
Se o valor do Pix é acima de R$ 20.00:
- Pix é rejeitado já na requisição, informação não virá via Webhook.
Exemplo:
curl --cert-type P12 --cert seu_certificado.p12 --location --request PUT 'https://api-pix.gerencianet.com.br/v2/webhook/sua_chave_pix' \
--header 'x-skip-mtls-checking: true' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer seu_token' \
--data '{
"webhookUrl": "https://seu_endereco.com.br/webhook"
}'
O webhook é configurado por chave Pix, e acionado para qualquer pagamento que tenha um txid ou evolução da situação de devolução caso você solicite devolução.
O que você pode configurar é a conta para não aceitar transações que não pagamentos... por exemplo, recusar Pix por dados bancários e Pix por chave. (
/v2/gn/config)
O webhook é acionado sempre quando há alguma alteração na cobrança Pix. Então você recebe a notificação quando for paga, e se tiver devolução.
Então ao receber a notificação com os detalhes em Json, sua aplicação poderá tratar estes dados.
https://dev.gerencianet.com.br/docs/api-pix-endpoints#recebendo-callbacks
Bom dia, @leonardo.amaral! Como vai?
Você consegui sim fazer testes em homologação, mas para isso você irá precisar da sua conta para obter as credenciais Cliente_Id, Client_Secret e certioficado para autenticação.
O processo será basicamente o seguinte:
1 Criar cobrança em homologação (https://dev.gerencianet.com.br/docs/api-pix-endpoints#criar-cobran%C3%A7a-imediata-com-txid)
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
2 para obter o Pix copia e cola, você pode fazer como o Rubens mencionou, usar uma biblioteca que monta o BRCode, ou usar um endpoit que já entregarmos pronto, junto com a imagem e um link de pagamento também. (https://dev.gerencianet.com.br/docs/api-pix-endpoints#gerar-qrcode-de-um-location)
Para facilitar ainda mais esse processo de integração, você ainda pode usar uma de nossas SDKs (https://github.com/gerencianet).
Não precisa do iniciador do OpenFinance, o copia e cola é parte da iniciação padrão do Pix.
Dá para fazer testes parciais no ambiente de homologação. Você cria uma cobrança e dependendo do valor o webhook é acionado. Mas no ambiente de homologação não aparece um Pix para quitar a cobrança.
Boa noite pessoal para a utilização dos webhooks de pix é preciso ter, obrigatoriamente, todos esses certificados/chave no servidor? Ou somente o Certificado público da Gerencianet?
Sim, recebe um webhook do OF. Mas ele não é um txid de Pix, é um id do OF. Se o cliente seguir o caminho certo tudo funciona... o problema é quando o cliente sai do script por conta própria.
pra eu conseguir fazer um webhook para quando receber um pix, eu realmente preciso de um certificado ssl? não tem como fazer isso sem um?
Boa tarde, @eeerrrttt8201! Tudo bem?
Sim, é possível enviar um ID na criação do pagamento e recebê-lo posteriormente no webhook. Em nossa documentação você pode encontrar a tabela de atributos completa que possuí a descrição desse atributo: https://dev.gerencianet.com.br/docs/endpoints-api-open-finance#solicitar-inicia%C3%A7%C3%A3o-de-pix-via-open-finance
E o objeto pix que vem no webhook e no GET de /pix passa a vir também no /cob, e lá tem horário...
Bom dia @tolribeiro ! Quando você cria uma cobrança, ela te retorna essa informação do calendário. A partir do momento que foi paga, que você possui um e2eid, é retornado o horário em que foi pago. Essa informação é enviada no webhook. Veja um exemplo de um webhook enviado para Pix recebido:
@here
Boa noite pessoal, na api do pix atualmente existe alguma forma de eu buscar um envio de pix pelo idEnvio?
Eu sei que existe essa rota aqui /v2/gn/pix/enviados/:e2eId, mas eu vejo um ponto de falha nela que seria resolvido por uma rota semelhante /v2/gn/pix/enviados/:idEnvio
Ou então permitir filtrar pelo idEnvio na rota /v2/gn/pix/enviados/, serviria também.
O ponto de falha que me refiro é o seguinte: Eu preciso primeiro chamar a rota para requisitar o envio de pix para então obter o end2endId e salvar ele na minha base de dados, no entanto, se no momento de salvar o end2endId na minha base ocorre algum erro eu me encontro na situação onde envie um pix, mas não consigo recuperar essa informação posteriormente, pois não tenho o end2endId.
É claro que ainda existe a camada do webhook (que retorna o idEnvio) e me permite atualizar no meu banco se o pix foi enviado com sucesso ou não. No entanto o webhook também é suscetível a falha.
Para conseguir cobrir todos os pontos de falha bastaria a rota de consulta do pix enviado pelo idEnvio, tendo em vista que esse identificador sou eu quem gero, faz até mais sentido.
Agradeço desde já a paciência da pessoal que ler até o final e me ajudar. Por favor, se eu estiver enganado em algum ponto me corrija, eu gostaria de estar errado e não precisar dessa rota kkkkk
Detalhe que você precisa aceitar requisições em exemplo.com.br/webhook e exemplo.com.br/webhook/pix, mas a informação de URL para configuração é exemplo.com.br/webhook
Se você configurou exemplo.com.br/webhook, o callback vai ser para exemplo.com.br/webhook/pix . Esse atendendor também está disponível ?
boa tarde estou cadastrando o webhook com o hmac exemplo https://seu_dominio.com.br/webhook/?hmac=xyz
mas os restorno que obetenho é POST /webhook/?hmac=xyz que esta ok eo segundo é POST /webhook/?hmac=xyz/pix sendo que era para retornar POST /webhook/pix/?hmac=xyz não?
