.clsantos

Sep 20, 2024

Utilização de Webhook para Atualizar Status de Cobranças Pix

.clsantos · 2024-09-20T17:11:41.000Z

Discussão sobre como utilizar webhooks para atualizar o status de cobranças via Pix, abordando exemplos de notificações e esclarecendo dúvidas sobre a ausência de atributo status.

webhookPIXstatusnotificaçõescobrançaintegração API

Pessoal, alguém me ajuda a entender como eu posso utilizar o webhook pra atualizar o status da cobrança gerada via Pix. Eu só preciso acompanhar o status, mas não consegui entender por que nem todas as notificações tem o campus status e às vezes a localização do campo status muda. Pelo que eu vi nos exemplos, uma notificação de pagamento via pix nem tem status. Alguém me ajuda?

Respostas (11):

igor_efi

20/09/2024

Boa tarde, @.clsantos! Tudo bem?
As notificações de Pix recebido não possui o atributo status. Segue alguns exemplos de notificações:

json
// 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"
}
]
}

// Pix recebido com dados do pagador
{
"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",
"gnExtras": {
"pagador": {
"nome": "GORBADOCK OLDBUCK",
"cpf": ".123.456-",
"codigoBanco":"00416968"
}
}
}
]
}
// Pix recebido com Split
{
"pix": [
{
"endToEndId": "E1803615022211340s08793XPJ",
"txid": "fc9a43k6ff384ryP5f41719",
"chave": "2c3c7441-b91e-4982-3c25-6105581e18ae",
"valor": "0.01",
"horario": "2020-12-21T13:40:34.000Z",
"infoPagador": "Teste",
"gnExtras": {
"split": {
"id": "f659e882b00440ef9f07538fb697a6b2",
"revisao": 0
}
}
}
]
}
// Pix recebido com tarifa informada
{
"pix": [
{
"endToEndId": "E1803615022211340s08793XPJ",
"txid": "fc9a43k6ff384ryP5f41719",
"chave": "2c3c7441-b91e-4982-3c25-6105581e18ae",
"valor": "0.10",
"horario": "2020-12-21T13:40:34.000Z",
"infoPagador": "pagando o pix",
"gnExtras": {
"tarifa": "0.01"
}
}
]
}

.clsantos

20/09/2024

E como eu diferencio ela das outras notificações? Eu só preciso saber quando foi pago o pix. Porque o risco é eu atualizar o status pra CONCLUIDA e ter sido alguma outra notificação que eu desconheça, não a de pagamento

igor_efi

20/09/2024

Quais outras? As notificações de recebimento são enviadas somente quando ocorre a confirmação da cobrança.

.clsantos

20/09/2024

Eu não sei, na documentação tem 9 possíveis status pra pix. Não sei quando acontecem e quais os formatos delas

igor_efi

20/09/2024

A notificação é enviada para você somente quando existe a confirmação de pagamento, ou quando você solicita a devolução.

igor_efi

20/09/2024

Neste link temos exemplos de todas as possiveis notificações: https://dev.efipay.com.br/docs/api-pix/webhooks#requisi%C3%A7%C3%A3o

.clsantos

20/09/2024

Nesse link tem exemplos pra 5 dos 13 status que a aba status do Pix informa. Mas, ok, vou considerar que se recebeu a notificação é porque foi paga, o que é uma péssima lógica a se implementar, mas blza.

igor_efi

20/09/2024

São variações para um mesmo status.
Na primeira aba tem as variações de uma cobrança confirmada/recebida, na segunda de uma cobrança devolvida e na terceira de envio de Pix

igor_efi

20/09/2024

As variações ocorrem de acordo com o que esta configurado na API neste endpoint: https://dev.efipay.com.br/docs/api-pix/endpoints-exclusivos-efi#criarmodificar-configura%C3%A7%C3%B5es-da-conta

.clsantos

20/09/2024

Agradeço as respostas

igor_efi

20/09/2024

Ficamos a disposição

.clsantos

Utilização de Webhook para Atualizar Status de Cobranças Pix

Respostas (11):

igor_efi

.clsantos

igor_efi

.clsantos

igor_efi

igor_efi

.clsantos

igor_efi

igor_efi

.clsantos

igor_efi

A Comunidade Efí no Discord reúne mais de 12300 desenvolvedores 👨‍💻 incríveis.

CONECTAR AO DISCORD

📰 Discussões relacionadas