Histórico de mensagens sobre cobrança de api em pix

Não é possivel realizar a leitura de um qrcode emitido em homologação.
Somente as cobranças em produção são reconhecidas.
Porém você consegue testar o webhook de confirmação em homologação:

olá, consegui cadastrar a url usando pixConfigWebhook (sdk typescript), agora depois de gerar a cobrança e cadastrar o webhook recebo uma requisição na url cadastrada com o seguinte payload

DEFAULT 2024-05-30T16:03:39.462573Z /webhook payload: {
DEFAULT 2024-05-30T16:03:39.462585Z pix: [
DEFAULT 2024-05-30T16:03:39.462589Z {
DEFAULT 2024-05-30T16:03:39.462593Z endToEndId: 'E09089356202405301603API5d83da44',
DEFAULT 2024-05-30T16:03:39.462595Z txid: '89ddfba0723a4ef2b9ef5597381368aa',
DEFAULT 2024-05-30T16:03:39.462598Z chave: ,
DEFAULT 2024-05-30T16:03:39.462600Z valor: '4.00',
DEFAULT 2024-05-30T16:03:39.462602Z horario: '2024-05-30T16:03:09.000Z',
DEFAULT 2024-05-30T16:03:39.462605Z infoPagador: 'Teste de pagamento em ambiente sandbox'
DEFAULT 2024-05-30T16:03:39.462610Z }
DEFAULT 2024-05-30T16:03:39.462612Z ]
DEFAULT 2024-05-30T16:03:39.462615Z }

eu pensei que receberia o objeto com a propriedade status

alguém pode me ajudar a entender? grato

Bom dia! Tudo bem? Exatamente. Todo cliente que emitir cobranças Pix precisará enviar as credenciais de acesso e o certificado (gerado na conta Efí) para autenticação na API

A ideia é esta mesmo, @alissonmaciel_32335. Você irá utilizar este endpoint PUT/v2/webhook/:chave para associar sua URL de notificação a sua chave Pix. E então as cobranças Pix que tiverem um txid e sua chave Pix, nós iremos enviar a notificação para a URL registrada. Essa configuração pode ser feita uma única vez.

Pontuando que para registrar sua URL de notificação, é importante que seu servidor tenha algumas configurações para atender a comunicação com mTLS para segurança da sua aplicação. Você encontra mais detalhes em nossa documentação e nos vídeos a seguir: https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks
https://youtu.be/hdyUHzNwVLY?list=PLRqvcUTH2VsWufBmzOdTVeLEOTGrPNoiu
https://youtu.be/XB9bcZFTV3M?list=PLRqvcUTH2VsWufBmzOdTVeLEOTGrPNoiu

Boa tarde. Estou tendo dificuldade para receber notificações do status da cobrança. Na documentação https://dev.efipay.com.br/docs/api-cobrancas/notificacoes/#recebendo-as-notifica%C3%A7%C3%B5es diz:
"Um POST vai conter apenas uma informação: um token de notificação. Esse token é enviado quando ocorre uma alteração no status da cobrança. Para receber essas notificações, você precisa cadastrar uma URL de notificação na cobrança e prepará-la para ler o token na variável $_POST['notification']."

No meu código eu faço
$token = $_POST['notification']

e recebo este erro na plataforma:
{
"code": 3500010,
"error": "property_does_not_exists",
"error_description": {
"property": "notification",
"message": "A propriedade [notification] informada não existe."
}
}

como resolvo?

Você pode configurar uma webhook URL para receber atualizações automáticas da cobrança Pix em sua aplicação. Veja aqui mais detalhes.
E para consultar uma cobrança específica, você pode usar o endpoint GET /v2/cob/:txid.

Ah sim, me desculpe a confusão. No caso dos endpoints de lote, são usados para emitir cobranças Pix para recebimento.
No momento, não dispomos de um endpoint de envio em lote, mas você pode utilizar o endpoint de envio de Pix e programar o loop que realizará os envios. Neste cenário, recomendamos que o envio de Pix por API esteja condicionado à conclusão da transação anterior, a qual é notificada por meio do webhook.

Bom dia!
Atualmente, é necessário primeiro cadastrar a configuração de Split, depois emitir a cobrança e associar essa cobrança à configuração de Split previamente cadastrada.
Segue o fluxograma para uma visualização mais clara: https://dev.efipay.com.br/docs/api-pix/fluxogramas/#split-de-pagamento-pix

O endpoint de cadastro de webhook solicita o parâmetro da chave e este é obrigatório. Portanto, para cada chave Pix, será necessário realizar o cadastro do webhook, que pode ser a mesma ou uma URL diferente

Se precisar de mais alguma informação ou assistência, estou à disposição para ajudar!

Boa tarde, @tolribeiro! Tudo bem?
Sim, você consegue alterar o valor de uma cobrança Pix usando o endpoint com método PATCH: https://dev.efipay.com.br/docs/api-pix/cobrancas-imediatas#revisar-cobran%C3%A7a
A transferência para a outra conta seria para um mesmo titular?

