Histórico de mensagens sobre api-pix

Bom dia, Anderson! No momento não, o endpoint de envio de Pix necessita da assinatura do termo e contato com a equipe comercial, pois, permite a movimentação de valores via transferência de forma muito rápida em sua conta. Em ambiente de homologação ainda não está pronto o endpoint, mas a nossa equipe está atuando para o desenvolvimento do mesmo.

Em relação a chamada e retorno temos exemplos na documentação que seguem o padrão exato da API, segue os links:
Requisição: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-requisitar-envio-de-pix
Callback Pix enviado:

Olá, boa noite! Tudo bem? 😀
Estou tentando criar meu próprio webhook em PHP (no meu servidor dedicado) para receber as notificações de pagamentos realizados via Pix, e há algum problema, pois não recebo as notificações de pagamentos. Segue o código em PHP abaixo:

header("Content-Type: application/json");
$request = file_get_contents("php://input");
file_put_contents("webhook.json", print_r($request, true));
print_r($request);
?>

Recebo a notificação de configuração do link do webhook normalmente:

{
"webhookUrl": "https://exemplo-pix/webhook"
}

Mas não recebo a notificação quando realizo o pagamento:

{
"pix": [
{
"endToEndId": "E1803615022211340s08793XPJ",
"txid": "fc9a43k6ff384ryP5f41719",
"chave": "2c3c7441-b91e-4982-3c25-6105581e18ae",
"valor": "0.01",
"horario": "2020-12-21T13:40:34.000Z",
"infoPagador": "pagando o pix"
}
]
}

