Histórico de mensagens sobre location

Segue todos os escopos da API PIx:

Alterar Cobrança = cob.write
Consultar Cobrança = cob.read
Alterar Cobrança com Vencimento = cobv.write
Consultar Cobrança com Vencimento = cobv.read
Alterar Payload = payloadlocation.write
Consultar Payload = payloadlocation.read
Alterar Pix = pix.write
Consultar Pix = pix.read
Alterar Webhook = webhook.write
Consultar Webhook = webhook.read
Consultar Saldo da Conta = gn.balance.read
Alterar Chave Aleatória = gn.pix.evp.write
Consultar Chave Aleatória = gn.pix.evp.read
Alterar Configurações da API = gn.settings.write
Consultar Configurações da API = gn.settings.read
Solicitar relatórios = gn.reports.write
Consultar relatórios = gn.reports.read

A API de emissões é ativada por padrão, então neste caso, você não precisa de passar nenhuma informação para que o cliente emita cobranças cartão, boletos, carnês...

Em relação ao Boleto sem Pix = O cliente tem que deixar desativado o Bolix dentro da conta Digital

Boa tarde

Este endpoint

/cadastro/conta-simplificada/:identificador/credenciais

Retorna as informações para produção, correto ?

Tem os escopos integrados

Enum:
cob.write, payloadlocation.write, payloadlocation.read,

cob.read, pix.write, pix.read, pix.send, webhook.write, webhook.read,

gn.pix.send.read, gn.balance.read, gn.pix.evp.write, gn.pix.evp.read, gn.settings.write,

gn.settings.read, gn.barcode.read, gn.barcode.pay.write,gn.barcode.pay.read

Aonde vejo o significado de cada um ?

Posso alterar após o cadastro ?

No meu caso estou utilizando Laravel


SSLVerifyClient require
SSLVerifyDepth 3


# Tratando o /pix, redirecionando as requisições sempre para /webhook
Alias "/webhook/pix/" "/var/www/webhook/index.php"
Alias "/webhook/pix" "/var/www/webhook/index.php"

A falha retornada no decoder foi: ERROR - Error parsing qrcode string: invalid length @148
Você pode utilizar a nossa API para criar um QrCode e o Copia e Cola para evitar estas falhas.
Segue o nosso endpoint que realiza esta operação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#gerar-qrcode-de-um-location

curl --location --request POST 'https://api-pix-h.gerencianet.com.br/oauth/token' \
--header 'Authorization: Basic Q2xpZW50X0lkX2Q5MzAzNWFiNDgxZGI5MzEyNDIwNDgxMGU5NzM2M2Y3NmIwZWI0NDI6Q2xpZW50X1NlY3JldF9lNGUxN2M2YWQ3ZDY4ODZiMDYzNDk3ODUwY2VmOWVlMWU3OGY0YTIx' \
--header 'Content-Type: application/json' \
--data-raw '{
"grant_type": "client_credentials"
}'

Neste cenário, você tem duas opções de receber via Pix utilizando o mesmo QR Code.
- A primeira opção seria reutilizar o location de cobrança Pix dinâmica, assim cada pagamento terá um identificador (txid) único. No chat privado a Jéssica te encaminhou um vídeo ensinando o processo.
- A segunda opção seria utilizar um QR Code estático para o recebimento. Pontuando que, para você receber o webhook dos pagamentos, esse QR Code estático deve conter um txid. De acordo com a imagem que voê enviou, basta acrescentar o parâmetro txid com um identificador a ser inserido no QR Code.

Exemplo:

curl --cert-type P12 --cert seu_certificado.p12 --location --request PUT 'https://api-pix.gerencianet.com.br/v2/webhook/sua_chave_pix' \
--header 'x-skip-mtls-checking: true' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer seu_token' \
--data '{
"webhookUrl": "https://seu_endereco.com.br/webhook"
}'

