Histórico de mensagens sobre Recebimento | Canal sugestões | Página 1

francisco.carvalho

18/02/2021

@everyone gostaria da opinião de vocês sobre "Reenvio de Pix", após um recebimento da API Pix.
Mais detalhes aqui: https://www.notion.so/Retransmiss-o-de-Pix-Recebido-f6662ae376a04bd6a177177522bb3998

rubenskuhl

15/02/2021

API de Cobrança. Daria para conciliar recebimentos, não pagamentos. No caso de envio de Pix se você fizer por banco/conta/CPF já vai saber para quem foi, mas por Chave Pix não. E imagino que seja esse o problema.

anoni_mato

21/01/2021

Sugestão: alinhar melhor com a equipe as informações a respeito dos [novos] recursos e exigências [removidas] para consumo da API Pix. Por ex: as informações a respeito da necessidade ou não de mTLS no PUT /webhook, bem como no recebimento dos callbacks, estão desencontradas lá no canal <#❖pix>. Tem membros da equipe GN dizendo A e outros membros dizendo B.

francisco.carvalho

12/01/2021

## Objetivo

Permitir que o EC defina algumas configurações:

- Quando aceitar um txid;
- Aceitar ou não Pix Manual;
- Quais notificações receber via webhooks;
- Receber ou não a tarifa no webhook;
- Outras configurações podem surgir.

---

# PUT /gn/config

## Input

json
{
"pix": {
"aceitarSemChave": true,
"chaves": [{
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "^[a-zA-Z0-9]+$"
}
}, {
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": false,
"recusa": false
}
}
}]
}
}

## Output: 200

---

## Definições

Por default:
→ Todas as notificações nascem habilitadas;
→ Não há match de regex: aceita-se qualquer txid;
→ Tarifa não é retornada no webhook;
→ Pix Manual é acatado sempre;

Default em JSON

json

{
"pix": {
"aceitarSemChave": true,
"chaves": [{
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "" // se vazio, desconsiderar
}
}]
}

francisco.carvalho

{
"pix": {
"recebimentoManual": "aceitar",
"chaves": [{
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "^[a-zA-Z0-9]+$"
}
}, {
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": false,
"recusa": false
}
}
}]
}
}

Definições:

Por default:
- Todas as notificações nascem habilitadas;
- Não há match de regex: aceita-se qualquer txid;
- Tarifa não é retornada;
- Pix Manual é acatado sempre;

Default em JSON

{
"pix": {
"recebimentoManual": "aceitar",
"chaves": [{
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "" // se vazio, desconsiderar
}
}]
}

Observação
Quando de um envio de Pix: a notificação de webhook, em caso de status NAO_REALIZADO , poderá trazer o motivo da falha (PSP deu timeout, recusou, etc..). Em outro momento falaremos disso.

joelemanoel

12/01/2021

Não seria interessante o recebimentoManual poder ser definido como true ou false?

francisco.carvalho

12/01/2021

{
"pix": {
"recebimentoManual": "aceitar",
"chaves": [{
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "^[a-zA-Z0-9]+$"
}
}, {
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": false,
"recusa": false
}
}
}]
}
}

Definições:

Por default:
- Todas as notificações nascem habilitadas;
- Não há match de regex: aceita-se qualquer txid;
- Tarifa não é retornada;
- Pix Manual é acatado sempre;

Default em JSON

{
"pix": {
"recebimentoManual": "aceitar",
"chaves": [{
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "" // se vazio, desconsiderar
}
}]
}

Observação
Quando de um envio de Pix: a notificação de webhook, em caso de status NAO_REALIZADO , poderá trazer o motivo da falha (PSP deu timeout, recusou, etc..). Em outro momento falaremos disso.

oleoessencial

12/01/2021

Para já saber exatamente o status da cobrança, e poder tambem consultar o txid confirmando esta mudança de status. Seria um tiro de alerta a mudança de status. Para disparar a validação do recebimento da cobrança em si.

oleoessencial

12/01/2021

Minha duvida é voltaremos a ter o status da cobrança por opção de recebimento ?

francisco.carvalho

12/01/2021

Atualizando:

PUT /gn/config

