Histórico de mensagens sobre cobrança de api

Bom dia @jnsz_ tudo certo?
Para os casos de emissões de Boleto, Cartão, Carnê e Assinatura, tem um funcionamento um pouco diferente da API Pix.

O recomendado para acompanhar o status do pagamento é criar uma rota no seu sistema para receber um POST da nossa API.
Então ao criar uma nova cobrança, você deve adicionar o atributo notification_url que é a URL do seu servidor preparada anteriormente.
A API da Gerencianet então irá notificar na URL informada sempre que houver alguma mudança de status na cobrança criada. O processo segue o fluxo da imagem abaixo.

Na nossa documentação você encontra mais detalhes sobre o funcionamento das notificações de pagamento
Recebendo as notificações - https://dev.gerencianet.com.br/docs/notificacoes-recebendo
Entendendo o fluxo das notificações - https://dev.gerencianet.com.br/docs/entendendo-fluxo-notificacoes

Pessoal, bom dia!
Parece que minha conta foi suspensa por eu ter emitido cobranças sem informar o ramo de atividade, porém eu já tinha informado antes de continuar com os teste e nenhuma cobrança que fiz na API chegou no meu cartão.
Quem poderia me ajudar?

Olá pessoal, eu tenho uma operação onde eu intermédio vendas no setor de delivery. Minha plataforma conecta estabelecimentos com entregadores autônomos, atualmente eu tenho uma integração onde o mesmo equipamento é compartilhado para cobrar em diversos estabelecimentos.

1 - O estabelecimento solicita uma corrida no meu sistema, e informa quanto o entregador deverá receber no equipamento.
2 - O entregador que possuir o equipamento consegue visualizar o pedido
3 - Ele vai até o estabelecimento, retira o produto
4 - Ele vai até o cliente do estabelecimento e efetua a cobrança utilizando a máquina
5 - Minha plataforma identifica esse pagamento, e finaliza a corrida.

Qual o desafio: Existem N CNPJ's e o entregador deve possuir apenas UM equipamento, porém a liquidação do valor deverá ser realizada na conta de cada CNPJ que originou a corrida inicialmente.

A integração deve ser capaz de ser iniciada apenas via SDK ou API, o entregador não pode ter acesso há conta do cliente e ele também não pode informar o valor. Meu aplicativo que gerencia tudo isso.

Eu tenho isso funcionando atualmente, porém estou descontente com o fornecedor atual.

olá, boa tarde
podem me ajudar?
estou usando uma cobrança imediata (com txid) sem webhook, e agora preciso criar uma rotina de devolução de pix,
onde posso pegar o e2eId?
https://dev.gerencianet.com.br/docs/api-pix-endpoints#solicitar-devolução

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.

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.

Olá, bom dia.

Estou integrando a cobrança via Pix com data de vencimento.

https://dev.gerencianet.com.br/docs/api-pix-endpoints#criar-cobran%C3%A7a-com-vencimento

Aqui no fluxo para pagamentos via boleto bancário existe o cancelamento do registro na CIP.

É possível também cancelar essa cobrança Pix ou não isso não se faz necessário?

Olá @Relacionamento tenho algumas sugestões para a conta da GN.

Acredito que poderia haver um controle de notificações, eu mesmo não gostaria de receber notificação há cada cobrança PIX gerada via API paga, isso polui o sistema de notificação e caso a GN crie um ticket ou mande algo relevante para mim acabaria no esquecimento.

O controle de notificação poderia ter no nível do app e do painel web, isso ajudaria muito. Eu infelizmente acabei desativando as notificações porque meu celular toda hora apita, e gera também um desconforto. Então minha dica é: Crie preferências de notificações, para escolhermos quais notificações receber e onde receber. Caso receba um PIX via chave ou então um ticket ou aviso seja enviado para mim eu gostaria de receber a notificação. Agora emissões via API não é algo que eu julgue importante, porém pode haver clientes que gostem disso.

É isso, uma ótima semana para todos.

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:

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.

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());
}

Boa noite @reneerojas. ! Esse código de erro esta relacionada a falha de Não é possível emitir três cobranças idênticas.. Essa falha ocorre quando você emite três cobranças exatamente idênticas: mesma descrição do produto, valor, data de vencimento... E nesse caso, por questões de segurança, a API não aceita.

entendo, hj meu sistema gera as cobranças no backend, algumas tem valor fixo e outras vão ser planos com valores mensais mas daria para gerar uma novas cobrança todo mês tranquilamente, minha ideia era se fosse possível gerar a cobrança no backend e ter por exemplo uma url que meu front exibiria pro cliente e ai ele escolhe qual método quer usar para pagamento se vai querer pix ou cartão, isso seria possível ou preciso integrar de forma separada isso nos dois serviços na api pix a na de cartao

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!

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:

@relixes Para obter o status da cobrança a recomendação é utilizar o webhook.
Temos mais detalhes na documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-webhooks

Olá @ferdead2 ! Bom dia. Tudo bem?
Para integrar a API de Pagamentos Gerencianet ao seu sistema ou sua plataforma, é necessário ter uma Conta Digital Gerencianet.
A API de Pagamentos Gerencianet disponibiliza os nossos serviços para a realização de pagamentos de cobranças.
Com nossa API é possível consultar cobranças à serem pagas, enviar ordens de pagamento e verificar o status de um pagamento.

Para gerar um certificado, siga o passo a passo abaixo:

- acesse a sua conta digital por meio da plataforma web da Gerencianet;
- na tela principal da plataforma, clique em “API”;
- no menu lateral, clique em “Meus certificados”;
- escolha o ambiente para o qual você deseja gerar o certificado (Produção ou Homologação);
- clique no botão “Criar novo certificado” e insira um nome para identificá-lo;
- clique em “Criar certificado”;
- insira sua Assinatura Eletrônica para confirmar a alteração.

Pronto, certificado criado com sucesso!

Depois, será necessário criar uma aplicação. Para isso, siga os passos abaixo:
- na tela principal da plataforma Gerencianet, clique em “API”→ “Aplicações” → “Criar aplicação”;
- insira um nome para sua aplicação;
- selecione qual API quer ativar;
- selecione os Escopos de Produção e Escopos de Homologação (Desenvolvimento) que deseja liberar;
- clique em “Criar aplicação”;
- informe a sua Assinatura Eletrônica para confirmar as alterações e atualizar a aplicação.

Caso queira utilizar a API de Pagamentos é necessário liberar os escopos da mesma na sua aplicação.
Logo, assim que tiver a aplicação e o certificado criado, nos comunique para que possamos dar seguimento à sua solicitação.

Olá, @everyone! A cobrança responsiva já chegou à API da Gerencianet.

Isso significa mais praticidade e uma melhor experiência para a conclusão de pagamento dos seus clientes.

Quer saber o que mudou? Veja alguns exemplos dessa atualização:

- Boleto: https://dev.gerencianet.com.br/docs/gerar-boleto-bancario" class="link-msg">https://dev.gerencianet.com.br/docs/gerar-boleto-bancario .
- Carnê: https://dev.gerencianet.com.br/docs/carnes-criando .
- Assinatura: https://dev.gerencianet.com.br/docs/criando-assinaturas .

Nos últimos dias, a atualização foi concluída de forma automática.

Atenção: se a sua aplicação utiliza os dados retornados no HTML e você deseja continuar recebendo nesse formato, é necessário que você ajuste os atributos de retorno da sua API. Em caso de dúvidas, procure um de nossos especialistas na aba Consultoria Técnica.

Para conferir todos os detalhes, acesse a documentação da API: https://dev.gerencianet.com.br/docs .

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

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.