Lendo a documentação referente a notificações, me surgiu alguns dúvidas, tenho que disponibilizar um acesso, uma api para gerencianet acessar e devolver as informações do meu boleto? é isso ?
Termos mais procurados:
Histórico de mensagens sobre documentação da api
PROCURE NO HISTÓRICO
CANAIS DE TEXTO
DISCUSSÕES
- Conceito de Payload Locations no PIX
- Inserção automática do formato do Pix copia e cola pelo WhatsApp
- Autenticação com Certificado em NextJS
- Consulta de Chave PIX na API de Envio
- Acionamento de Webhooks em Pagamentos e Devoluções
- Implementação da SDK do Pix em Next.js ou React
- Cobrança em Período de Teste Grátis de 7 dias
- Configuração de URLs para Recebimento de Status
- Especificação da URL do Webhook no Exemplo Pix
- Recebimento de Pagamentos via QR Code e Arduino
- Repetição do Processo de Criação com txid
- Implementação do Módulo Gerencianet no Perfex CRM
- Tempo Médio de Análise de Documentos na Abertura de Conta
- Integrações com o Laravel e SDK de PHP da EFI
- Teste de Status de Pagamento em Ambiente de Homologação
- Problemas com Token em Ambiente de Homologação
- Funcionamento do Webhook em Ambiente de Homologação
- Resolução de Delay nas Chamadas de Geração de QR Code e Pix em Node
- Geração de Link de Pagamento e Reembolso
- Retenção de Pagamento no PIX em Marketplace
- Cancelamento de Boleto e Remoção do DDA
- Notificações de Pagamento de Boleto e Pix
- Utilização de Endpoints e Payload no Pix
- Integração de Pix no Bubble (Plataforma No-Code)
- Interpretação do Campo 'Solicitação ao Pagador' no Webhook GN
EXIBINDO CONVERSAS RECENTES:
Texto: documentação da api
Bom dia <@!554036509758455809>... em nossa documentação na seção de endpoint, você encontra a descrição de cada endpoint, qual a funcionalidade deles. Acesse o link https://dev.gerencianet.com.br/docs/api-pix-glossario, que tem como objetivo, alinhar a compreensão de termos relacionados à API Pix.
pessoal por favor à qq um.. estou totalmente perdido nessa documentação da API Pix... tem em algum lugar algum passo a passo mesmo? tipo tenho varias duvidas, diferença entre criar uma Charge e um envio de pix de fato, oque são locations, eu preciso validar o certificado sempre antes de requisitar algum endpoint? onde encontro um código funcional msm?? o do github n tbm n consegui seguir, muito disperso pra mim 😦 valeu!!!! sei que teve outros com essa dificuldade, espero q sim kk valeu!!!
Olá, <@!497618632541601797>. Bom dia! Como vai? 😄
Em nossa documentação possuímos um exemplo bem simples de como realizar a autenticação com PHP na API Pix: https://dev.gerencianet.com.br/docs/api-pix-autenticacao-e-seguranca#section-exemplos-de-autoriza-o-utilizando-o-certificado-p12
Mas melhor que isso, possuímos uma SDK em PHP completa, preparada para gerar a cobrança Pix com o Pix Copia e Cola e QR Code, boleto bancário, cartão de crédito e muito mais: https://github.com/gerencianet/gn-api-sdk-php
E corrigindo essa minha mensagem: eu não sou muito familiarizado com Node, mas parece que tem como, sim, validar o certificado da GN usando Node, de acordo com a documentação da GN no link abaixo (tem uma aba "Node" com código de exemplo). Mas não sei se isso é possível num ambiente controlado por terceiros como a Heroku. Em todo caso, o mtls.pix.ae permanecerá sempre gratuito. Boas almas como o <@!535222756837556244> ajudam a financiar 💟
https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-exemplos-de-configura-es-de-servidor
Oi <@!573337312436682752> tudo bem? 😄
Infelizmente, no momento, ainda não temos um exemplo utilizando Laravel!
Na nossa documentação você encontra mais detalhes sobre o funcionamento da nossa API: https://dev.gerencianet.com.br/docs
Temos também no nosso github, uma sdk em php que pode te ajudar no desenvolvimento: https://github.com/gerencianet/gn-api-sdk-php
No json que contém as credenciais você informa apenas o caminho do certificado!
Vale lembrar também, que em PHP deve-se utilizar o certificado em formado .pem! Os passos para converter seu certificado, você encontra no link: https://dev.gerencianet.com.br/docs/api-pix-autenticacao-e-seguranca#section-convers-o-de-certificado-p12-para-o-formato-pem
Oi <@!850502535859929110> tudo bem? 😄
Para realizar a integração com os serviços da Gerencianet, se você ainda não tem uma conta, faça seu cadastro, ele será sua identificação e te dará acesso as chaves de utilização da API. Com sua conta criada, você vai precisar das suas credenciais Client_ID e Client_Secret para realizar a integração.
Para visualizar suas credenciais basta fazer login em sua conta Gerencianet ( https://gerencianet.com.br/#login )
Acesse o menu API > Minhas Aplicações, e crie a sua aplicação, como mostra o link: https://gerencianet.com.br/artigo/como-criar-uma-nova-aplicacao-para-usar-a-api-pix/
Você visualizará então as credenciais Client_Id e Client_Secret de Produção e Desenvolvimento.
Vale lembrar que as chaves de Desenvolvimento são utilizadas para simular cobranças e efetuar testes na plataforma. Já as chaves de Produção devem ser utilizadas quando for emitir cobranças reais.
Abaixo seguem alguns links úteis para consulta:
- Temos uma tabela resumindo os tipos de integrações e formas de uso disponíveis, acesse e escolha a que melhor atende suas necessidades. https://dev.gerencianet.com.br/docs/tipos-integracoes
- Possuímos um curso EAD que poderá lhe ajudar a ter uma visão geral do funcionamento da nossa API de boletos, cartão, marketplace e assinaturas. https://www.udemy.com/course/eadgerencianet/
- Para você implementar os serviços de pagamento desejados, em nossa documentação temos exemplos e explicação da utilização em diversas linguagens. https://dev.gerencianet.com.br/docs/gerar-boleto-bancario
Além disso, nosso GitHub tem também uma SDK em PHP com exemplos prontos para facilitar sua integração. https://github.com/gerencianet/gn-api-sdk-php
Quaisquer dúvidas sinta-se à vontade para entrar em contato conosco!
Bom dia, na documentação da api tem um endpoint de devolução de um pix, porém existe um ID (Id gerado pelo cliente para representar unicamente uma devolução.) que não é bem descrito como conseguimos, alguém poderia me informar como posso fazer um estorno de um pix e como consigo esse ID?
Bom dia, pessoal. Tudo bom?
Estou tentando configurar o webhook. Fiz as configurações do apache2 para exigir o certificado, mas o recurso de configuração informa que a url retornou 403.
O certificado que coloquei foi baixado do link disponibilizado na documentação.
(https://pix.gerencianet.com.br/webhooks/chain-pix-prod.crt)
{
"nome": "webhook_invalido",
"mensagem": "A URL informada respondeu com o código HTTP 403"
}
"nome": "webhook_invalido",
"mensagem": "A URL informada respondeu com o código HTTP 403"
}
SSLCertificateFile /etc/letsencrypt/live/udois.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/udois.com/privkey.pem
SSLCACertificateFile /var/www/html/Udois/resources/ssl/certificates/chain-pix-prod.crt
SSLVerifyClient none
SSLVerifyClient require
SSLVerifyDepth 3
SSLCertificateKeyFile /etc/letsencrypt/live/udois.com/privkey.pem
SSLCACertificateFile /var/www/html/Udois/resources/ssl/certificates/chain-pix-prod.crt
SSLVerifyClient none
SSLVerifyClient require
SSLVerifyDepth 3
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: https://documenter.getpostman.com/view/13574984/TVzVgvBA, a SDK Pix em PHP: https://github.com/gerencianet/gn-api-sdk-php" class="link-msg">https://github.com/gerencianet/gn-api-sdk-php e a SDK Pix em Python: https://github.com/gerencianet/gn-api-sdk-python já configurados para o consumo.
Além disso, temos nosso repositório no GitHub: https://github.com/gerencianet com diversas SDKs também prontas para a utilização. No mais, temos um curso e uma documentação completa com várias instruções do fluxo de integração com várias linguagens de programação como: Node, Java, Python, C#, Ruby e PHP.
Bom dia, terráqueos!
Na hora de configurar o webhook, a API retorna 400 com uma mensagem que não consta nos exemplos da documentação: "A URL informada respondeu com o código HTTP 403".
A gente sabe que duas requisições à URL informada são feitas pela API Pix; a primeira sem o certificado, para a qual se espera 401, e a segunda com o certificado, para a qual se espera 200.
Essa mensagem de erro se refere qual delas?
Oi @Deleted User! Boa tarde! Tudo bem?
A API Pix está disponível para Node sim!
Na nossa documentação você encontra alguns exemplos de implementação da API Pix, incluindo node!
https://dev.gerencianet.com.br/docs#section-exemplos-de-autentica-o-utilizando-o-certificado-p12
Já quanto ao pacote gn-api-sdk-node infelizmente, no momento, ele ainda não conta com as funcionalidades do Pix.
Mas nossa equipe já está trabalhando nisso e em breve vamos disponibilizar uma atualização contendo essas funcionalidades! 🙂
Boa tarde, <@!723278999236771916>. A Collection você encontra em um dos primeiros tópicos da documentação da API Pix (https://dev.gerencianet.com.br/docs#section-collection-postman-gerencianet-api-pix)
Boa tarde <@!564882405794775060>, temos um exemplo que atualizamos hoje na documentação em Node
js
const express = require("express");
const fs = require("fs");
const https = require("https");
const bodyParser = require("body-parser");
var logger = require('morgan');
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
};
const app = express();
const httpsServer = https.createServer(httpsOptions, app);
const PORT = 443;
app.use(logger('dev')); // Comente essa linha caso não queira que seja exibido o log do servidor no seu console
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));
// Endpoint para configuração do webhook, você precisa cadastrar https://SEUDOMINIO.com/webhook
app.post("/webhook", (request, response) => {
// Verifica se a requisição que chegou nesse endpoint foi autorizada
if (request.socket.authorized) {
response.status(200).end();
} else {
response.status(401).end();
}
});
// Endpoind para recepção do webhook tratando o /pix
app.post("/webhook/pix", (request, response) => {
if (request.socket.authorized){
//Seu código tratando a callback
/ EXEMPLO:
var body = request.body;
filePath = __dirname + "/data.json";
fs.appendFile(filePath, JSON.stringify(body) + "\n", function (err) {
if (err) {
console.log(err);
} else {
response.status(200).end();
}
})/
response.status(200).end();
}else{
response.status(401).end();
}
});
httpsServer.listen(PORT, () =>
console.log(Express server currently running on port ${PORT})
);
const express = require("express");
const fs = require("fs");
const https = require("https");
const bodyParser = require("body-parser");
var logger = require('morgan');
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
};
const app = express();
const httpsServer = https.createServer(httpsOptions, app);
const PORT = 443;
app.use(logger('dev')); // Comente essa linha caso não queira que seja exibido o log do servidor no seu console
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));
// Endpoint para configuração do webhook, você precisa cadastrar https://SEUDOMINIO.com/webhook
app.post("/webhook", (request, response) => {
// Verifica se a requisição que chegou nesse endpoint foi autorizada
if (request.socket.authorized) {
response.status(200).end();
} else {
response.status(401).end();
}
});
// Endpoind para recepção do webhook tratando o /pix
app.post("/webhook/pix", (request, response) => {
if (request.socket.authorized){
//Seu código tratando a callback
/ EXEMPLO:
var body = request.body;
filePath = __dirname + "/data.json";
fs.appendFile(filePath, JSON.stringify(body) + "\n", function (err) {
if (err) {
console.log(err);
} else {
response.status(200).end();
}
})/
response.status(200).end();
}else{
response.status(401).end();
}
});
httpsServer.listen(PORT, () =>
console.log(Express server currently running on port ${PORT})
);
<@!814207030763847801> temos alguns exemplos de configuração mtls em nossa documentação, porém no spring boot ainda não temos. Mas a ideia vai ser a mesma, onde a Gerencianet irá fazer 2 requisições para o seu domínio(servidor). Para mais detalhes acesse nossa documentação https://dev.gerencianet.com.br/docs/api-pix#section-webhook
a API permite consultar pix recebidos sem txid (pelo menos deveria, segundo documentação oficial da API do BACEN). usando parâmetros como data de início/fim, cpf/cnpj do pagador, etc.
A Gerencianet tem essa solução sim, a API Pix. Notar porém que cada cliente seu precisaria abrir uma conta na Gerencianet, pedir os dados de acesso (client-id, client-secret e certificado), gerar uma chave Pix e aí te passar os parâmetros para vocês rodarem essas cobranças dos clientes de vocês para os clientes finais deles.
https://dev.gerencianet.com.br/docs/api-pix tem a documentação de integração, e o canal <#❖pix> tem pessoas tanto da Gerencianet quanto usuários da API que podem ajudar.
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.
<@!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)
<@!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.