Histórico de mensagens sobre documentação da api em pix

Segui a documentação da api pix

Bom dia, @andrebarbosa_dev.
Segue da documentação técnica sobre o endpoint de consultar o saldo da conta: https://dev.gerencianet.com.br/docs/api-pix-endpoints#buscar-o-saldo-da-conta

Bom dia, @.ubaldini. Tudo ótimo e com você? 😀
Tudo isso é possível sim!

Segue documentação da API de abertura de conta: https://dev.gerencianet.com.br/docs/introducao-api-abertura-contas
E documentação da API Pix onde você encontra os detalhes dos endpoints de criação de cobranças Pix, e também de envio: https://dev.gerencianet.com.br/docs/api-pix-endpoints

Bom dia, galera. Estou com uma dúvida. Estou tentando configurar um webhook na minha máquina local. Executei o ngrok para tornar meu localhost pública e passei o link para o código do meu app (PHP). Porém, quando faço uma requisição PUT (seguindo a documentação da API), fica carregando e retorna "Endpoint request timed out".

Oi, @silva_leandro. Bom dia!
Nesta sessão da documentação você encontra todos os endopoints da API Pix. https://dev.gerencianet.com.br/docs/api-pix-endpoints
Caso surja alguma dúvida, pode contar com a gente!

Olá, pessoal!
Todos bem? Esperamos que sim!

Nós estamos trabalhando em uma nova proposta de layout para a documentação das nossas API's.
A ideia é propor uma nova organização do menu e trazer mais destaque aos endpoints disponíveis, além de facilitar o acesso as requisições e respostas.

🔗 O teste pode ser acessado clicando no link a seguir: https://app.useberry.com/t/GzC65aTTtmK0/

💬 Ao final do teste, vocês podem contribuir com sugestões e melhorias com base na experiência que vocês tem acessando outras documentações,
a contribuição de vocês será muito importante!

Desde já, agradecemos e conte com a gente 🧡

Boa tarde @ronaldo_furriel! Tudo bem? É em segundos e você pode verificar essa informação aqui na documentação, na parte da especificação dos atributos: https://dev.gerencianet.com.br/docs/api-pix-endpoints#criar-cobran%C3%A7a-imediata-sem-txid

Boa tarde.
Sobre a mudança do endPoint para enviar pix em janeiro ....

Já pode mudar agora?
Só chamar o novo método?
Precisa informar ao GN?
Após o envio a confirmação ainda é igual ou teremos que consultar para ver se o status mudou e assim confirmando o envio?

Informamos que a rota POST/v2/pix - para requisitar o envio de Pix - será descontinuada a partir do dia 03/01/2023.

Mas podem ficar tranquilos. A documentação da API Pix foi atualizada com o novo endpoint PUT/v2/gn/pix/:idEnvio e melhorias que deixaram o serviço ainda mais robusto e com melhor performance:

- O endpoint passa a ter um método idempotente.
- A assinatura do endpoint agora permite informar um idEnvio. Esse identificador, único para cada envio, será gerado e controlado por você, evitando duplicidades inconvenientes.

eu uso cloudflare, baixei o certificado dele, fiz a configuração como indica na documentação da API

Olá, @imcbdo. Tudo bem?

Compreendemos os pontos questionados por você. Alguns deles, como a forma de autenticação utilizando o certificado e as liberações de escopos para cada endpoint, são questões de segurança que seguimos de acordo com as definições do Banco Central para padronização das APIs Pix. Por isso são obrigatórias em nossa API.

Se outras APis Pix não solicitam o certificado para autenticação, é porque não seguem o padrão do Bacen.

