Lançamento ACBrLibPIXCD

[antonio.carlos]

Mais um lançamento ACBrLib, desta vez chegou o ACBrLibPIXCD !

Depois de alguns meses trabalhando no desenvolvimento, chegou a hora de dizer... finalizamos mais uma biblioteca ACBrLib, o ACBrLibPIXCD.

Para quem não conhece sobre PIX, o primeiro passo é acessar este tópico, para entender um pouco sobre o assunto.
ACBrPIXCD - Novo Componente para integração com PIX.

No Projeto ACBr temos o componente ACBrPIXCD, utilizado por desenvolvedores Delphi e Lazarus e agora utilizando o ACBrLibPIXCD é possível fazer uma integração nativa utilizando outras linguagens, por exemplo, C#, Java, VB6.. ou qualquer linguagem de programação que seja possível consumir uma dll (Windows) ou .so (Linux). 

Utilizando ACBrLibPIXCD é possível gerar um PIX de forma estática, configurando uma PSP em ACBrLib.ini e usando o método GerarQRCodeEstatico, veja um exemplo:

//-------------------------------- Exemplo ACBrLib C# --------------------------------------//

Parâmetros:
AValor - Valor transação PIX.
AinfoAdicional - Informaçoes Adicionais da transação PIX. (Parâmetro Opcional).
ATxID - Identificador da Transação PIX. (Parâmetro Opcional).
sResposta - Usado pelo retorno, contem as informações retornadas pela consulta.
esTamanho - Usado pelo retorno, contem o tamanho da string (sResposta).

ACBrPIXCD.GerarQRCodeEstatico(1);

ACBrLibPIXCD não trabalha somente de forma estática, também é possível criar PIX dinâmico.. com os EndPoints /Pix, /Cob e /CobV, e configurando PSP em ACBrLib.ini, dessa forma você precisa utilizar os métodos que correspondem a cada EndPoint, exemplo utilizando EndPoint /CobV, com os métodos 

CriarCobranca:

//-------------------------------- Exemplo ACBrLib C# --------------------------------------//
Parâmetros:
AInfCobVSolicitada - Arquivo.ini com as informações para criar uma cobrança.
ATxId - Identificador da Transação PIX.
sResposta - Usado pelo retorno, contem as informações retornadas pela consulta.
esTamanho - Usado pelo retorno, contem o tamanho da string (sResposta).

ACBrPIXCD.CriarCobranca("C:\Cobrança\CobVSolicitada.ini", "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890");

CancelarCobranca:

//-------------------------------- Exemplo ACBrLib C# --------------------------------------//
Parâmetros:
ATxId - Identificador da Transação PIX.
sResposta - Usado pelo retorno, contem as informações retornadas pela consulta.
esTamanho - Usado pelo retorno, contem o tamanho da string (sResposta).

ACBrPIXCD.CancelarCobranca("ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890");

Observação: O Projeto ACBr espera ansiosamente pelo feedback de todos e sabemos que podem ocorrer ajustes, por este motivo fique sempre atento aos commits e atualizações dos Manuais e Programa Exemplo.

Obrigado @Daniel Simoes e @Juliana Tamizou por confiar e acreditar em mais um desenvolvimento ACBrLib.

Agradecer também @EliasCesar e @EMBarbosa por todo apoio no projeto ACBrLibPIXCD.

Até o próximo lançamento  !

[Diego Foliene]

Olá pessoal!

Visando fornecer uma maior liberdade e controle para aqueles que utilizam a Lib, foi feita uma atualização adicionando nas configurações dos PSPs a configuração "Scopes".

Vejam um exemplo de Scopes configurados para o PSP Integer:

[Inter]
ChavePIX=
ClientID=
ClientSecret=
ArqChavePrivada=
ArqCertificado=
Scopes=[scCobWrite,scCobRead,scCobVWrite,scCobVRead,scPixWrite,scPixRead]

Os valores possíveis são:

Citar