Tentei utilizar o exemplo de configuração de servidor em Python desenvolvido em Flask (https://dev.gerencianet.com.br/v1/docs/api-pix#section-exemplos-de-uma-configura-o-de-servidor-), mas não consegui seguir esse exemplo. ☹️

Já testei em sites de terceiros (como o https://webhook.site), e funciona normalmente (recebi a notificação do pagamento).

O meu servidor possui certificado SSL e a versão do TLS é 1.2.

Preciso receber essas notificações e armazená-las em algum lugar para verificar se o pagamento foi realizado. Vocês podem me ajudar? Irei ficar muito grato! Muito obrigado! 😀

Em nossa documentação mostramos como pode realizar a conversão: https://dev.gerencianet.com.br/docs/api-pix-autenticacao-e-seguranca#section-convers-o-de-certificado-p12-para-o-formato-pem

Olá, boa noite. Estou tentando configurar um webhook à uma chave PIX porém estou recebendo este erro: urllib3.exceptions.MaxRetryError: HTTPSConnectionPool(host='api-pix-h.gerencianet.com.br', port=443): Max retries exceeded with url: /oauth/token (Caused by SSLError(SSLError(9, '[SSL] PEM lib (_ssl.c:4046)')))

Estou utilizando o SDK do python, seguindo os exemplos do github.

https://gerencianet.com.br/blog/case-clicksign-e-api-pix/

Boa noite <@!337383375289712651>. "webhook inválido" é uma resposta esperada dentro da nossa API, como a url respondeu com um código diferente de 200, quer dizer que algum requisito de cadastro do webhook ela não está cumprindo. Verifique na nossa documentação se você está seguindo os passos corretamente: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-configurar-o-webhook-pix
Sugerimos também que verifique a sessão de validação mTLS que é uma etapa importante do cadastro do webhook: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-entendendo-o-padr-o-mtls

a primeira e rapida
ao realizar a requisição PUT no /webhook:chave, a resposta que o gerencianet trará é útil? precisarei utilizar o conteudo dele pra alguma coisa ? poderia simplesmente dispensar ?

===segundo:===
num sistema, eu só teria que cadastrar o webhook apenas uma vez ? E se eu enviasse a requisição novamente, o webhook seria "sobescrito" ? Teria algum problema de sobrecarga na API de vocês? teria a possibilidade do meu servidor ser bloqueado?

=== terceiro: ===
Nas configurações do servidor para aceitar o webhook, como está no site (https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-webhooks)
meu sistema (feito em PHP) NÃO está utilizando o esquema de rotas

na seção:
// invés da rota /webhook, eu colocaria o caminho para o diretório simplesmente? (ex: {documentRoot}/.../.../webhook/)
SSLVerifyClient require
SSLVerifyDepth 3


na seção ALIAS seria basicamente a mesma coisa ?
Alias "/webhook/pix/" "/var/www/webhook/index.php" // Seria: {documentRoot}/../../webhook/pix/index.php (?) ou eu descartaria essa seção ?
Alias "/webhook/pix" "/var/www/webhook/index.php"

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 para um servidor dedicado, você deve inserir uma chave pública da Gerencianet em 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 ou Nginx: 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:
{
"webhookUrl": "https://seudominio.com.br/webhook"
}

No entanto, a URL será registrada com o /pix no final, assim: https://seudominio.com.br/webhook/pix.
Ou seja, 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 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.

Em https://dev.gerencianet.com.br/docs/api-pix-endpoints nem tem a palavra charge... isso é de algum SDK ?

Se estiver com a opção de mTLS habilitada, em seu domínio (que representa o seu servidor), deverá ser feita uma configuração para exigir a chave pública (mTLS) da Gerencianet para que ocorra a autenticação mútua. Essa chave esta disponível na nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-entendendo-o-padr-o-mtls . Com a opção desabilitada, não é necessário realizar essa configuração.

e o modulo api-pix para o mesmo

mais a api-pix modulo faz ?

a api-pix faz isso

Tem sim como bloquear, vide https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-criar-modificar-configura-es-da-conta

Bom dia, <@!902225078371115058>! Tudo bem?
Você pode sim gerar um novo Pix. Neste caso, visualizo algumas opções:
- Manter o Pix como está. Ele continuará com o status ATIVO, mas como está expirado, não é possível efetuar o pagamento. E então gerar um novo Pix.
- OU Consumir o endpoint PATCH /v2/cob/:txid, setar um status REMOVIDA_PELO_USUARIO_RECEBEDOR, para você saber que este Pix foi finalizado, e então gerar um novo.
- OU Consumir o endpoint PATCH /v2/cob/:txid, e atualizar o tempo de expiração para que fique disponível para pagamento novamente. Desta forma não seria preciso gerar um novo.

Link do endpoint PATCH /v2/cob/:txid na documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-revisar-cobran-a

Essa falha é referente a tentativa de cadastro em seu webhook, onde não foi possível verificar o certificado (CA). Sugiro você verificar a documentação do mTLS e os exemplos disponíveis (https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-entendendo-o-padr-o-mtls).

Você deve inserir o certificado .p12 no menu "File" >> "Settings" >> "Certificates", clique em "Add Certificate". No campo "Host" da configuração do certificado, no Postman, informe api-pix-h.gerencianet.com.br para homologação ou api-pix.gerencianet.com.br para produção e, em "PFX File" selecione o arquivo do certificado.

Na rota POST /oauth/token no Authorization, você deve selecionar o Type Basic Auth e em Usarname inserir o seu cliente_id e em Password, inserir o seu client_secret. A rota será https://api-pix-h.gerencianet.com.br para homologação ou https://api-pix.gerencianet.com.br para produção.

Boa tarde, <@!546122724163190824>!
Possui sim!
Em nosso documentação você encontra os detalhes dos endpoints para gerenciamento de notificações e sobre as configurações que seu servidor deve seguir para que a comunicação obedeça o padrão mTLS (forma de autenticação mutua).
https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-webhooks

Bom dia <@!298112455626981376> ! A collection é a mesma. Para você alterar pra produção, você deve alterar a rota base para https://api-pix.gerencianet.com.br e utilizar o certificado e as credenciais client_id e client_secret de produção.

Link dos exemplos da GN de configuração de servidor HTTPS: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-exemplos-de-configura-es-de-servidor