Histórico de mensagens sobre idEnvio

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.

Boa noite, para separar a resposta do webhoook

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 do pix enviado:
{
"pix": [
{
"endToEndId": "E090893562021030PIf25a7868",
"chave": "2c3c7441-b91e-4982-3c25-6105581e18ae",
"tipo": "SOLICITACAO",
"status": "REALIZADO",
"valor": "0.01",
"horario": "2021-03-04T20:39:47.000Z",
"gnExtras": {
"idEnvio": "123ABC"
}
}
]
}

utiliza o campo gnExtras.idEnvio para diferencia-los , ok?

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.

Boa tarde, @cascaes_. Tudo bem?
Isso mesmo. O endpoint PUT /v2/gn/pix/:idEnvio permite enviar valores da sua conta Efí para uma chave Pix. O parâmetro idEnvio deve ser gerado pelo seu sistema seguindo a regex ^[a-zA-Z0-9]{1,35}$ e precisa ser único para cada envio na sua conta.

Olhei na documentação, o que não ficou claro no “ /v2/gn/pix/:idEnvio” é o :idEnvio - esse idEnvio, eu invento/crio/gero, isso?

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.

Boa tarde, @esdrasfyy! Tudo bem?
Isso mesmo, a rota para realizar transferências Pix via API é a PUT /v2/gn/pix/:idEnvio, onde o :idEnvio é um id unico que você precisa informar para a transferência.

Para habilitar o endpoint de Envio de Pix em produção, é necessário preencher este formulário: https://www.cognitoforms.com/GerencianetPagamentos1/Formul%C3%A1rioDeSolicita%C3%A7%C3%A3oDePermiss%C3%A3oParaEnvioDeValoresPixViaAPI
Após o preenchimento, basta aguardar que entraremos em contato.

Estou precisando configura o hook de resposta do envio de pagamento pix, no momento que entrego ja recebo , "idEnvio": "15IDdist",
"e2eId": "E09089356202407101939API40c3ddad",
"valor": "0.01",
"horario": {
"solicitacao": "2024-07-10T19:39:34.356Z"
},
"status": "EM_PROCESSAMENTO", o problema que preciso atulizar o status depois no hooks so esta vindo "2024-07-10 17:45 # {"evento":"teste_webhook","data_criacao":"2024-07-10T20:45:45.343Z"}

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.

@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)
}
}
}

Uma duvida no ambiente de sandbox para o a rota: https://pix-h.api.efipay.com.br/v2/gn/pix/:idEnvio

tem algum cpf que posso colocar que ele entende como valido da conta?

{
"valor": "5.00",
"pagador": {
"chave": "50925568000191",
"infoPagador": "Segue o pagamento da conta"
},
"favorecido": {
"chave": "[email protected]",
"cpf": "58629188090"
}
}

exemplo:
do erro enviado:

{
"nome": "chave_nao_pertence_ao_documento",
"mensagem": "O cpf do favorecido é diferente do documento em posse da chave"
}

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