Mas para ajudar nas integrações, disponibilizamos um fluxograma (https://gnetbr.com/BJxwiSsA4i) para saber quais endpoints devem ser consumidos para gerar a cobrança Pix, obter o QR Code e Pix Copia e Cola. Também oferecemos esse procedimento em nossas SDKs disponíveis em nosso GitHub (https://github.com/gerencianet).

Agradecemos seu feedback, @imcbdo! 😀
Levaremos ao nosso time os pontos questionados por você, para avaliar melhorias, e formas de deixar ainda mais intuitiva nossa documentação e painel da API na conta Digital, ajudando em todo processo para as pessoas desenvolvedoras e clientes.

Você pode receber notificações automaticamente via webhook referente às modificações de status de uma cobrança Pix. Para isso, será necessário a inserção de uma chave pública da Gerencianet em seu servidor para que a comunicação obedeça o padrão mTLS.
Veja mais detalhes em nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-webhooks

Ou seja, primeiramente em um servidor dedicado, você deve inserir uma chave pública da Gerencianet nas configurações de seu servidor para que a comunicação obedeça o padrão mTLS (forma de autenticação mutua).
Veja um exemplo desta configuração em um servidor Apache, Nginx, Node, etc: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-exemplos-de-configura-es-de-servidor

Então com seu servidor configurado com mTLS em seu domínio (ex: https://seudominio.com.br/webhook/" class="link-msg">https://seudominio.com.br/webhook/), você irá consumir a rota PUT /v2​/webhook/:chave uma única vez para registrar seu webhookUrl vinculado à sua chave Pix. Acrescentando uma observação que é a adição do /pix no final da sua URL. Ou seja, na request PUT https://api-pix.gerencianet.com.br/v2/webhook/:chave você irá passar o body com sua URL, exemplo:

Olá, @here!

Informamos que a rota POST/v2/pix - para requisitar o envio de Pix - será descontinuada a partir do dia 03/01/2023.

Mas podem ficar tranquilos. A documentação da API Pix foi atualizada com o novo endpoint PUT/v2/gn/pix/:idEnvio e melhorias que deixaram o serviço ainda mais robusto e com melhor performance:

- O endpoint passa a ter um método idempotente.
- A assinatura do endpoint agora permite informar um idEnvio. Esse identificador, único para cada envio, será gerado e controlado por você, evitando duplicidades inconvenientes.

Ficou com alguma dúvida? O nosso time de especialistas em integração está sempre à disposição para ajudar, todos os dias da semana, aqui, na comunidade Gerencianet.

Contem com a gente. 🧡

Com licença, existe alguma documentação relevante sobre pagamento na documentação da API.

Olá, gostaria de saber se existe alguma documentação da API sobre TED na documentação da API

Eu não vi na documentação da GN limites da API Pix, mas outras APIs da GN citam 15 mil transações por dia:
https://dev.gerencianet.com.br/docs/limites-de-consumo

E isso dá algo como 10 transações por minuto, ou 1 cada 6 segundos. Mas pq vc faria isso ? Pix de recebimento também pode ter webhook, e aí você só precisa de checagens de vez em quando para pegar casos eventuais de não acionamento do webhook.

Oii, @ronaldofood6552. Boa tarde!! 😀
Diga para nós qual linguagem você desenvolve e se já tem um servidor?
Em nossa documentação possuímos alguns exemplos que podem tem ajudar:
https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-exemplos-de-configura-es-de-servidor

Olá pessoal,
Ainda estou com problemas na configuração do webhook/mTLS. Havia tentado inicialmente em nosso servidor VPS mas sem sucesso.
Dessa forma resolvi criar uma mv na aws, com ubuntu 20.4 e apache 2.4. Fiz as configurações conforme a documentação da API PIX.
Ao tentar registrar o webhook pelo postman, recebo esse erro:

{
"nome": "webhook_invalido",
"mensagem": "A requisição na URL informada falhou com o erro: EPROTO"
}

Boa tarde, estou tentando adicionar um webhook a uma chave pix, porem eu não sei como que eu posso enviar o certificado da Gerencianet junto a requisição.

Estou usando o php junto com o apache, o exemplo da documentação me diz que eu tenho que adicionar o caminho do certificado no apache, mas existe outra forma de eu enviar o certificado para validar a requisição?
https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-entendendo-o-padr-o-mtls

Aí que está, não tenho nenhum redirecionamento configurado no VPS, apenas a configuração no apache que é recomendada na documentação da API

Para maior clareza, eu tinha sugerido a alternativa com cada cliente tendo uma conta, usando a <#📒abertura-contas> em que o integrador abre conta para o cliente na GN e já dispõe do clientid/clientsecret/certificado. Mas essa conta provavelmente vai precisar do upgrade que o envio de documentação proporciona antes de solicitar o uso da API de envio de Pix.