Termos mais procurados:
Notar que a Gerencianet não diz que o mTLS não é necessário, e sim que o integrador pode ter outras formas de implementá-lo em camada de aplicação e aí garantir o mesmo nível de segurança. Então quem não estiver validando se o cliente é mesmo a Gerencianet, está em violação da documentação do Pix.
boa tarde pessoal, quando tento converter o cert p12 para pem é pedido uma senha, não vi info disso na documentação, podem me ajudar?
<@!795609033024339969> Está em nosso backlog sim para ser desenvolvido. No entanto, ainda não temos uma previsão de seu lançamento.
Fique de olho em nossos canais de comunicação, e nosso GitHub.
Você pode desenvolver também, que lhe auxiliamos nos processos e dúvidas.
Em nossa documentação(https://dev.gerencianet.com.br/docs) você encontra os nossos endpoints com explicações detalhadas, você pode verificar também a Collection da Gerencianet com todos os endpoints já configurados para o consumo (https://dev.gerencianet.com.br/docs#section-collection-postman-gerencianet-api-pix)
Parece ok, conforme documentação mesmo. Eu não testei isso em desenvolvimento/homologação. Tinha visto que os webhooks/callbacks só funcionam em produção. Alguém confirma? <@!775350441965649951> <@!652136709982781470>
Bom dia, estou desenvolvendo a integração com o webhook da api pix, seguindo a documentação fiz a configuração do NGINX com o certificado de desenvolvimento, entretanto ao configurar o webhook pela api, está retornando o seguinte erro:
<@!671762828046106646> um webhook do PIX pode vir sem o parâmetro status ?? Reformulando: como no exemplo 2 da documentação? Qual seria a diferença de quando vem o status (exemplo 1) e sem status (exemplo 2)?
Boa tarde! Vi que a documentação do bcb relacionado ao pix criou uma especificação para a estrutura json dos erros retornados. O gn vai atualizar a api para adequação para esse padrão ou os erros vão permanecer no formato atual?
Pessoal, trazendo mais novidades pra vocês, adicionamos em nosso <#🖥changelog> a descrição sobre os dois novos endpoints que disponibilizamos, Gerar cobrança sem txid e Gerar QRCode de um location.
Em nossa documentação vocês encontram a descrição sobre cada um deles. Nossa collection também ja esta atualizada e você podem encontrá-la acessando o link https://documenter.getpostman.com/view/13574984/TVzVgvBA
Augusto aqui na documentação (https://dev.gerencianet.com.br/docs) você consegue mais detalhes dos endpoints e de como utiliza-los. Temos a collection no Postman que pode te auxiliar nos testes. Qualquer dúvida estamos a disposição.
<@!704694550631022592> Bom dia!
Não se preocupe, este canal é mesmo para tirar suas dúvidas! 😉
Primeiramente, para quaisquer consumo dos endpoints do Pix, é necessário realizar uma autenticação com suas credenciais client_id, client_secret e certificado. Para isso, seu primeiro consumo será na rota POST /oauth/token. Segue exemplos em algumas linguagens: https://dev.gerencianet.com.br/docs/api-pix#section-exemplos-de-autentica-o-utilizando-o-certificado-p12
Após a autenticação, você utilizará o endpoint para criar uma cobrança PUT /v2/cob/{txid}. Documentação: https://dev.gerencianet.com.br/docs/api-pix#section-criar-cobran-a-
Para acompanhar as mudanças de status de um pix, você pode configurar um webhook, que reúne endpoints para gerenciamento destas notificações. https://dev.gerencianet.com.br/docs/api-pix#section-webhook
Utilize também nossa Collection da Gerencianet com todos os endpoints já configurados para o consumo (https://dev.gerencianet.com.br/docs#section-collection-postman-gerencianet-api-pix).
A respeito do seu certificado, logo lhe retornaremos através do ticket.
- qual app?
- inválido em que sentido? do ponto de vista do regex previsto pela documentação ( ^[a-zA-Z0-9]{1,25}$ )?
Para utilizarem a API PIX Gerencianet, precisará de um certificado gerado por nós.
Para isso acesse nosso site em sua conta, no menu API > Minhas aplicações você criará uma aplicação que são gerados 2 pares de chaves Client_Id e Client_Secret, sendo um par para utilização em ambiente de Produção e outro para Homologação.
Então abra um ticket acessando https://sistema.gerencianet.com.br/tickets/criar, e solicite o certificado para integração nos informando:
-Número da sua conta:
-Nome da aplicação criada:
-Ambiente: Produção/Homologação
Em nossa documentação(https://dev.gerencianet.com.br/docs) você encontra os nossos endpoints com explicações detalhadas, você pode verificar também a Collection da Gerencianet com todos os endpoints já configurados para o consumo (https://dev.gerencianet.com.br/docs#section-collection-postman-gerencianet-api-pix).
Para você que iniciará com PHP, possuímos uma SDK com os principais endpoints para a utilização do Pix, disponível em nosso GitHub. https://github.com/gerencianet/gn-pix-sdk-php-exemplo
Eu estava observando aqui: a nova documentação de UX do Pix (v3.0) agora determina que é obrigatório as notificações de recebimento Pix (push, sms, email) conterem a descrição digitada pelo pagador e também o txid, quando houver. WOW!
Boa tarde @everyone, sobre à adequação do /pix no webhook, ficou definido que será feito o cadastro do webhook base pelo integrador e a adição do parâmetro /pix no POST {$request.body#/webhookUrl} pela Gerencianet no momento do disparo das requisições.
Abaixo trazemos alguns exemplos de webhook e como será a notificação:
Integrador cadastrou a url base https://gerencianet.com.br/, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/pix.
Integrador cadastrou a url base https://gerencianet.com.br/pix, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/pix/pix.
Integrador cadastrou a url base https://gerencianet.com.br/?id=0000x22, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/?id=0000x22/pix.
Seguindo então a nossa documentação o serviço será POST {$request.body#/webhookUrl}/pix.
Tal definição foi feita após analisar os feedbacks de integradores, questionamentos ao BACEN e discussões internas.
A data para deploy do novo padrão está alinhada para o dia 01/02/2021. Sendo esta arbitrada a fim de que todos os integradores da API-Pix que utilizam o serviço de webhook possam ajustar seus sistemas e aplicações, e evitar assim falhas ou mal funcionamento do serviço.
Uma sugestão é permitir o recebimento da notificação em ambos os modos: com e sem /pix. Dessa forma, quando virarmos a chave, não haverá problemas.
À medida que se aproximar da data de deploy seremos mais assíduos nas notificações. Quaisquer dúvidas estamos a disposição em nossos canais de comunicação. [ATUALIZADO]
pela documentação do BACEN, bastaria vc cadastrar uma query string vazia no fim, como .../algumarquivo.php?pix= e o request chegaria em .../algumarquivo.php?pix=/pix (aí é só ignorar essa query string que vai chegar como $_GET['pix'] e valor /pix no seu script). mas pelo que o <@!671762828046106646> disse, parece que a GN (que hoje não segue a documentação e tá em busca de se adequar) tá planejando implantar de outro jeito (e o planejado ainda tá fora do padrão.. mas disseram que consultaram o BACEN, então boiei geral), aí só vc tendo controle total sobre os locations e configurando uma rota pra apontar pro seu algumarquivo.php específico...
Não entendi esta:
Integrador cadastrou a url base https://gerencianet.com.br/?id=0000x22, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/pix?id=0000x22
A possibilidade mais simples de contornar a concatenação do /pix que a documentação força é justamente colocar um ?x= ao fim da URL para ficar ?x=/pix.
então pergunto:
1. qual a razão para agregar o /pix "no meio" da URL que foi definida pelo integrador e não no fim?
2. isso vai contra a documentação atual que diz que o /pix irá (sempre) no fim da URL - e se for pra mudar o conceito, seria melhor que esse /pix fosse retirado.
e sugiro aos integradores que estão lendo agora: não usem query params na URL do webhook conforme esse exemplo (prefiram path params)
<@!798679248633856000>
documentação de como montar o qrcode:
https://www.bcb.gov.br/content/estabilidadefinanceira/spb_docs/ManualBRCode.pdf
https://www.bcb.gov.br/content/estabilidadefinanceira/pix/Regulamento_Pix/II-ManualdePadroesparaIniciacaodoPix.pdf
ferramentas:
https://pix.ae (API: é só enviar um "POST" para o domínio pra ver como funciona)
https://gerarqrcodepix.com.br (API: https://github.com/ceciliadeveza/gerarqrcodepix)
https://pix.nascent.com.br/tools/pix-qr-decoder/
no sdk Pix da GN para PHP também tem uma função que monta, caso esteja desenvolvendo nessa linguagem
https://github.com/gerencianet/gn-pix-sdk-php-exemplo
além de outras bibliotecas com a mesma finalidade
https://github.com/william-costa/wdev-qrcode-pix-php
https://github.com/levicosta201/gerencianet-pix-api
https://github.com/leonardomdr/gn-pix-api
galera desculpa pela pergunta simples, mas nao consegui achar uma resposta na documentação. Quando eu crio uma cobrança eu recebo uma url qrcodes-pix.gerencianet.com.br/v2/840c87cd1... e quando acesso ela é feito o download de um arquivo, qual o procedimento para gerar o qr code? Imagino que devo ter que gerar isso do meu lado
Bom dia!
<@!798679248633856000> Para utilizar a API PIX precisa de um certificado gerado por nós.
Em nosso painel web, no caminho API > Minhas aplicações você criará uma aplicação que são gerados 2 pares de chaves Client_Id e Client_Secret, sendo um par para utilização em ambiente de Produção e outro para Homologação.
Abra um ticket acessando https://sistema.gerencianet.com.br/tickets/criar, e solicite o certificado para integração informando número da sua conta e nome da aplicação que criou.
Em nossa documentação(https://dev.gerencianet.com.br/docs) você encontra os nossos endpoints com explicações detalhadas, você pode verificar também a Collection da Gerencianet com todos os endpoints já configurados para o consumo (https://dev.gerencianet.com.br/docs#section-collection-postman-gerencianet-api-pix).
