Histórico de mensagens sobre idEnvio em pix

Bom dia, @ricardoquintino_10790.
Não temos um endpoint de API para consultar a chave Pix. É importante destacar que consultar a chave Pix sem fazer uma transferência imediatamente pode não ser seguro. Isso acontece porque a chave pode ser excluída ou transferida para outro titular a qualquer momento. A única exceção são as chaves do tipo CPF ou CNPJ, que só podem estar associadas às contas vinculadas ao respectivo documento. Ou seja, validar uma chave agora não garante que ela continue válida logo em seguida.

Se você deseja realizar uma transferência para uma chave Pix, recomendamos usar nosso endpoint. A melhor prática é validar a chave informando o CPF/CNPJ e a chave __no momento do envio do Pix__, usando o endpoint PUT /v2/gn/pix/:idEnvio. Nesse processo, nossa API verifica se a chave Pix pertence ao titular do documento informado no momento da transação. Caso contrário, a transferência é recusada.

Na verdade, você deseja saber sobre o status, correto? Ao realizar o envio de Pix, o status seria esse mesmo (EM_PROCESSAMENTO), mas se você consumir o endpoint GET /v2/gn/pix/enviados/id-envio/:idEnvio passando o idEnvio, você perceberá que o status será REALIZADO.

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.

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

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.

Bom dia, @lostbean79. Como vai?
Como mencionado pelo Rubens, a Efí disponibiliza o endpoint de envio de Pix via API, que lhe permite a transferência de valores para determinada chave Pix e ou conta bancária. 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!

Na primeira request, você ja precisa definir esse idEnvio.

mas logo na primeira request posso fazer isso? pq como é uma rota do tipo PUT, da a entender que esse idEnvio é algo que ja esta previamente criado

Bom dia @jonadabir ! É através desse endpoint sim. O idEnvio é o identificador da transação que você vai definir, seguindo a regex ^[a-zA-Z0-9]{1,35}$.

Bom dia! Para enviar um pix, é atraves desse endpoint aqui /v2/gn/pix/:idEnvio? Se for, o que é o idEnvio?

A requisição não esta enviado os campos corretos, um exemplo de envio seria esse aqui:

import as EfiPay from 'sdk-node-apis-efi'

import { Injectable } from '@nestjs/common'

import 'dotenv/config'

@Injectable()
export class PixService {
private efiPay = new EfiPay({
sandbox: false,
client_id: process.env.EFIPAY_CLIENT_ID,
client_secret: process.env.EFIPAY_CLIENT_SECRET,
certificate: './certs/producao-453290-LinkZap-v2.p12',
})

constructor() {
//
}

public async getBalance() {
const { saldo } = await this.efiPay.getAccountBalance()
return Number(saldo)
}

public async payPix(pixCode: string, amount: number) {
const balance = await this.getBalance()
if (balance < amount) {
throw new Error('Saldo insuficiente')
}

try {
const response = await this.efiPay.pixSend(
{ idEnvio: '01' },
{
valor: amount,
pagador: {
chave: 'a4c3dcd3-0005-454e-957f-df416a63c4ed',
},
favorecido: {
chave: pixCode,
},
},
)
return response
} catch (error) {
console.log(error)
}
}
}

Bom dia, para realizar teste no meu webhook, devo utilizar a api /v2/gn/pix/:idEnvio
correto ?

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?

Boa noite! Estou tentando fazer uma chamada para esse endpoint

e me retorna esse erro