scCobWrite,scCobRead,scCobVWrite,scCobVRead,scLoteCobVWrite,scLoteCobVRead,scPixWrite,scPixRead,scWebhookWrite,scWebhookRead,scPayloadLocationWrite,scPayloadLocationRead

A documentação da Lib também foi atualizada com a informação.

Citar

Mas afinal de contas, o que são escopos?

Os escopos são opções de configuração ativados e configurados do lado do PSP seja através de painel de controle da API ou já definidos por padrão, que precisam ser enviadas no momento em que é estabelecida a comunicação com a API do PSP.

Eles servem para dizer a API, quais serviços aquela conexão deseja consumir.

Vamos voltar ao exemplo do Inter:

Scopes=[scCobWrite,scCobRead,scCobVWrite,scCobVRead,scPixWrite,scPixRead]

Os escopos configurados estão dizendo que em minha comunicação com a API eu desejo criar e consultar uma cobrança imediata(scCobWrite e scCobRead), consultar um PIX, solicitar uma devolução (scPixWrite e scPixRead) e também criar e consultar uma cobrança com vencimento (scCobVWrite e scCobVRead).

Agora se eu alterar essa configuração desta forma:

Scopes=[scCobWrite,scCobRead]

Estou dizendo que desejo em minha comunicação com a API apenas criar e consultar cobranças imediatas.

Citar

Mas eu já uso a LibPIXCD e nunca precisei configurar isso.

Por padrão a Lib utiliza a seguinte configuração:

Scopes=[scCobWrite,scCobRead,scPixWrite,scPixRead]

 

[antonio.carlos]

Olá, pessoal !
Temos uma novidade para compartilhar com vocês !
O ACBrLibPIXCD acaba de ser aprimorado com novos métodos específicos para uso do PSP Matera.
Esta atualização inclui a implementação de funcionalidades dedicadas para quem deseja realizar homologação e utilizar o PSP Matera.
Agora você pode acessar métodos desenvolvidos exclusivamente para atender às necessidades do PSP Matera, tornando a integração ainda mais fácil e eficiente.

Agora utilizando o ACBrLibPIXCD, é possível, Criar Conta, Consultar Conta, Incluir Chave Pix, Consultar Chave Pix, Gerar QRCode, entre outros métodos..  
Abaixo alguns exemplos de uso dos métodos:
Consultar Conta Matera:

//-------------------------------- Exemplo ACBrLib C# --------------------------------------//
Parâmetros:
aAccountId - Informe o AccountID da Conta Matera.
sResposta - Usado pelo retorno, contem as informações retornadas pela consulta.
esTamanho - Usado pelo retorno, contem o tamanho da string (sResposta).

ACBrPIXCD.ConsultarConta("43012B96-35B7-74EB-843D-44790FA36673");

Incluir Chave Pix:

//-------------------------------- Exemplo ACBrLib C# --------------------------------------//
Parâmetros:
aAccountId - Informe o AccountID da Conta Matera.
aChavePIX - Informe a Chave PIX.
sResposta - Usado pelo retorno, contem as informações retornadas pela consulta.
esTamanho - Usado pelo retorno, contem o tamanho da string (sResposta).

ACBrPIXCD.IncluirChavePix("43012B96-35B7-74EB-843D-44790FA36673", "86C27289E147461D917F42280B6D7742");

Documentação disponível em:
https://acbr.sourceforge.io/ACBrLib/SobreaACBrLibPIXCD.html

Também foi disponibilizado em nosso SVN, um programa exemplo exclusivo para uso do PSP Matera:
https://svn.code.sf.net/p/acbr/code/trunk2/Projetos/ACBrLib/Demos/C%23/PIXCD_Matera/



O Projeto ACBr aguarda ansiosamente por feedbacks da comunidade.. 

[EMBarbosa]

Para quem quiser saber mais sobre o ACBr Pix Matera, visite:

https://projetoacbr.com.br/pix/