Histórico de mensagens sobre cobrança de api

Supondo que o seu sistema ofereça a opção de emitir cobranças via cartão de crédito, Pix, Bolix, Carnê ou Assinatura. Para que seu cliente possa fazer essas cobranças no sistema integrado, ele precisa ter uma conta no Efí. Depois de abrir a conta, será necessário criar manualmente uma aplicação dentro da conta dele para obter as credenciais da API, e depois ele inserir essas credenciais na tela de configurações do seu sistema.

Se a abertura da conta for feita diretamente pelo seu sistema, assim que o cliente autorizar a criação, o seu sistema já teria acesso às credenciais da API. Dessa forma, as cobranças poderiam ser emitidas automaticamente, sem que o cliente precise inserir manualmente as credenciais.

Para receber notificações do Bolix, você informa a URL no momento de criar a cobrança. Assim, sempre que houver uma mudança no status, o Efí envia um POST para essa URL. Essa notificação vem com um token único, que continua o mesmo durante todas as alterações da transação. Sua aplicação deve consultar esse token pelo endpoint GET /v1/notification/:token, documentação do endpoint. Ao consultar esse token, você recebe os dados atualizados do boleto.

Veja aqui exemplos do retorno na documentação.

Temos também um vídeo sobre o assunto neste link.