Histórico de mensagens sobre API de cobranças

João, esta tela da configruração dos status não tem todos os status mapeados, por exemplo o status inadimplente..

Mas, considerando que está configurado de forma equivalente ao print que vc me enviou, se eu entro no extrado da conta do Administrador do Marketplace na EFÍ, na parte da gestão das cobranças, e mudo manualmente um status de uma cobrança no boleto marcada como inadimplente, para cancelado, o que acontece? a API da efí não deveria devolver para o marketplace o status "cancelado" ou "cancelado pela operadora", e retornar a informação para mudar este status de pagamento no apainel do vendedor??

Percebi que cobranças inadimplentes ficam com este status para sempre e nunca cancelam na EFI, isso para mim é péssimo, pois sem um retorno de cancelamento, o produto não volta para o estoque do vendedor no marketplace. Se ao menos mudasse para cancelado em alguns dias, ajudaria muito.

Bom dia, pessoal acredito que encontrei um pequeno bug no novo endpoint da API de Cobranças...

GET /v1/charges?charge_type=billet&date_of=due&begin_date=2024-01-01&end_date=2024-08-31

O Query params date_of com o tipo due não funciona.... o retorno é invalido... ou seja eu não consigo retorar a lista de cobranças vencidas de um determinado periodo de vencimento...

Boa noite devs.

Acabei de finalizar a integração dos principais endpoints da API PIX (Efí Pay) no meu SDK typescript que apresentei anteriormente.

Também adicionei a opção de incluir certidicados em formato base64 e Buffer. Dentre as funcionalidades adicionadas estão:

- Cobranças imediatas
- Cobranças com vencimento
-Envio e Pagamento Pix
-Gestão de Pix
- Payload Locations
- Cobranças em Lote
- Split de pagamento Pix
- Webhooks

Em breve irei integrar as funcionalidades de Cartão de Crédito e Assinatura.

Há a possibilidade de utilizá-lo tanto em produção quanto em teste (SANDBOX), então quem prefere typescript e quiser dar uma olhada está convidado.

Segue o link da documentação para quem quiser fazer alguns testes:

https://www.npmjs.com/package/@bruno-valero/gerencianet-sdk-typescript

Boa noite devs, tudo bem?

Estou desenvolvendo um SDK para integrar a API da Gerencianet com TypeScript. Esta versão está sendo desenvolvida com foco total no TypeScript, proporcionando segurança de tipos e melhor reportagem de erros durante o desenvolvimento.

Atualmente, apenas a API de PIX para cobranças imediatas e cobranças com data limite está com a integração completa. Outras funcionalidades serão implementadas em futuras atualizações.

Segue o link para a documentação do pacote no npm: https://www.npmjs.com/package/@bruno-valero/gerencianet-sdk-typescript

Quem tiver interesse em desenvolver com typescript está convidado a instalar o pacote e fazer alguns testes. Caso surja qualquer sugestão de melhoria, basta abrir uma issue no github do projeto.

Espero poder ajudar a agilizar o desenvolvimento dos interessados.

Bom dia, @excarplex_27431! Tudo bem?
1. Para configurar um split de pagamento em uma cobrança Pix, você precisará seguir alguns passos específicos e utilizar os endpoints adequados da API. Aqui está um resumo das informações para te orientar:
1.1. Configuração do Split de Pagamento:
Primeiro, é necessário criar uma configuração de split. Isso é feito através do endpoint específico para configuração de split, disponível aqui. Esta configuração pode ser reutilizada em múltiplas cobranças Pix, o que facilita o processo se você tiver uma estrutura de split recorrente.
1.2. Criação da Cobrança Pix:
Após configurar o split, o próximo passo é criar a cobrança Pix. Isso pode ser feito de duas maneiras, dependendo do tipo de cobrança:
1.2.1. Cobrança Imediata: Utilize o endpoint para criar uma cobrança imediata com um TXID, disponível aqui.
1.2.2Cobrança com Vencimento: Se a cobrança tiver vencimento, utilize este endpoint.
1.3. Associação da Configuração de Split à Cobrança Pix:
Com a cobrança Pix criada, você precisará associar a configuração de split à cobrança. Isso é feito através do endpoint específico para vinculação de cobrança com split, disponível aqui.
Além disso, para melhor compreensão do processo de split de pagamento, você pode consultar o fluxograma disponível neste link.