{
"pix": [{
"chave": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "^[a-zA-Z0-9]+$"
}
}, {
"chave": "[email protected]",
"webhook": {
"notificar": {
"envio": false,
"recebimento": false,
"devolucao": false,
"recusa": false
},
"incluir": {
"tarifa": false
}
},
"recebimento": {
"txidRegex": "^[a-zA-Z0-9]+$"
}
}]
}

francisco.carvalho

12/01/2021

Até então estamos assim:

PUT /gn/config

{
"pix": {
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "^[a-zA-Z0-9]+$"
}
}
}

- Próxima alteração: tratar configurações por chave;
- <@!293443355915059210> esse endpoint, de fato, não substitui, posteriormente, um painel em uma UI autenticada;
- <@!440035527127990273> de fato, esse endpoint precisará de um escopo específico. Podemos pensar também em um mecanismo de autenticação de 2 fatores;

anoni_mato

12/01/2021

inclusive a validação por regex, que numa UI poderia ter opções do tipo:
- "não validar regex (aceitar qualquer transação)" equivalente a .;
- "não aceitar recebimentos sem txid" equivalente a .+;
- "validar com o seguinte regex:" que abriria um campo pra fornecer o regex a ser testado

anoni_mato

11/01/2021

eu também padronizaria tudo pro singular. webhook, tarifa, recebimento

joelemanoel

11/01/2021

Aqui eu não utilizo nenhum dos webhooks a não ser de recebimento, então pra mim faz sentido sim.

francisco.carvalho

11/01/2021

Observem que coloquei um atributo webhooks.notificar.devolucao.
Faz sentido pra vocês optar por ser notificado de um recebimento e não de uma devolução? 🤔

francisco.carvalho

11/01/2021

E o input está ficando assim:

{
"pix": {
"webhooks": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifas": true
}
},
"recebimentos": {
"txidRegex": "^[a-zA-Z0-9]+$"
}
}
}

francisco.carvalho

11/01/2021

Ficou bom!

Dentro de recebimentos, seria bacana deixar claro que a regex será aplicada ao txid..

"txIdRegex": "^[a-zA-Z0-9]+$"

// desculpem, o padrão até então é camelCase, na proposta acabei enviando com hífen 😅

anoni_mato

11/01/2021

<@!793123559874494465> que tal assim?

{
"pix": {
"webhooks": {
"notificar": {
"envio": true,
"recebimento": true,
"recusa": true
},
"incluir": {
"tarifas": true
}
},
"recebimentos": {
"regex": "^[a-zA-Z0-9]+$"
}
}
}

francisco.carvalho

11/01/2021

Pessoal, gostaria de opiniões e sugestões em cima desse desenho de endpoint:

PUT /config

Objetivo: permitir que o integrador controle alguns comportamentos. Por hora: receber ou não webhooks, receber ou não a tarifa cobrada como atributo na notificação do webhook, setar uma regex que será considerada na validação do txid.

{
"pix": {
"webhooks": {
"notificar": {
"envio": true,
"recebimento": true,
"recusa": true
}
},

"tarifas": {
"informar-no-webhook": true
},

"pagamentos": {
"validar-txid-regexp": "^[a-zA-Z0-9]+$"
}
}
}

rubenskuhl

29/12/2020

Sugestões para a parte de marketplace:(https://gerencianet.com.br/solucoes/#marketplace)
- Opção de repassar por Pix ao invés de só para contas Gerencianet independente do modo de pagamento
- Opção de fazer split também de recebimento Pix, usando os métodos discutidos no GitHub do BACEN para maior proximidade de um possível padrão futuro

matheus_efi

03/12/2020

O Banco Central disponibilizou apenas a API de recebimentos no momento e como estamos seguindo o padrão do BC a api de pagamentos ainda não está disponível.

Histórico de mensagens sobre Recebimento em sugestões

CONECTAR AO DISCORD

PROCURE NO HISTÓRICO

CANAIS DE TEXTO

DISCUSSÕES

EXIBINDO CONVERSAS RECENTES:

francisco.carvalho

rubenskuhl

anoni_mato

francisco.carvalho

joelemanoel

francisco.carvalho

oleoessencial

oleoessencial

francisco.carvalho

francisco.carvalho

anoni_mato

anoni_mato

joelemanoel

francisco.carvalho

francisco.carvalho

francisco.carvalho

anoni_mato

francisco.carvalho

rubenskuhl

matheus_efi