Histórico de mensagens sobre cobrança de api em pix

EXIBINDO CONVERSAS RECENTES:

Texto: cobrança de api
Canal: pix
Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

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.

Avatar discord do usuario imcbdo

imcbdo

Ver Respostas

Com todo respeito, vcs não são nada atraentes para um desenvolvedor implementar cobranças por API. Primeira vez que realizo integração, não deixarei de atender nenhum próximo cliente, mas não recomendaria para outros desenvolvedores.

Para gerar um QRCode de Pix temos que:
configurar uma caralh# de permissões, faltando detalhes - Poderia ter um botão, permissões de ecommerce ou para cobranças apenas. (Tempo que poderia estar tomando minha cerveja, rs)
necessidade para gerar um token jwt que vale por 60 minutos - não entendo a real necessidade disso para vcs, para autorização cliente-side otimo, atoa para integração,.

Uma simples chave de API recebimentos seria eficiente ou até msm somente o cliente_id e cliente_secret como é na maioria dos casos.

--

Não discordo de usar certificado nas transações de saída.

Imagino o dono de um pequeno ecommerce que contrata um programador novato ou "barato", já iria fica perdido para fazer uma integração dessa ou nem chegar a fazer.

Tem programador que não sabe oq é um certificado.

Na empresa vizinha apenas uma requisição faz tudo e ainda me retorna o qrcode (nas transações pix)

temos que pensar que menos pode ser mais e melhor.

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

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:

json
{
"webhookUrl": "https://seudominio.com.br/webhook"
}
No entanto, as notificações serão enviadas para sua URL com o /pix no final, assim: https://seudominio.com.br/webhook/pix.

Desta forma, esta adição do /pix também dever ser tratada nas configurações de seu servidor para que na rota /webhook/pix de seu servidor também exija o certificado CA da Gerencianet.

Veja mais detalhes sobre o endpoint: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-configurar-o-webhook-pix

Com isto, todo Pix gerado com sua chave Pix e que possua um txid, serão enviados as notificações para sua URL.

Avatar discord do usuario liftgo8480

liftgo8480

Ver Respostas

Sim, mas as cobranças com valores acima disso não estão descontando esse R$ 0,01. Utilizo a API deles em todo o sistema do WHMCS.

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