2. O Split de pagamento Pix só pode ser realizado entre contas Efí, com limite máximo de 20 contas para o repasse.


3. Para configurar o webhook, você precisará fazer isso através de uma requisição HTTP utilizando o endpoint específico fornecido pela Efí. Esse processo envolve associar uma chave Pix registrada na sua conta Efí, que é a mesma chave que será utilizada na criação da cobrança, à URL de retorno da sua aplicação.
Você pode seguir o passo a passo detalhado na nossa documentação sobre webhooks. Lá, você encontrará o endpoint que deve ser utilizado para essa configuração.
Além disso, é essencial que você configure o mTLS (Mutual TLS) no seu servidor web para garantir que a comunicação siga os padrões de segurança estabelecidos. Mais detalhes sobre essa configuração podem ser encontrados na seção sobre mTLS na nossa documentação.

Se precisar de mais ajuda, conte com a gente!

Atualmente não é possível realizar a devolução via API de cobranças pix com split

@tiago.rodrigues_br, as cobranças listadas na API são cobranças criadas somente via API mesmo.
O recebimento de cobranças emitidas em um outro contexto não são acessíveis via API.

A API pix com txid eu consegui implementar mas a de cobranças nunca dispara pra mim

Bom dia, @.danilosilveira! Tudo bem?
Nossa API tem um mecanismo de segurança que impede a emissão de cobranças idênticas. Atualmente, é possível emitir apenas duas cobranças com as mesmas informações. Na terceira tentativa, ocorrerá uma falha.

Para resolver isso, você precisa alterar algum atributo da requisição para emitir a cobrança com sucesso.

Após a emissão de assinaturas via API, retornamos sim um link que pode ser encaminhado para o seu cliente, para o pagamento, em casos de cobranças via boleto 🙂

Boa tarde, @lucchesisp, tudo bem?
Possuímos uma API de Pagamento de Contas, com ela você é capaz de fazer o pagamento de cobranças e não há cobrança de tarifa para realizar estes pagamentos.

Bom dia @juizmill ! Sim, são ambientes separados. Você pode cadastrar um webhook em homologação e realizar os testes.
A API de Cobranças é separada da API Pix. Na API de Cobranças, você cadastra a URL de Notificação através do atributo notification_url. Já na API Pix, o webhook é atrelado a uma chave Pix, e você pode cadastra-lo uma única vez.

Boa tarde, @pauloeduardo_dev! Tudo bem?
Atualmente, nossa API não tem um endpoint com essa funcionalidade. Mas trago um spoiler: está perto o lançamento dessa funcionalidade. ||Prevemos que será disponibilizada até o final deste mês||. Qualquer novidade, informaremos aqui no canal <#🖥changelog>.

Se precisar dessa implementação imediatamente, sugiro que faça a consulta pelo CPF do cliente em um banco de dados do seu sistema, e que seu sistema retorne as cobranças associadas.

Bom dia. É possível na api pix fazer a verificação de mais de uma cobrança ao mesmo tempo, sem ser pelo list no qual lista todas as cobranças em um determinado tempo, mas sim enviando por exemplo 3 txids diferentes pra ser mostrado as 3 cobranças?

Alguém sabe me dizer com relação a api pix se tem um limite de quantos resultados podem ser retornados usando o codigo de consulta de lista de cobranças?

A Efí tem 2 APIs diferentes, e aparentemente essa plataforma só implementou a API de Cobranças, e não a API Pix.

Boa tarde, @marinareginato! Tudo bem?

Você pode acessar suas credenciais indo em Menu API > Minhas Aplicações e clicando na aplicação desejada. Na página da aplicação, você encontrará as credenciais de homologação e produção.
Recomendamos que cada integração tenha sua própria aplicação. Isso facilita a visualização de logs, notificações e, se você usar a API Cobranças, evita ter várias URLs de notificação associadas a diferentes cobranças em uma única aplicação.

Exato. Na API de cobranças as notificações podem ser definidas para cada cobrança, enquanto na API Pix, todas as cobranças de uma mesma chave Pix acionam o mesmo webhook.