Bom dia, @leonardo.amaral! Como vai?
Você consegui sim fazer testes em homologação, mas para isso você irá precisar da sua conta para obter as credenciais Cliente_Id, Client_Secret e certioficado para autenticação.
O processo será basicamente o seguinte:
1 Criar cobrança em homologação (https://dev.gerencianet.com.br/docs/api-pix-endpoints#criar-cobran%C3%A7a-imediata-com-txid)
Se o valor da cobrança está entre R$ 0.01 à R$ 10.00: A cobrança é confirmada, informação virá via Webhook.
Se o valor da cobrança é maior que R$ 10.00: A cobrança permanece ativa, sem confirmação. Como não há webhook nesses casos, nada é feito
2 para obter o Pix copia e cola, você pode fazer como o Rubens mencionou, usar uma biblioteca que monta o BRCode, ou usar um endpoit que já entregarmos pronto, junto com a imagem e um link de pagamento também. (https://dev.gerencianet.com.br/docs/api-pix-endpoints#gerar-qrcode-de-um-location)

Para facilitar ainda mais esse processo de integração, você ainda pode usar uma de nossas SDKs (https://github.com/gerencianet).

Há duas formas de gerar o copia e cola. A mais portável é usar o location respondido no /cob e usar uma biblioteca de geração de BRCode. A Efí tem um endpoint que a partir do id do location gera o BRCode e o QRCode, mas esse endpoint não é do padrão do BACEN.

O de saldo é tranquilo, basta ter o escopo gn.balance.read

"escoposIntegrados": [
"cob.write",
"cob.read",
"pix.write",
"pix.read",
"pix.send",
"webhook.write",
"webhook.read",
"payloadlocation.write",
"payloadlocation.read",
"gn.pix.send.read",
"gn.pix.evp.write",
"gn.pix.evp.read",
"gn.balance.read",
"gn.settings.write",
"gn.settings.read"

Mas isso vai te deixar com um location que você vai precisar usar uma biblioteca de geração de BRCode e de QRCode para transformar em algo visível.

O que você está chamando de link de visualização ? Porque o location é uma URL apenas para consumo do banco pagador...

Tentei isso direto no PHP e retorna NULL. O que eu fiz de errado?

O código completo do PHP ficou assim:


$arq_certificado = "MeuCertificadoQueEstáNoMesmoDiretorio.p12";


$client_id = "MeuClientID";
$client_secret = "MeuClientSecret";
$curl = curl_init();

$authorization = base64_encode("$client_id:$client_secret");

curl_setopt_array($curl, array(
CURLOPT_URL => "https://api-pix.gerencianet.com.br/oauth/token", // Rota base, desenvolvimento ou produção
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => '{"grant_type": "client_credentials"}',
CURLOPT_SSLCERT => $arq_certificado, // Caminho do certificado
CURLOPT_SSLCERTPASSWD => "",
CURLOPT_HTTPHEADER => array(
"Authorization: Basic $authorization",
"Content-Type: application/json"
),
));

$auth = json_decode(curl_exec($curl), true);

curl_close($curl);

$tokenType = $auth['token_type'];
$accessToken = $auth['access_token'];


echo "$accessToken";

var_dump($auth);



?>

A outra opção, que eu particularmente não sou fã, é usar os endpoints da Efí:
https://dev.gerencianet.com.br/docs/api-pix-endpoints#gerar-qrcode-de-um-location

Mas isso diminui a portabilidade do seu código, pois isso não é do padrão do BACEN, só tem na Efí.

Você pode usar o location e uma biblioteca de geração BRCode, ou usar o endpoint (proprietário) da Efí e obter BRCode e QRCode.

sim agora foi mas eu tenho outra duvida pra gerar o qrcod eu vou usaro location correto

Boa noite @ftgk
Você pode consultar o QR Code e a imagem pelo endpoint de geração, detalhado na nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#gerar-qrcode-de-um-location

Esse endpoint recebe o ID da Location como parâmetro

Este falha é apresentada em outro endpoint, no GET /v2/loc/:id/qrcode para consultar o location de uma cobrança.
https://dev.gerencianet.com.br/docs/api-pix-endpoints#gerar-qrcode-de-um-location

400location_nao_encontradaNenhum location encontrado para o identificador informado