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

EXIBINDO CONVERSAS RECENTES:

Texto: documentação da api
Canal: pix
Avatar discord do usuario matheus_efi

matheus_efi

Lembrando o informativo enviado:

Informativo sobre à adequação do /pix no webhook

Foi estabelecido que ao realizar o cadastro do webhook base pelo integrador, ocorrerá 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's e como será a notificação após esta mudança:

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 08/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.

Quaisquer dúvidas referentes a esta transição, estamos a disposição em nossos canais de comunicação.

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

<@!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)

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

<@!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.

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

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

Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

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]

Avatar discord do usuario anoni_mato

anoni_mato

Ver Respostas
Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

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).

Avatar discord do usuario anoni_mato

anoni_mato

dica pra todo mundo lendo aqui: se vc seguir a documentação do BACEN, já estará sempre um passo a frente e não vai depender de avisos da GN quando as coisas mudarem 😉 não contem com nenhuma informação que não for padrão. https://bacen.github.io/pix-api/

Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

Sim, se ele for neste padrão:

{ pix:
[ { endToEndId: 'E18236120524512211356s0848037HBE',
txid: 'fc9a43k6ff39i84ryP5ff4ga9719',
valor: '0.03',
horario: '2020-12-21T13:56:48.000Z' } ] }
No envio de Pix, por ser um endpoint novo e que o próprio BACEN ainda não tem na documentação o retorno será diferente, vai ter o E2EID mas de dados adicionais vai haver o tipo e o status, veja :

{ pix:
[ { endToEndId: 'E09089356202012212057APIe986840e',
valor: '0.01',
horario: '2020-12-21T20:57:52.000Z',
tipo: 'SOLICITACAO',
status: 'REALIZADO' } ] }

Avatar discord do usuario oleoessencial

oleoessencial

Ver Respostas

Avisem antes, precisamos se preparar para isso com antecedencia, e coloquem na documentação a mudança, vou ter que correr a mil por hora agora para mudar as validações em vários locais nos códigos fontes dos sistemas com a api 😦

Avatar discord do usuario kleyber_

kleyber_

openssl pkcs12 -in certificado.p12 -out certificado.pem -nodes <-- Foi este que usei e que está na documentação da API da Gerencianet

Avatar discord do usuario amadeujunior18

amadeujunior18

Ver Respostas

Na versão anterior da documentação tinha um "location": "url", agora esta recebendo alem dele um "loc" : {"location" : "url"}, com o mesmo conteúdo, olhando o exemplo que foi feito em php por parte da consultoria, vi que esta utilizando "loc" : {"location" : "url"}.
Pergunta, vai ser desativado o "location": "url" , em futuras atualizações da api?

Avatar discord do usuario rubenskuhl

rubenskuhl

Ver Respostas

Nessa eu estou meio dividido. Acho que toda documentação que auxilie é bem-vinda, mas em se tratando de dinheiro, não se pode dar a impressão de que a versão resumida é suficiente. As empresas brasileiras são campeãs de reclamações, e muito disso vem de questões de pagamento... então sim acho ótimo se o tipo de documentação que você pediu seja produzido, mas ela não substitui entender todo o processo do PIx e da API Pix.

Avatar discord do usuario oleoessencial

oleoessencial

Para quem for ou vai utilizar o endpoint do webhook em produção do PUT da url de retorno, na documentação tem esta url https://api-pix-h.gerencianet.com.br/v2/webhook/:chave
Porém, para funcionar precisamos retirar os dois pontos antes da palavra" :chave" e claro a própria palavra "chave" ficando assim = https://api-pix.gerencianet.com.br/v2/webhook/---- no caso este é um exemplo com uma chave aleatoria, as demais chaves utlizem o que o manual recomenda 🙂 Substituir o por seus dados.

Avatar discord do usuario leaftecnologia

leaftecnologia

Ver Respostas

boa noite! alguém sabe se a api da gn suporta cobrança com vencimento? não vi na documentação da api

Avatar discord do usuario Deleted User

Deleted User

Ver Respostas

@Efí Na documentação do Postman vocês também poderiam salvar alguns exemplos de retorno. Seria interessante para quem ainda vai começar a consumir a API

Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

A utilização do mTLS é um requisito obrigatório do Banco Central e todos os PSP devem atender a ele. Você consegue chegar essa informação na própria documentação do Banco Central. Segue um trecho da mesma "O PSP deve implementar o framework OAuth 2.0 (RFC 6749)63 com TLS mútuo (mTLS – RFC
870564) para autenticação na API"

Avatar discord do usuario marcosnicolau3509

marcosnicolau3509

Ver Respostas

> Boa noite pessoal! Colocamos alguns exemplos de autenticação na documentação
Pessoal, os exemplos de autenticação inseridas na documentação foram em PHP, Javascript, Python e C#. A documentação é acessível através de https://dev.gerencianet.com.br/docs/api-pix#section-exemplos-de-autentica-o-em-algumas-linguagens-

Também subimos a Gerencianet API Pix - Postman Collection para o https://documenter.getpostman.com/view/13574984/TVetcm6R, como o Matheus mencionou. Podem acompanhar esse link, pois sempre manteremos a Collection atualizada.

Avatar discord do usuario sady_efi

sady_efi

> Boa tarde! Gostaria de saber se tem como se testar os Webhooks dentro do sandbox de testes da Gerencianet.
>
> Na documentação da API se fala como eu posso testar endpoints da gerencianet, mas não mostra como eu posso gerar uma notificação falsa, de testes, para um webhook de testes.
<@!693592686338244609> Vou confirmar os detalhes aqui e já te passo essa informação

Avatar discord do usuario m_feinstein

m_feinstein

Boa tarde! Gostaria de saber se tem como se testar os Webhooks dentro do sandbox de testes da Gerencianet.

Na documentação da API se fala como eu posso testar endpoints da gerencianet, mas não mostra como eu posso gerar uma notificação falsa, de testes, para um webhook de testes.