Histórico de mensagens sobre location em pix

acabei de conseguir. mas tenho duvida de pra que server o location

Deveria ser um location e um loc.id ...

{
"calendario": {
"criacao": "2020-09-09T20:15:00.358Z",
"expiracao": 3600
},
"txid": "7978c0c97ea847e78e8849634473c1f1",
"revisao": 0,
"loc": {
"id": 789,
"location": "pix.example.com/qr/v2/9d36b84fc70b478fb95c12729b90ca25",
"tipoCob": "cob"
},
"location": "pix.example.com/qr/v2/9d36b84fc70b478fb95c12729b90ca25",
"status": "ATIVA",
"devedor": {
"cnpj": "12345678000195",
"nome": "Empresa de Serviços SA"
},
"valor": {
"original": "567.89"
},
"chave": "a1f4102e-a446-4a57-bcce-6fa48899c1d1",
"solicitacaoPagador": "Informar cartão fidelidade"
}

$config = [
"certificado" => __DIR__."/arquivo.pem",
"client_id" => "CLIENTEID",
"client_secret" => "CLIENTESECRET"
];
$autorizacao = base64_encode($config["client_id"] . ":" . $config["client_secret"]);
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://pix.api.efipay.com.br/oauth/token", // Rota base, homologação 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 => $config["certificado"],
CURLOPT_SSLCERTPASSWD => "",
CURLOPT_HTTPHEADER => array(
"Authorization: Basic $autorizacao",
"Content-Type: application/json"
),
));
$response = curl_exec($curl);
curl_close($curl);
print_r($response);

Certo. O id que você utiliza pra gerar o qrcode, é esse id do loc, retornado ao gerar a cobrança.

Certo.. essa etapa seria de geração da cobrança, o proximo passo é gerar o qrcode. Com esse id do loc ( "id": 24) que é retornado, você gera o qrcode, consumindo o endpoint GET /v2/loc/:id/qrcode (https://dev.efipay.com.br/docs/api-pix/payload-locations)

{
"calendario": {
"criacao": "2023-09-12T18:36:40.923Z",
"expiracao": 3600
},
"txid": "a1b2461c5eda4cd1be3846f0cd54f573",
"revisao": 0,
"loc": {
"id": 24,
"location": "qrcodespix-h.sejaefi.com.br/v2/1525ce07044843ab978b046e1fb909bd",
"tipoCob": "cob",
"criacao": "2023-09-12T18:36:40.970Z"
},
"location": "qrcodespix-h.sejaefi.com.br/v2/1525ce07044843ab978b046e1fb909bd",
"status": "ATIVA",
"devedor": {
"cpf": "123132132",
"nome": "testeMiranda"
},
"valor": {
"original": "0.01"
},
"chave": "7b6c1f4a-a0b4-4cbb-be0d-7c5e454a805b",
"solicitacaoPagador": "Cobrança dos serviços prestados."
}

curl --location 'https://api-pix-h.gerencianet.com.br/oauth/token' \
--cert /home/silas/Gerencianet/certificado.pem \
--data '{
"grant_type": "client_credentials"
}'

scope do token:

curl:

Você pode utilizar o endpoint de Consultar Cobrança(GET /v2/cob/:txid), passando o txid da cobrança, que vai te retornar todas as informações. Por exemplo, de uma cobrança Paga, vai te retornar o seguinte:

Bom dia, @matheusnalmeida! Tudo bem?
Nesse caso você vai utilizar o endpoint POST /v2/cob(https://dev.gerencianet.com.br/docs/api-pix-endpoints#criar-cobran%C3%A7a-imediata-sem-txid), passando o parâmetro loc=>id, com o identificador do location desejado. Assim o txid desse nova cobrança será associado a este location.
Segue um json de exemplo:

Boa noite. Como posso associar uma location que foi criada atráves do endpoit de criação da location(/v2/loc) a uma cobrança(txid), sem necessariamente chamar o endpoint que cria uma cobrança passando um txid(/v2/cob/
:txid)? O endpoint que cria uma cobrança passando um txid(/v2/cob/:txid) automaticamente ja cria uma location e associa ela ao txid passado, porém eu queria associar uma cobrança a uma location ja criada.

{
"status": "ATIVA",
"calendario": {
"criacao": "2020-09-09T20:15:00.358Z",
"expiracao": "3600"
},
"location": "pix.example.com/qr/9d36b84f-c70b-478f-b95c-12729b90ca25",
"txid": "7978c0c97ea847e78e8849634473c1f1",
"revisao": 1,
"devedor": {
"cnpj": "12345678000195",
"nome": "Empresa de Serviços SA"
},
"valor": {
"original": "567.89"
},
"chave": "a1f4102e-a446-4a57-bcce-6fa48899c1d1",
"solicitacaoPagador": "Informe o número ou identificador do pedido."
}

achei esse exemplo na docs da api, como eu sei se tá pago ou n? seria o status?

Boa noite @koddydev! Esse escopo diz respeito à permissão para consulta de locations.

payloadlocation.read

seria qual lá nas opções do site

mas quando acesso a location enviada recebo o status normal

Se entendi direito, os endpoints que você quer são os da família /loc:
https://dev.gerencianet.com.br/docs/api-pix-endpoints#payload-locations

Único, a não ser que você especificamente reaproveite o location, mas que é algo para casos de uso como QR-Codes impressos.