Histórico de mensagens sobre idEnvio

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 ?