Histórico de mensagens sobre integrador

EXIBINDO CONVERSAS RECENTES:

Texto: integrador
# sugestões
Avatar discord do usuario rubenskuhl

rubenskuhl

Ver Respostas

Desabilitar o check mas ainda exigir mTLS nas efetivas notificações ajuda em algo o integrador com problemas em ambientes compartilhados ?

# sugestões
Avatar discord do usuario anoni_mato

anoni_mato

basicamente.. o Itaú tá usando QR estático para um cenário onde deveria estar usando dinâmico. apenas se pouparam de ter que oferecer a leitura de qr codes via payload. deixaram todos os dados da cobrança a cargo do integrador, guardando somente a associação txid <-> valor, e rejeitando o que não coincidir

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

Boa tarde @everyone, sobre à adequação do /pix no webhook, ficou definido que será feito o cadastro do webhook base pelo integrador e a adição do parâmetro /pix no POST {$request.body#/webhookUrl} pela Gerencianet no momento do disparo das requisições.
Abaixo trazemos alguns exemplos de webhook e como será a notificação:

Integrador cadastrou a url base https://gerencianet.com.br/, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/pix.
Integrador cadastrou a url base https://gerencianet.com.br/pix, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/pix/pix.
Integrador cadastrou a url base https://gerencianet.com.br/?id=0000x22, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/?id=0000x22/pix.

Seguindo então a nossa documentação o serviço será POST {$request.body#/webhookUrl}/pix.

Tal definição foi feita após analisar os feedbacks de integradores, questionamentos ao BACEN e discussões internas.
A data para deploy do novo padrão está alinhada para o dia 01/02/2021. Sendo esta arbitrada a fim de que todos os integradores da API-Pix que utilizam o serviço de webhook possam ajustar seus sistemas e aplicações, e evitar assim falhas ou mal funcionamento do serviço.

Uma sugestão é permitir o recebimento da notificação em ambos os modos: com e sem /pix. Dessa forma, quando virarmos a chave, não haverá problemas.

À medida que se aproximar da data de deploy seremos mais assíduos nas notificações. Quaisquer dúvidas estamos a disposição em nossos canais de comunicação. [ATUALIZADO]

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

Quando uma devolução é feita utilizando um id associado a outra devolução a mensagem retornada é a:

{
"nome": "devolucao_id_duplicado",
"mensagem": "O id informado já foi utilizado em outra devolução"
}
Assim fica mais fácil do integrador identificar a falha e realizar a correção.

# pix
Avatar discord do usuario anoni_mato

anoni_mato

Ver Respostas

Não entendi esta:

Integrador cadastrou a url base https://gerencianet.com.br/?id=0000x22, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/pix?id=0000x22

A possibilidade mais simples de contornar a concatenação do /pix que a documentação força é justamente colocar um ?x= ao fim da URL para ficar ?x=/pix.

então pergunto:

1. qual a razão para agregar o /pix "no meio" da URL que foi definida pelo integrador e não no fim?
2. isso vai contra a documentação atual que diz que o /pix irá (sempre) no fim da URL - e se for pra mudar o conceito, seria melhor que esse /pix fosse retirado.

e sugiro aos integradores que estão lendo agora: não usem query params na URL do webhook conforme esse exemplo (prefiram path params)

# pix
Avatar discord do usuario flaviolenz

flaviolenz

Os dois usando o mesmo integrador

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Essa mesma falha aconteceu com um outro integrador e é relativo ao sistema não conseguir acessar o certificado, no caso foi no windows também

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Essa mesma falha apareceu para um integrador ontem e o fato de ter um no key found está relacionado ao diretório

# sugestões
Avatar discord do usuario francisco.carvalho

francisco.carvalho

Ver Respostas

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]+$"
}
}
}

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

Boa tarde Paula! O nosso callback foi alterado para o padrão do BACEN, nas futuras modificações avisaremos com antecedência para que os integradores possam ajustar o sistema ao novo padrão. Exemplo de callback de Pix recebido atualmente:

//Pix recebido
{ pix:
[ { endToEndId: 'E1803615022211340s08793XPJ',
txid: 'fc9a43k6ff384ryP5f41719',
valor: '0.01',
horario: '2020-12-21T13:40:34.000Z',
infoPagador: 'pagando o pix' } ] }

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

Boa tarde <@!664563985885954079>, não tem problemas de autenticação ocorrendo, o que percebemos é que alguns integradores tentavam utilizar o cerificado de produção em rotas de homologação ou vice-versa. Me informe no privado o número da sua conta e detalhes do seu certificado para que eu identifique se é a mesma causa.

# sugestões
Avatar discord do usuario anoni_mato

anoni_mato

Ver Respostas

A respeito do discutido em https://discord.com/channels/775322853884821504/775328670784159744/796748024566120519:

A GN poderia oferecer na parte de API > Aplicações, uma opção para compartillhar os direitos de acesso à essa aplicação com um integrador parceiro por dentro da plataforma da GN, que poderia ver o client_id e client_secret e solicitar certificados.

Assim não dependeria do cliente fazer o processo de obtenção de credenciais, solicitar certificado, receber senha por SMS (que tem período de validade relativamente curto - 4 horas) e depois encaminhar tudo isso pro integrador por fora do sistema.

# sugestões
Avatar discord do usuario anoni_mato

anoni_mato

então vazios e estáticos vão para o teste de regex, e aí o integrador decide o que fazer

# sugestões
Avatar discord do usuario anoni_mato

anoni_mato

Ver Respostas

a ideia é testar se o regexp do integrador admite txid "vazio"

# pix
Avatar discord do usuario sady_efi

sady_efi

Ver Respostas

Como o Evanil citou, é algo que estamos abertos a discutir e implementar uma vez que contribua positivamente para os integradores, mas de todo modo teria um tempo para ser implementado

# sugestões
Avatar discord do usuario anoni_mato

anoni_mato

Não deveria ter um segundo condicionante antes de jogar para a regex do integrador, que verifique se o txid tem 1-25 caracteres? Pois se passar txid com 26-35 (que deveria ser relativo a uma cobrança) para o regex do integrador testar (sem haver uma cobrança), significa que o payload foi manipulado/mal-interpretado/etc...

# sugestões
Avatar discord do usuario francisco.carvalho

francisco.carvalho

Ver Respostas

Pessoal, o que acham dessa proposta? A ideia é dar mais liberdade ao integrador na decisão de aprovar ou não um Pix.
imagem enviada na mensagem pelo usuario francisco.carvalho

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

Já foi orientado e as credenciais não estão sendo enviados pela equipe, no entanto, a documentação estava desatualizada. Alterei para que o integrador informe o nome da aplicação e o ambiente para que possamos gerar o certificado.

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

A discussão no momento é permitir ao integrador bloquear Pix sem txid. Mas eu vou levantar essa questão também para a equipe, pois, já não seria com a API e sim com a equipe financeira.

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

Está em discussão, antes de implementarmos a mudança vamos avisar com antecedência para que os integradores possam se adequar ao /pix. Inclusive hoje eu questionei o andamento e uma discussão foi fomentada . Já trago mais detalhes aqui quando alinharem comigo.