Este projeto é direcionado a desenvolvedores que têm a necessidade de escrever código capaz de gerar dados de QR Codes compatíveis com a especificação PIX.
Conforme a especificação, é possível gerar QR Codes estáticos ou dinâmicos.
A API fornecida por este projeto possibilita a geração dos dados por duas formas disponíveis:
O projeto disponibiliza uma DSL (Domain Specific Language) que adapta a criação dos QR Codes e impossibilita a criação de um QR Code com dados errados, pois não permite que os dados sejam gerados com informações faltantes ou formatadas incorretamente.
Um exemplo de uso desta DSL é o seguinte:
import static com.github.alesaudate.pix.qrcode.QRCodeBuilder.staticQRCode;
public class Pix {
public static void main(String[] args) {
String staticQRCode =
staticQRCode()
.merchantAccountInformation()
.merchantKey("123e4567-e12b-12d1-a456-426655440000")
.unknownMerchantCategoryCode()
.merchantName("Fulano de Tal")
.merchantCity("BRASILIA")
.build();
System.out.println(staticQRCode);
}
}Este código irá imprimir o mesmo QRCode disponível na página 16 da espeficicação do PIX, ou seja:
00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-4266554400005204000053039865802BR5913Fulano de Tal6008BRASILIA62070503***63041D3D
Observe que os métodos desta DSL só podem ser utilizados nesta ordem, e não é possível invocar o método build sem que todos os métodos anteriores tenham sido invocados anteriormente, desta forma impossibilitando a geração de um QR Code com dados faltantes. Além disso, todos os métodos fazem verificação acerca da validade das entradas, também impossibilitando a criação de um QR Code PIX com dados gerados de forma incorreta.
Se por algum motivo o desenvolvedor não quiser / não puder utilizar a DSL, existe uma abordagem alternativa para criação do objeto através do uso de um POJO. Um exemplo de uso desta API é o seguinte:
import com.github.alesaudate.pix.qrcode.StaticQRCode;
public class Pix {
public static void main(String[] args) {
StaticQRCode staticQRCode = new StaticQRCode();
staticQRCode.setDefaultValues();
staticQRCode.setMerchantAccountInformationKey("123e4567-e12b-12d1-a456-426655440000");
staticQRCode.setMerchantName("Fulano de Tal");
staticQRCode.setMerchantCity("BRASILIA");
System.out.println(staticQRCode.asString());
}
}Este código produz a mesma saída que o descrito pela DSL, mas observe que ele não apresenta as mesmas restrições. Isto quer dizer que os métodos podem ser invocados em qualquer ordem, e a presença ou ausência dos blocos obrigatórios somente será verificada através da execução do método asString.
A utilização da API para geração de QR Codes dinâmicos é bem semelhante à de QR Codes estáticos.
Um exemplo de uso da DSL de geração de QR Codes dinâmicos é o seguinte:
import static com.github.alesaudate.pix.qrcode.QRCodeBuilder.dynamicQRCode;
public class Pix {
public static void main(String[] args) {
String dynamicQRCode = dynamicQRCode()
.merchantAccountInformation()
.url("bx.com.br/pix/8b3da2f3-9a41-40d1-a91a-bd93113bd441")
.merchantCategoryCode("0000")
.transactionAmount(new BigDecimal("123.45"))
.merchantName("Fulano de Tal")
.referenceLabel("RP12345678-2019")
.merchantCity("BRASILIA")
.build();
System.out.println(dynamicQRCode);
}
}Este código irá imprimir o seguinte:
00020101021226720014br.gov.bcb.pix2550bx.com.br/pix/8b3da2f3-9a41-40d1-a91a-bd93113bd4415204000053039865406123.455802BR5913FulanodeTal6008BRASILIA62190515RP12345678-2019630445C8
Você pode encontrar instruções sobre como adicioná-lo ao seu projeto em https://mvnrepository.com/artifact/io.github.alesaudate/pix-qrcodegen/1.0