Termos mais procurados:
Entendi. Para essa situação, você pode usar a opção de envio de Pix através do endpoint PUT /v2/gn/pix/:idEnvio. Com este recurso, você pode enviar valores para a chave Pix ou os dados bancários do destinatário. No entanto, ao usar essa função, todo o controle de split deve ser realizado em sua própria aplicação.
Olá, @jjrkkj! Esse atributo é muito tranquilo de lidar! Você pode usar diversas formas desde que se atenha de que ele deve ser alfanumérico e ter de 1 a 35 caracteres. Neste sentido, você pode estabelecer regras e composições próprias como incremento automático ou fórmulas (e.g. ID interno do cliente + "textoestático" + identificador da cobrança).
Um exemplo:
Sou o cliente 76452 da empresa "Muito Legal LDTA" que estou na minha 20ª cobrança, você poderia estabelecer algo como:
idEnvio : "MLxxC00076452xxP0000020"
Neste exemplo o ML foi a abreviatura da empresa, os xx foram apenas para separar as identificações, C de Cliente, P de PIX, os zeros para "encher" um pseudolimite de identificação, o 76452 o id de cliente e o 20 um id de cobrança para o cliente em específico.
Lembrando que este é só um exemplo de possibilidade 😁
Vou utilizar a api de envio de pix: "/v2/gn/pix/:idEnvio". Neste caso, "idEnvio" seria um txid que eu deveria criar, certo? Como eu o crio e como eu faço para ele ser único e evitar repetições? Vi em um comentário mais pra cima de alguem recomendanod utilizar epoch do momento do envio, mas poderia ter repetições dessa forma caso a requisição do pix fosse enviada no mesmo momento... E outra dúvida: o que aconteceria se fosse criado um mesmo idEnvio?
Bom dia, @jhon0029. Como vai?
Para solicitar o envio de Pix via API, aqui estão as informações necessárias:
Em produção, utilize a seguinte rota base: https://pix.api.efipay.com.br
Para testes em ambiente de homologação, utilize a seguinte rota base: https://pix-h.api.efipay.com.br
O endpoint que você precisa usar é PUT /v2/gn/pix/:idEnvio, onde :idEnvio é o Identificador da transação criado por seu sistema seguindo a regex ^[a-zA-Z0-9]{1,35}$.
Pontuando que, para enviar Pix em produção, é necessário preencher este formulário.
Em homologação, você pode realizar testes seguindo as intruções detalhadas em nossa documentação técnica.
Qualquer dúvida, conte com a gente!
Como eu confirmo um envio feito usando /v2/gn/pix/:idEnvio ?
/v2/gn/pix/:idEnvio
Boa noite! Estou tentando fazer uma chamada para esse endpoint
Tem sim.
https://dev.efipay.com.br/docs/api-pix/gestao-de-pix#consultar-pix-enviado-atrav%C3%A9s-do-endtoendid
Tem 3 endpoints na verdade:
- Consultar um Pix enviado pelo idEnvio
- Consultar um Pix enviado pelo E2EID
- Lista de Pix
pergunta: para fazer envio de pix com PUT /v2/gn/pix/:idEnvio,
em Homologação, a chave do favorecido tem que ser o quê ? eu tentei chaves pix reais mas nao funciona. Eu tenho a minha chave pessoal da EFI, mas ela ja foi utilizada como chave do pagador. Devo criar uma nova chave em algum lugar ?
Liberaçao da API Pix envio (https://pix.api.efipay.com.br/v2/gn/pix/:idEnvio) é apenas pelo e-mail: [email protected]?
Uma última dúvida. E esse o endpoit para envio direto ?
/v2/gn/pix/:idEnvio
entendi a parte da chave do pagador. o idEnvio e o txid me confundiram um pouco. eu posso gerar uma string aleatoria é isso?
idEnvio é um ID único que você precisa criar. É o primo envio do txid para recebimento.
Chave do pagador é sua própria chave da Efí, mas minha recomendação é criar uma chave só para isso, para facilitar diferenciar no webhook.
o que é o parâmetro idEnvio?
e a chave do pagador, no caso seria a minha própria chave da Efí?
Bom dia, @leonammoura. Tudo bem?
Nossa API só permite criar cobranças para chaves Pix registradas em contas Efí. Seus clientes tendo conta na conosco, você pode configurar as credenciais de integração da conta deles para gera as cobranças em sua aplicação.
Outra opção seria você ter uma conta "Pulmão" onde todos os pagamentos são recebidos e gerenciados por sua aplicação, e depois você utilizar o endpoint PUT /v2/gn/pix/:idEnvio para requisitar envio de Pix para a chave Pix do seu cliente que pode estar registrada em qualquer banco.
Oi, @pedrinne. Bom dia! Como vai?
A melhor opção é fazer mesmo 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, nossa API verifica se a chave Pix pertence ao titular do documento informado, se não for, o envio é recusado.
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.
Para ter certeza de que a chave é 'daquela pessoa', você pode exigir que a chave seja do tipo CPF ou CNPJ, assim como a Receita faz para enviar a restituição do IR, por exemplo. Nesse caso, você pode usar uma API para checar se o documento existe e depois fazer o envio. Se o envio não for efetivado, significa que a chave CPF/CNPJ não está registrada em nenhum banco, então poderia notificar o seu cliente sobre.
mas como eu vou passar esse parametro, se o gerencianet nao vai reconhecer o idEnvio que eu vou enviar?
Outra dúvida, aqui não tenho o envio, só to enxergando requisitar envio de pix, e nele requer passar o parametro idEnvio
Bom dia, @alissonmaciel_32335. Tudo bem?
O idEnvio é o identificador da transação que deve ser gerado por sua aplicação. Ele deve atender a seguinte regex ^[a-zA-Z0-9]{1,35}$