Bom dia, @deivson7351. Tudo bem?
Instalando nossa SDK de PHP (https://github.com/gerencianet/gn-api-sdk-php), você pode utilizar o seguinte exemplo para gerar cobrança imediata definindo na variável $params o txid desejado.

php

require __DIR__ . '/../../../vendor/autoload.php';

use Gerencianet\Exception\GerencianetException;
use Gerencianet\Gerencianet;

$file = file_get_contents(__DIR__ . '/../../config.json');
$options = json_decode($file, true);

$params = "7978c0c97ea847e78e8849634473c1f1"; // string (Id da Transação) ^[a-zA-Z0-9]{26,35}$

$body = [
"calendario" => [
"expiracao" => 3600
],
"devedor" => [
"cpf" => "12345678909",
"nome" => "Francisco da Silva"
],
"valor" => [
"original" => "0.01"
],
"chave" => "", // Chave pix da conta Gerencianet do recebedor
"solicitacaoPagador" => "Informe o número ou identificador do pedido.",
"infoAdicionais" => [
[
"nome" => "Campo 1", // Nome do campo string (Nome) ≤ 50 characters
"valor" => "Informação Adicional1 do PSP-Recebedor" // Dados do campo string (Valor) ≤ 200 characters
],
[
"nome" => "Campo 2",
"valor" => "Informação Adicional2 do PSP-Recebedor"
]
]
];

try {
$api = Gerencianet::getInstance($options);
$pix = $api->pixCreateCharge($params, $body);

if ($pix['txid']) {
$params = [
'id' => $pix['loc']['id']
];

// Gera QRCode
$qrcode = $api->pixGenerateQRCode($params);

echo 'Detalhes da cobrança:';
echo '
' . json_encode($pix, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) . '
';

echo 'QR Code:';
echo '
' . json_encode($qrcode, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) . '
';

echo 'Imagem:
';
echo '';
} else {
echo '
' . json_encode($pix, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) . '
';
}
} catch (GerencianetException $e) {
print_r($e->code);
print_r($e->error);
print_r($e->errorDescription);
} catch (Exception $e) {
print_r($e->getMessage());
}

Avatar discord do usuario f7aviom5850

f7aviom5850

Ver Respostas

bom dia!

o que é necessário para gerar cobrança pix ( QRCode e Copia&Cola ) no meu projeto android ( feito em java ) em função de consumir a API da Gerencianet?

alguém que tenha feito pode me orientar pot favor?

existe algum tuto que mostre como fazer?

estou perdido neste ponto e não sei o que fazer. nem mesmo como fazer as perguntas.. rsrs
a única coisa que sei é: meu app é tipo marketplace pensado para receber pix.

desde já, muito obrigado!

Avatar discord do usuario relixes

relixes

Ver Respostas

boa noite!
Eu estou trabalhando em um projeto no qual pode ser necessário que uma pessoa necessite realizar mais de um pagamento pix de um mesmo determinado valor em um intervalo de tempo curto.
O projeto é a integração de pagamento pix em uma máquina de arcade, então as pessoas pagam sempre o mesmo valor a cada N vidas perdidas no jogo
Exemplo:

[Agora] pessoa A faz pagamento de valor X á minha chave pix
[1 minuto depois] Pessoa A faz outro pagameto de valor X à minha chave pix
[5 minutos depois] Pessoa A faz outro pagameto de valor X à minha chave pix
Ou seja, 3 pagamentos de um mesmo valor, da mesma pessoa, num intervalo de tempo de 5 minutos

O problema é que sempre que eu tento fazer um pagamento "repetido" da cobrança que eu gero, com um valor fixo, eu não consigo mais realizar um pix desse mesmo valor durante um certo período de tempo. Como se houvesse algum tipo de "cooldown" pra fazer o pagamento. Imagino que isso seja um tipo de proteção pra evitar que pessoas realizem pagamentos repetidos.
Existe alguma maneira de trabalhar com a API para que o pagamento nesse modelo que eu mencionei seja possível?

Avatar discord do usuario palloma_efi

palloma_efi

Ver Respostas

Para recebimento das confirmações de pagamento, o ideal é que você possua um webhook vinculado a sua chave Pix.
Assim, sempre que houver qualquer alteração no status de uma cobrança, nós notificaremos a URL que você cadastrou como webhook.
Em nossa documentação disponibilizamos mais detalhes sobre esse fluxo: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-webhooks
Lembrando também que nossa API é aberta e caso julgue necessário, você pode realizar a integração sem utilizar a SDK.
Os exemplos podem ser encontrados em diversas linguagens no nosso Github: https://github.com/gerencianet

Avatar discord do usuario rubenskuhl

rubenskuhl

Ver Respostas

Ao criar a cobrança vem também um id de location. Com o id, você pode acessar este endpoint:
https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-gerar-qrcode-de-um-location

Porém, o ideal seria você usar uma biblioteca própria de BRCode/EMV/QRCode e não depender desse endpoint.

Avatar discord do usuario joao_efi

joao_efi

Ver Respostas

Boa tarde @david_balbino tudo certo?
Para receber a confirmação de pagamento é necessário configurar um webhook e registrá-lo na API da Gerencianet.
Dessa forma, sempre que houver um pagamento a nossa API envia uma requisição para seu webhook com as informações da cobrança paga.
No link abaixo você encontra mais informações sobre como funciona e como configurar:
https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-webhooks

Avatar discord do usuario joao_efi

joao_efi

Boa tarde @thalesmatoso tudo bem? 🙂
Até o momento não tivemos relatos de falha relacionado ao envio de confirmações para os webhooks.
Consultando a cobrança, conforme sugerido pelo @rubenskuhl , acredito que retorne as informações que você precisa também.

Só ressaltando alguns pontos:
- Atualmente o Histórico de Notificações e o Histórico de Requisições no painel da Gerencianet ainda não exibem informações referentes ao Pix.

- O envio das confirmações de pagamento de cobranças PIX são feitas via webhok, e já as confirmações de pagamento referentes ao BOLIX são um fluxo de notificações diferente (links abaixo)
Webhook Pix: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-webhooks
Notificações Bolix: https://dev.gerencianet.com.br/docs/notificacoes-recebendo

Avatar discord do usuario joao_efi

joao_efi

Ver Respostas

Boa tarde @araujo0205 tudo bem? 🙂
Ao tentar registrar seu webhook é efetuado requisições de testes com o mTLS.
Caso queira testar em produção, recomendo criar uma cobrança com valor baixo, ex: R$0,01 e efetuar o pagamento.
https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-configurar-o-webhook-pix

Avatar discord do usuario jg_19

jg_19

Ver Respostas

Criar cobrança imediata (sem txid)
method POST
https://dev.gerencianet.com.br/docs/api-pix-endpoints

Avatar discord do usuario joao_efi

joao_efi

Ver Respostas

Boa tarde @thichief20 tudo certo? 🙂
Não sei se é viável pra você, mas acredito que seria mais prático configurar um servidor para ser seu webhook e ao receber a confirmação de pagamento dispara o comando para o seu raspberry.
Vale ressaltar que se a cobrança for criada com a chave cadastrada no webhook, o webhook é acionado desde que a cobrança tenha um txid Válido.
Na nossa documentação você encontra um exemplo do webhook em python
https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-exemplos-de-configura-es-de-servidor

Avatar discord do usuario thichief20

thichief20

Ver Respostas

Boa tarde galera,
Sou Thiago Gava, estudo Sistemas de Informação, 6º Periodo...

Eu estou fazendo um projeto na faculdade, onde tenho que fazer a venda de produtos com pagamentos em pix, após ter o pagamento confirmado, preciso rodar comandos para ativar componentes eletrônicos que "liberam" que dosam o produto selecionado, e a quantidade selecionada pelo cliente.
O app, por requisição do professor deve ser em Python, e eu tenho pouquissimo conhecimento aplicado na linguagem., pois ele terá de ser rodado em um Raspberry PI 3B+.

A questão é, seguindo as instruções da documentação da API da Gerencianet, e o material de um video de 2019, conseguimos fazer com que seja criado a cobrança e o qrcode para o pagamento, porem ainda não conseguimos implementar o webhook ou uma maneira de retornar a "confirmação" de que o pagamento tenha sido efetuado.
O webhook seria a melhor opção, porem parece que a API não reconhece o TXID da cobrança que geramos...

Eu estou sem cabeça, atrasado com as entregas, ou seja, sem condição alguma para pensar em uma solução por conta própria...

Então peço a ajuda de quem puder resgatar um desesperado 🙂