Termos mais procurados:
Certo. Neste caso, @carlos06_3, você consegue associar uma URL de notificação para estas cobranças que você esta emitindo.
Quando você realiza o cadastro da URL, a cada alteração no status da cobrança, iremos notificar através da URL informada.
Você consegue consultar mais informações sobre as notificações, acessando: https://dev.gerencianet.com.br/docs/notificacoes-recebendo
Se eu tenho apenas uma chave PIX e utilizarei ela para sempre nas minhas cobranças PIX, eu preciso criar o Webhook para essa chave apenas uma vez, certo? Desde que meu link para receber as notificações permaneça o mesmo, é claro.
Bom dia, @alanmiller0938! Tudo joia?
A nossa API possui a modalidade de assinatura, que permite você criar pagamentos recorrentes.
Sim, a cada alteração de status das cobranças vinculadas a assinatura, realizamos um envio de notificação.
É preciso verificar com o seu sistema, se o mesmo realizou a implementação com essa funcionalidade da nossa API de emissões.
Olá, bom dia!
Referente a cobranças emitidas na integração , alguém que possa mim orientar?
É provável que algumas cobranças não serão emitidas devido à isso. Então caso precise de um valor especifico de cobranças pode ser que você tenha que tentar emitir mais de uma vez.
Caso a resposta vazia esteja acontecendo devido à resposta 500 e verifique que não há quaisquer dados incorretos enviados na emissão pode considerar como uma resposta atípica que não irá ocorrer em ambiente de produção. Para fins de testes pode considerar as cobranças emitidas com sucesso.
A instabilidade na emissão de cobranças em homologação é uma situação que esta sendo mapeada e irá ser tratada pela nossa equipe responsável assim que possível, porém não temos uma previsão para tal.
Reforçamos que não há comportamento semelhante à este em produção.
Sim, a API só tem acesso às cobranças geradas via API.
Boa tarde @wesleyalmont tudo certo?
Basta criar as cobranças seguindo as seguintes regras:
Para o Envio de Pix, endpoint PUT /v2/gn/pix/:idEnvio :
Se o valor do Pix está entre R$ 0.01 à R$ 10.00:
Pix é confirmado, informação virá via Webhook.
Se o valor do Pix está entre R$ 10.01 à R$ 20.00:
Pix é rejeitado, informação virá via Webhook.
Se o valor do Pix é acima de R$ 20.00:
Pix é rejeitado já na requisição, informação não virá via Webhook.
Para COB e COBV:
Se o valor da cobrança está entre R$ 0.01 à R$ 10.00:
A cobrança é confirmada, informação virá via Webhook.
Se o valor da cobrança é maior que R$ 10.00:
A cobrança permanece ativa, sem confirmação. Como não há webhook nesses casos, nada é feito.
Entendi, @gustamedeiros. Neste caso, os clientes e boletos que são registrados no painel da conta, só podem ser gerenciados dentro da conta mesmo.
Para ter o acesso via API, a base de clientes deve ser do lado do seu sistema/app, e emitir as cobranças através da API.
Para isso, você encontra os detalhes em nossa documentação técnica: https://dev.gerencianet.com.br/docs/gerar-boleto-bancario
Olá, @gustamedeiros. Bom dia! Como vai?
Neste seu cenário você não precisa utilizar a API de abertura de contas. Pelo que entendi, esse app irá gerenciar as cobranças dos clientes do provedor. Ou seja, nesse app você deve usar as credenciais de acesso a API da conta do provedor.
Uma outra opção que pode ser viável... Imagino que esse provedor já tenha um sistema integrado com nossa API que faça a gestão dos boletos. Então basicamente, você poderia compartilhar ou conectar no banco de dados do sistema para ter as informações atualizadas, como os clientes que estão em dia, ou autras informações.
@pauloeduardo_dev , é que não é tão simples assim também, assim como a Efi eu enfrentei esse problema aqui, como disponibilizar consulta de CPF para as demandas de clientes de um cliente meu, porque ao consultar o cpf como foi projetado no inicio iria buscar dados que não tinha haver com o detentor das demandas, por exemplo, no caso da efi iria buscar todos os boletos que aquele cliente tem com a efi sendo uma transação com você ou não, claro que tem como ajustar e tudo mais, só que no caso da efi são milhares de registros, e um estudo bem profundo que precisa ser feito antes de implantar uma mudança em base de dados, para ver as implicações, não querendo defender nem nada, mas é que realmente é mais simples, econômico e mais seguro se o próprio cliente criar um relacionamento de suas cobranças com o cpf dos seus clientes. Além de ser juridicamente mais seguro também, pois todas as demandas da lei geral de proteção de dados ficam a cargo de quem detem os dados, sem riscos de compartilhamento.
Olá @sendfacil ! Boa tarde. Tudo bem? A maneira recomendada para verificar o status das cobranças Pix, é utilizando um webhook, onde, o seu servidor ficará configurado para receber notificações automaticamente a cada alteração de status na cobrança Pix. Neste link da nossa documentação disponibilizamos mais detalhes: https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks
Não. Em nosso endpoint de consulta de cobrança, é preciso passar o identificador para buscar as informações de uma determinada cobrança Boleto, Carnês...
Em nossa API Pix, é possivel retornar a lista de cobranças pix emitidas.
Eu consigo ver todas as minhas cobranças pelo endpoint? Suposto retorno:
{data: [
{
cpf: 0000000,
id: ddhsu-89898,
id_cobranca: dsuha-7654321,
etc...
},
{
cpf: 111111111111,
id: ddhsu-123456,
id_cobranca: dsuha-54312,
etc...
},
....
]
}
Entendi. Atualmente, a nossa API de emissões não tem um endpoint que retorna uma lista de cobranças.
Eu não consigo, por exemplo, pegar um array com as cobranças em aberto não?
Bom dia, @.lotuus! Tudo bem e com você?
Atualmente, temos um endpoint que permite realizar consultas das cobranças na API, mas para realizar este tipo de consulta, é preciso informar o identificador da cobrança a ser consultada.
Bom dia, @sheikzadarevo! Tudo bem?
A URL de notificação não é definida na emissão da cobrança Pix.
Você deve associar uma URL de notificação a sua chave Pix, então as cobranças Pix que tiverem um txid e sua chave Pix, nós iremos enviar a notificação para a URL registrada. Essa configuração pode ser feita uma única vez através do endpoint PUT/v2/webhook/:chave (https://dev.gerencianet.com.br/docs/api-pix-endpoints#configurar-o-webhook-pix).
Pontuando que para registrar sua URL de notificação, seu servidor deve possuir algumas configurações para atender a comunicalção com mTLS. Você encotra mais detalhes em nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks
Pessoal uma dúvida. No callback das cobranças eu não recebo o status. Isso quer dizer que toda vez que eu receber um callback de uma determinada cobranca pix eu tenho que fazer uma consulta no endpoint de cobrança para saber o status do pagamento? Ou ele retorna isso de alguma forma no webhook e eu que não estou sabendo utilizar? Lembrando que não estou usando SDK criei toda estrutura php para o meu caso.
Segue todos os escopos da API PIx:
Alterar Cobrança = cob.write
Consultar Cobrança = cob.read
Alterar Cobrança com Vencimento = cobv.write
Consultar Cobrança com Vencimento = cobv.read
Alterar Payload = payloadlocation.write
Consultar Payload = payloadlocation.read
Alterar Pix = pix.write
Consultar Pix = pix.read
Alterar Webhook = webhook.write
Consultar Webhook = webhook.read
Consultar Saldo da Conta = gn.balance.read
Alterar Chave Aleatória = gn.pix.evp.write
Consultar Chave Aleatória = gn.pix.evp.read
Alterar Configurações da API = gn.settings.write
Consultar Configurações da API = gn.settings.read
Solicitar relatórios = gn.reports.write
Consultar relatórios = gn.reports.read
A API de emissões é ativada por padrão, então neste caso, você não precisa de passar nenhuma informação para que o cliente emita cobranças cartão, boletos, carnês...
Em relação ao Boleto sem Pix = O cliente tem que deixar desativado o Bolix dentro da conta Digital
