Bom dia, @mikw0274! Como vai?
Para receber notificações de pagamentos via Pix, você precisa criar uma API back-end disponível em um domínio público com certificado SSL. Configure as rotas /webhook e /webhook/pix, por exemplo. Nestas rotas, você deve configurar a exigência da chave pública (mTLS) que estamos disponibilizando para garantir a autenticação mútua.

Depois de configurar essas rotas, basta consumir o endpoint PUT /v2/webhook/:chave para associar a chave Pix à URL desejada.

Se tiver mais alguma dúvida, conte com a gente!

Boa tarde @lucasfortaleza tudo certo?
Para vincular você precisa consumir o endpoint abaixo, informando a Chave e a URL a ser vinculadas
https://dev.efipay.com.br/docs/api-pix/webhooks#configurar-o-webhook-pix

Boa tarde! Gostaria de ajuda para vincular um webhook a uma chave Pix. Já tenho o webhook, a chave, as aplicações e credenciais. Só não descobri ainda como vincular o webhook à chave Pix para poder receber notificações de pagamento.

Sim, a taxa seria R$0,12.

Nossa API Open Finance é exclusivamente para recebimentos: seu cliente fará pagamentos a você via PIX Open Finance.

Com nossa API PIX, você também pode enviar valores. Basta fornecer os dados bancários do cliente final ou a chave Pix dele, juntamente com o valor que deseja retirar de sua conta.

Desculpa, só pra confirmar. Seria R$0,12 ?
Poxa, só mais uma outra pergunta. Tem o Open Finance, api de pagamentos pix. Eu consigo transferir saldo da minha conta na efi para uma chave pix de terceiro por essa api ?

Estou com problema na criação dos webhooks de pix em produção, com o crt de homologação consegui criar normalmente a webhook para a chave pix, porém quando fui criar em produção me retorna o erro

O Banco Central só permite que a Efí (ou qualquer outra IF/IP) consulte o banco de chaves Pix para fazer uma efetiva transferência.

@andersonmichel1051, não é possível consultar a chave antes de enviar. Consultar a chave antes de enviar o Pix não seria seguro, pois a chave pode ser excluída ou transferida para outro titular a qualquer momento. A única exceção é a chave do tipo CPF e CNPJ que só pode ser associada a contas com este documento.

A melhor opção é fazer a validação informando o CPF/CNPJ e a chave no momento do envio do Pix, usando o endpoint PUT /v2/gn/pix/:idEnvio. Assim, no momento do envio de Pix nossa API verifica se a chave Pix pertence ao titular do documento informado, se não for, o envio é recusado.

Obrigado pela informação Guilherme! Poderia me dizer também se existe um endpoint específico pra verificar se a chave do favorecido é válida? É que eu preciso fazer algumas operações antes de enviar o pix.

Bom dia, @andersonmichel1051! Tudo bem?
__Os envios em Homologação__ só serão confirmados ou rejeitados se for utilizada a chave [email protected]. Caso contrário, receberá este erro de chave inválida.

Para habilitar o endpoint de __Envio de Pix em produção__, é necessário preencher este formulário. Após o preenchimento, basta aguardar que nossa equipe entrará em contato.

to meio perdido rsrs, então no caso, li que da pra desligar o mTSL, com ele desligado, devo criar a rota e incluir ela através do método /v2/webhook/:chave, onde a chave á chave pix que esta sendo usada para a geração da cobrança e depois testar a resposta da api, é isso ? Desculpe o mar de perguntas, esse tipo de API Pix é nova pra mim.

A não ser que você esteja usando a API de abertura de contas, não tem pq precisar de automação para criar a chave Pix...

Sim, o txid é enviado na notificação de confirmação de pagamento junto com outras informações.
Segue um json de exemplo que é enviado para você:

pixGenerateQRCode não é a função que cria uma cobrança Pix, ela é utilizada para retornar um qrcode passando o id de um location.
Para emitir uma cobrança Pix, você precisa utilizar este exemplo:

boa tarde, também recebendo erro ao tentar gerar o qr code para o pix, o que posso estar fazendo de errado?

{
> nome: 'json_invalido',
> mensagem: 'Valores ou tipos de campo inválidos',
> erros: [
> {
> chave: 'pattern',
> caminho: '.params.id',
> mensagem: 'deve corresponder ao padrão "^[0-9]{1,32}$"'
> }
> ]
> }

aqui está o código:

const params = {
id: txid,
};

const efipay = new EfiPay(options)

await efipay.pixGenerateQRCode(params)

Boa tarde! Tudo bem? Você só pode cadastrar e remover chaves aleatórias via integração. Outros tipos de chaves precisam ser gerenciados diretamente na conta.

Como faço para receber pix na minha maquininha azulzinha caixa, com a chave pix do efi

Olá, @cesaroficial. Boa tarde! Tudo bem?
Não é possível consultar a chave antes de enviar. Consultar a chave antes de enviar o Pix não é seguro, pois a chave pode ser excluída ou transferida para outro titular a qualquer momento. A única exceção é a chave do tipo CPF e CNPJ que só pode ser associada a contas com este documento.

A melhor opção é fazer a validação informando o CPF/CNPJ e a chave no momento do envio do Pix, usando o endpoint PUT /v2/gn/pix/:idEnvio. Assim, no momento do envio de Pix nossa API verifica se a chave Pix pertence ao titular do documento informado, se não for, o envio é recusado.

Olá, boa tarde!

É possível eu consultar a existência da chave antes de realizar o envio do PIX? Se sim, quais informações retorna? Não achei nada na documentação sobre

Boa tarde, consegui registrar o webhook com uma chave aleatória (consigo listar pelo comonando pixListWebhook) porem qdo faço o pagamento usando esta chave(tamabem consigo listar os pix's enviados) não to recebendo o aviso no endpoint do webhook(nada chega). Ha alguma forma de ver o log das tentativas/erros de envio de aviso de pix feitos pela api da efi? Qualquer ajuda ou dica será bem vinda.