Bom dia @.ilselangnar tudo certo?
O atributo deve ser uma string mesmo, porém é preciso que tenha as casas decimais da cobrança, exemplo: 10.00

Sobre a notificação de pagamento, você precisa registrar o endpoint vinculando ele a chave Pix que será utilizada na emissão.
Assim, todos os recebimentos que tiverem TXID irão gerar a notificão no endpoint informado.
Na nossa documentação você encontra mais detalhes sobre a configuração do webhook: https://dev.efipay.com.br/docs/api-pix/webhooks

Bom dia, @.andregomes!
Neste caso, você pode consumir diretamente os endpoints.
1- Faz a autenticação na API: https://dev.efipay.com.br/docs/api-pix/credenciais/#obter-autorização
2-Cria a cobrança Pix imediada: https://dev.efipay.com.br/docs/api-pix/cobrancas-imediatas#criar-cobrança-imediata-com-txid
3-Obtêm o QR Code da cobrança gerada: https://dev.efipay.com.br/docs/api-pix/payload-locations#gerar-qrcode-de-um-location

Oi, pra confirmar se o pix foi pago seria algo assim? (não sei muito sobre isso, to aprendendo e usei o GPT pra criar o código.)

app.post('/webhook(/pix)?', async (req, res) => {

try {
// Consultar a cobrança usando o txid
const response = await axios.get(/v2/cob/:txid, {
headers: {
Authorization: 'Bearer' + process.env.GN_CLIENT_ID // Substitua pelo token de autorização correto
}
});

// Verificar o status da cobrança na resposta
if (response.status === 200 && response.data.status === 'CONCLUIDA') {

// Enviar o código de ativação para o Supabase
const { data: insertedData, error } = await supabaseClient
.from('dominios_permitidos')
.insert([{ code: generatedCode }]); // Acesse o código gerado na rota '/api/key'

// Enviar o código de ativação junto com a resposta
return res.status(200).json({ message: 'Webhook recebido com sucesso.', code: generatedCode });
} else {
// Se a cobrança não estiver concluída, retorne uma mensagem de erro
return res.status(400).json({ error: 'Cobrança não concluída.' });
}
} catch (error) {
console.error('Erro ao consultar a cobrança:', error.message);
return res.status(500).json({ error: 'Erro ao consultar a cobrança.' });
}

});

Entao, no meu caso, eu devo usar a API Pix -> Cobrança Imediata?

https://dev.efipay.com.br/docs/api-pix/cobrancas-imediatas

Ah sim, @alber_abreu
Nesse cenário, as cobranças emitidas dentro da Efí não se comunicam diretamente com a API. Será necessário desenvolver uma solução que registre essas informações e as disponibilize para seus clientes por meio do aplicativo.

Não há custos associados à utilização da API, @neurizin
As tarifas são cobradas apenas quando ocorre o pagamento de uma cobrança.
Ou seja, você pode utilizar a API livremente, mas uma tarifa será deduzida somente quando uma cobrança emitida por ela for paga.

Boa tarde, @andrebarbosa_dev! O Location contém um JSON com os dados referentes a uma cobrança PIX, ao utilizar os endpoints de emissão de cobrança PIX (COB ou COBV) automaticamente será criado um location. Contudo, é possível criar esse location primeiro pelo endpoint POST /v2/loc e passar o ID do mesmo na requisição da emissão de cobrança depois, como se fosse um Two-Step.

Consegue sim. Se for cobrança Pix:
https://dev.efipay.com.br/docs/api-pix/split-de-pagamento-pix

Desculpe, Alexandre! Não entendi sua dúvida. Possuímos um endpoint (GET /v2/loc/:id/qrcode) que permite gerar o qrcode de uma cobrança Pix a partir do id da location. Você está utilizando este endpoint? https://dev.efipay.com.br/docs/api-pix/payload-locations#gerar-qrcode-de-um-location

Em dev não reconhecer mesmo o QR-Code, pq ele não é de produção...

20 mil requisições você diz cobranças ou chamadas de API ? A gente recebe umas 5 mil cobranças por dia corriqueiramente... e acho que tem gente com mais volume do que isso na Efí. Chamadas de API para isso deve estar em 30 mil reqs/dia.

Boa tarde, tudo bem ? Nesse cenário, você precisa emitir a cobrança, mas ainda não definiu os destinatários. Nesse caso, é necessário realizar a divisão após o pagamento. Uma abordagem eficaz seria criar uma carteira com o saldo do motorista . Isso centralizaria o recebimento em uma única conta, possibilitando a retirada posterior do saldo pelo motorista. Nós oferecemos um endpoint para envio de PIX, permitindo que o motorista faça o saque via PIX: https://dev.efipay.com.br/docs/api-pix/gestao-de-pix#requisitar-envio-de-pix