Histórico de mensagens sobre CONSULTAR PIX

Bom dia, @darllan199733. Tudo bem?
Não temos um endpoint de API que permita a consulta de chave Pix. Se você deseja validar uma chave Pix para fazer transferências para ela, é importante saber que consultar a chave antes de enviar o Pix não é muito seguro. Isso porque a chave pode ser excluída ou transferida para outro titular a qualquer momento. A única exceção é a chave do tipo CPF ou CNPJ, que só pode estar associada a contas vinculadas a esse documento. Ou seja, se validar uma chave agora, pouco depois pode não ser mais válida.

Se você deseja então fazer transferências para uma chave, pode usar nosso endpoint. E a melhor opção é validar a chave informando o CPF/CNPJ e a chave __no momento do envio do Pix__, usando o endpoint PUT /v2/gn/pix/:idEnvio. Dessa forma, nossa API verifica, no momento do envio, se a chave Pix pertence ao titular do documento informado. Se não pertencer, o envio é recusado.

Bom dia, @excarplex_27431! Tudo bem?
1. Para configurar um split de pagamento em uma cobrança Pix, você precisará seguir alguns passos específicos e utilizar os endpoints adequados da API. Aqui está um resumo das informações para te orientar:
1.1. Configuração do Split de Pagamento:
Primeiro, é necessário criar uma configuração de split. Isso é feito através do endpoint específico para configuração de split, disponível aqui. Esta configuração pode ser reutilizada em múltiplas cobranças Pix, o que facilita o processo se você tiver uma estrutura de split recorrente.
1.2. Criação da Cobrança Pix:
Após configurar o split, o próximo passo é criar a cobrança Pix. Isso pode ser feito de duas maneiras, dependendo do tipo de cobrança:
1.2.1. Cobrança Imediata: Utilize o endpoint para criar uma cobrança imediata com um TXID, disponível aqui.
1.2.2Cobrança com Vencimento: Se a cobrança tiver vencimento, utilize este endpoint.
1.3. Associação da Configuração de Split à Cobrança Pix:
Com a cobrança Pix criada, você precisará associar a configuração de split à cobrança. Isso é feito através do endpoint específico para vinculação de cobrança com split, disponível aqui.
Além disso, para melhor compreensão do processo de split de pagamento, você pode consultar o fluxograma disponível neste link.


2. O Split de pagamento Pix só pode ser realizado entre contas Efí, com limite máximo de 20 contas para o repasse.


3. Para configurar o webhook, você precisará fazer isso através de uma requisição HTTP utilizando o endpoint específico fornecido pela Efí. Esse processo envolve associar uma chave Pix registrada na sua conta Efí, que é a mesma chave que será utilizada na criação da cobrança, à URL de retorno da sua aplicação.
Você pode seguir o passo a passo detalhado na nossa documentação sobre webhooks. Lá, você encontrará o endpoint que deve ser utilizado para essa configuração.
Além disso, é essencial que você configure o mTLS (Mutual TLS) no seu servidor web para garantir que a comunicação siga os padrões de segurança estabelecidos. Mais detalhes sobre essa configuração podem ser encontrados na seção sobre mTLS na nossa documentação.

Se precisar de mais ajuda, conte com a gente!

Boa tarde, existe um endpoint para consultar um pix antes de efetuar um pagamento?

Por exemplo, ao informar a chave pix 11993417695 gostaria de obter as informações do recebedor

Existe um end point para consultar os dados do proprietário da chave pix, assim como é feito no app…como forma de validação/confirmação?

boa Tarde...
estou tentando consultar um pix pelo TXID, tentei pelo /v2/cob/:txid e estou recebendo erro 400 ('Erro interno do servidor')
alguem pode me dar um caminho para enterder oq está errado?

Boa tarde, @bartwitch! Tudo bem?
Você pode consultar mais informações sobre o Pix Recorrente, acessando: https://sejaefi.com.br/efi-pay/pix-automatico
Nesta página existe um botão "Quero participar do lançamento" onde você consegue se inscrever para participar do lançamento.

Boa tarde,

Ao consultar o status de um cobranca (GET /v1/charge/:id) e esta estiver paga, não tem como saber se o pagamento foi feito via código de barras ou PIX (QrCode) ?
Porque preciso dessa informação para relatórios gerenciais da empresa. No IUGU por exemplo, ao consultar uma cobrança vem como method: iugu_bank_slip ou iugu_pix, no Efí está vindo tudo como banking_billet

Obrigado

Bom dia, @francinaldo0632! Tudo bem?
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.

na verdade eu gostaria de algum endpoint em que minha aplicaçao pudesse consultar os pix pagos no dia tem como isso, no caso eu nao preciso de webhook pra verificar o pagamento de forma instantanea?

teria alguma rota em que eu passase alguem paremetro de data para consultar os pix pagos, comsnte isso já me ajudava aqui, sem precisar desse webhook?

Se eu gerei um PIX, enviei a um cliente, e depois consultei Endpoint para consultar vários Pix recebidos, e ele estiver lá, isso indica que ele foi pago ?

@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.

Bom dia, @amunhoz. Tudo bem com você?
- Você está perguntando sobre a permissão de uso da API depois de criar a aplicação na conta Efí? Nesse caso, a permissão é instantânea. Assim que você cria a aplicação, já pode usar a API.
- Na nossa documentação, em todos os endpoints, você vai encontrar um botão Consultar atributos. Nele, você verá todos os detalhes. Para o valor, deve ser uma string seguindo a regex \d{1,10}\.\d{2}, com os centavos separados por um "ponto" ..

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

É possivel consultar somente as informações das ultimas 24 horas da API Pix dentro da conta digital. .

achei o problema!

para requisições cob: criar, consultar, cancelar e pix: consultar estou fazendo assim e esta funcionando: ContentType := 'application/json; application/x-www-form-urlencoded; charset=UTF-8;';

para o solicitação de devolução de pix so funcionou assim: ContentType := 'application/json';

Boa tarde, @raphas9! Tudo bem?

Sim, ao consultar uma cobrança via API, o status da cobrança é retornado. Quando a cobrança está paga, o status retornado é "CONCLUÍDA".
Quanto à devolução, as informações sobre ela são retornadas. Em nossa documentação, há um exemplo de JSON retornado quando ocorre uma devolução:

Olá pessoal tudo bem. Não tenho cadastro na efi ainda mais gostaria de sabem se alguém consegue me tirar uma dúvida. A efi consegue me disponibilizar api para que eu possa consultar se uma determina chave pix está castrada ou não em algum lugar ?

Existe sim API de extrato (https://dev.efipay.com.br/docs/api-pix/endpoints-exclusivos-efi#requisitar-extrato-concilia%C3%A7%C3%A3o) e mesmo a lista de Pix de https://dev.efipay.com.br/docs/api-pix/gestao-de-pix#consultar-pix-recebidos já costuma resolver. Mas eu acho melhor barrar a recepção de Pix fora dos QR-Code gerados, aí você garante que não tem nada para conciliar manualmente.