Histórico de mensagens sobre location em pix

Olá, pessoal, a Hospedagem configurou o mTLS para o Webhook do Pix, podem ver se fizeram certo:

Boa tarde, <@!371450194056708097>. Como dito pelo Rubens, você pode utilizar o BRCode, também chamado de copia e cola. Ao utilizar o endpoint GET /v2/loc/:id/qrcode é retornado a imagem do QRCode em Base64 e um código copia e cola que pode ser utilizado com o propósito que você necessita. Segue os detalhes desse endpoint: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-gerar-qrcode-de-um-location.

Boa noite!
Quando o prazo da cobrança pix é expirado, o status da cobrança é alterado ou sempre vai ser ativo?
Exemplo de retorno:

Queria saber se para cada vez que eu for criar um novo QRCode de cobrança, vou ter que criar um novo Payload location ou se posso criar um e somente ir regerando o QRCode com o outro valor de cobrança, essa seria minha dúvida

Bom dia, <@!872084538669531166>. Qual a sua dúvida? De qualquer forma, segue uma breve explicação dos termos em nosso glossário https://dev.gerencianet.com.br/docs/api-pix-glossario#section-location

Bom dia, alguém poderia me tirar um dúvida sobre Payload locations? Queria entender ao certo o funcionamento, antes de iniciar o desenvolvimento.

E ao consumir o endpoint de gerar o qrcode ( https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-gerar-qrcode-de-um-location ) você tem como retorno o qrcode(pix copia e cola) e o imagemQrcode(imagem do qrcode em base 64)

$config = [
"certificado" => "./gerenciamento.pem",
"client_id" => "XXXXX",
"client_secret" => "XXXXX"
];
$autorizacao = $chaveiro["access_token"];

$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api-pix.gerencianet.com.br/v2/webhook/XXXXX',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_SSLCERT => $config["certificado"], // Caminho do certificado
CURLOPT_SSLCERTPASSWD => $chaveiro["access_token"],
CURLOPT_POSTFIELDS =>'{
"webhookUrl": "https://XXXXX/webhook.php"
}',
CURLOPT_HTTPHEADER => array(
"Authorization: Bearer $autorizacao",
'x-client-cert-pem: ./gerenciamento.pem',
'x-skip-mtls-checking: false'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;

eu tenho esse código (que achei na documentação):
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api-pix.gerencianet.com.br/v2/pix?inicio=2021-07-13T00:00:00.000Z&fim=2021-07-19T23:00:00.000Z',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => array(
'x-account-code: d74543e3a0fe7a7836a88dd97a281804'
),
));
$response = curl_exec($curl);

Para gerar o QR Code você pode utilizar o endpoint GET /v2/loc/:id/qrcode, você informa o id do location e retornamos o copia e cola e a imagem do QR Code em Base64.

Nesse link https://dev.gerencianet.com.br/docs/api-pix-endpoints você encontra todos os endpoints do PIX. Mas basicamente, primeiramente você cria uma cobrança utilizando a rota POST/vs/cob, em seguida você você utiliza o id do location retornado no primeiro consumo para gerar o qrcode, consumindo a rota GET/v2/loc/:id/qrcode, nela voce tera como retorno o pix copia e cola e a imagemQrcode em base64.

No link que enviei tem a definição de location:
Um location é a URL do tipo URL de capacidade que serve de endereço para uma cobrança. Em outras palavras é através de um location que se torna possível resgatar as informações relacionadas a uma cobrança e, assim, realizar as movimentações.

nada.. esse exemplo mesmo, ate agora nao achei onde descreve oque são locations.. nao vi sobre oque é uma charge( somente que é uma abertura de cobrança eu acho) daí depois tem q informar a forma de pagamento , etc...

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á!
Não estou conseguindo fazer funcionar seguindo a referencia desse segundo exemplo proposto na documentação.


:443> # Porta HTTPS
#
# ...
#

ServerName dominiodetestes.com.br
SSLCertificateFile /etc/letsencrypt/live/pixspeak.com.br/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/pixspeak.com.br/privkey.pem

# mTLS Gerencianet
SSLVerifyClient none

SSLVerifyClient require
SSLVerifyDepth 3


#
# ...
#



o retorno que recebo é o seguinte:

{
"nome": "webhook_invalido",
"mensagem": "A URL informada respondeu com o código HTTP 403"
}

____
porem se eu uso o primeiro modelo de exemplo que é indicado para sub-dominios, então funciona.
Enfim, preciso configurar o apache para que os certificados sejam solicitados apenas quando a url for (dominiodetestes.com.br/webhook), mas assim como comentado acima, mesmo usando o modelo da documentação, não estou conseguindo. O que será que estou fazendo de errado?

Precisa colocar https://. No location não está escrito para economizar caracteres, mas é sempre https.

estranho, peguei o location aqui, joguei no navegador e fica esperando resposta como se tivesse atrás de um firewall 🤔

O location é acessível de qualquer lugar. Por isso inclusive ele é parte da API Pix, ele transita na Internet, não na RSFN.

Pq a sequência de diagnóstico é passar no QR-Decoder, ver o location, baixar o JWT, usar o jwt.io e ver a parte de criptografia e o JSON do payload.