Histórico de mensagens sobre pix

<#Falha Pix-8419>

Boa tarde, @lucianoolegario_57079! Tudo bem?
O cadastro da URL é feito em outro endpoint: PUT /v2/webhook/:chave
Você pode consultar mais informações em nossa documentação: https://dev.efipay.com.br/docs/api-pix/webhooks

Boa tarde, @lucianoolegario_57079 ! Tudo bem? Quando você ou o seu sistema faz uma solicitação para gerar um QR Code, nossa API recebe essa requisição contendo as informações necessárias. Com base nos dados enviados, a API processa a solicitação, gera o QR Code e devolve o resultado na resposta da requisição. Esse QR Code estará pronto para ser exibido ou utilizado diretamente no seu sistema.

Também contamos com um sistema de notificações em tempo real utilizando webhooks. O webhook é responsável por avisar o seu sistema sempre que identificamos o pagamento de uma cobrança PIX.

Funciona assim: após o QR Code ser gerado e enviado para o cliente final, o nosso sistema monitora automaticamente o pagamento dessa cobrança. Assim que o pagamento é confirmado, enviamos uma notificação para a URL que você definiu, contendo todas as informações do pagamento.

uma duvida, a roda de envio de pix ja funciona ao possuir conta empresarial

Tudo bem também!
Beleza! Um detalhe, é que as notificações de Pix são enviadas para a URL registrada com um /pix no final. Ou seja, se você registrou a URL https://seudominio.com.br/webhook/, a notificação será enviada para https://seudominio.com.br/webhook/pix. Então, você precisa tratar essa rota /webhook/pix na sua aplicação

Outra opção é cadastrar a URL do webhook com um query param para ignorar a adição do /pix, assim:https://seudominio.com.br/webhook/?ignorar=

Tudo bem e você? Como esta?

Quando cadastro a url do webhook recebo esse evento de teste:

{
"evento": "teste_webhook",
"data_criacao": "2025-01-08T12:10:23.151Z"
},

Porém, quando realizo um teste, enviando uma solicitação de envio de pix(exemplo da doc não associado a um txid) eu não recebo nenhuma notificação sobre.
Estou usando o sdk php em uma aplicação Laravel 9.

Bom dia, @aguinelequeiroz! Como vai?
Sim, você recebe o callback. Para enviar Pix via API, é obrigatório ter o webhook cadastrado. Assim, sempre que uma solicitação de envio for feita, seu sistema receberá uma notificação com a confirmação ou recusa da transação.

Confira o exemplo na nossa documentação: https://dev.efipay.com.br/docs/api-pix/webhooks#requisi%C3%A7%C3%A3o

Bom dia,

Quando faço uma solicitação de envio de pix na API eu recebo uma callback no webhook, caso ele esteja configurado? Ou para envio de pix não há callbacks via webhook?

Bom dia, @bras6379_26227! Tudo certo?

Não necessariamente precisa de biblioteca para gerar o QR Code Pix.
Quando você cria uma cobrança Pix, recebe um JSON com as informações. Nesse JSON, tem o campo loc.id.

Depois, é só chamar o endpoint GET /v2/loc/:id/qrcode passando o loc.id da cobrança. O retorno traz os parâmetros qrcode, imagemQrcode e linkVisualizacao.

Agora é só usar o valor do parâmetro imagemQrcode para exibir o QR Code no HTML, assim:

html

ah pelo que estou vendo aqui a Efi gera apenas o Pix CopiaECola e ai no frontend devemos usar outra biblioteca pra gerar o qrcode?

não da para fazer o pix

quando tenta fazer um pix pelo site e contém _ na chave pix, ele é removido automaticamente

Pessoal, outra duvida por favor. Estou tentando pegar a imagem do pix qrcode mas esta dando {'error': 'insufficient_scope', 'error_description': 'Access token has insufficient scope'}

No entanto todos os escopos do Pix estao habilitados na minha API (imagem anexada). Qual scopo esse endpoint para detalhar o pix se refere?

credentials = {
'client_id': '',
'client_secret': '',
'sandbox': False,
'certificate': ''
}

efi = EfiPay(credentials)

body = {
"pixCopiaECola": ""
}

response = efi.pix_qrcode_detail(body=body)

Pessoal, como eu posso correlacionar o webhook de pix pago com o pix que eu gerei inicialmente? existe um id unico pra esse pix que eu posso usar pra correlacionar o pix copia e cola gerado com o pix pago? mt obrigado desde ja!
Seria esse o txid?

A documentacao mostra esse payload do webhook:
// Pix recebido
{
"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"
}
]
}

E esse payload do pix gerado
{
"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",
"pixCopiaECola": "00020101021226830014BR.GOV.BCB.PIX2561qrcodespix.sejaefi.com.br/v2/41e0badf811a4ce6ad8a80b306821fce5204000053000065802BR5905EFISA6008SAOPAULO6007050361040000"
}

é a chave Pix cadastrada na conta emissora das cobranças, a conta em que você obteve o client_id e client_secret

em suma é a chave PIX de cada recebedor.. cnpj, cpf, email, etc

seria sua chave Pix cadastrada na conta Efí onde vai receber os pagamentos!

e de azul são pagamentos pix, que saem da sua conta

É isso mesmo @brandao0702, verdes são as cobranças pix, que você recebe na sua conta

ou tudo que taí em PIX é contas a receber?