PIX - Payload generator DotNet
Este pacote auxilia na geração de payloads para usar em QRCode estático PIX.
⚠ Informações importantes
- Não requer um PSP
- Não necessita de conexão com a internet
- Não é possivel recuperar informações do status de pagamento, use este pacote caso necessite disso.
- Não é possivel pagar para si mesmo usando a mesma Chave x PSP, ex: gerar um QrCode para uma chave na Nubank e tentar pagar com a própria conta da Nubank.
- O QrCode/Código copia e cola gerado, pode ser reaproveitado para vários pagamentos.
Como usar?
1 - Instale este pacote na sua aplicação.
Install-Package pix-payload-generator.net
2 - Crie uma instância de Cobrança passando por parâmetro a chave pix.
var cobranca = new Cobranca(_chave: "bee05743-4291-4f3c-9259-595df1307ba1");Você pode optar por adicionar mais algumas informações:
- Valor (Caso não informado, ficará livre para o pagador digitar);
- Descriçao (Caso informado, aparecerá no momento do pagamento).
Exemplo, definindo o valor de R$ 15,00 e descrição "Pagamento do pedido X":
Cobranca cobranca = new Cobranca(_chave: "bee05743-4291-4f3c-9259-595df1307ba1")
{
SolicitacaoPagador = "Pagamento do Pedido X",
Valor = new Valor
{
Original = "15.00"
}
};
ATENÇÃO! Os valores de "Original" devem sempre seguir o padrão de duas casas decimais separadas por ".", ex:
R$ 10.000,00 = "10000.00"
R$ 1.000,00 = "1000.00"
R$ 100,00 = "100.00"
R$ 10,00 = "10.00"
R$ 1,00 = "1.00"
R$ 0,90 = "0.90"
Os bancos tem limites de valores a ser transferido por Pix, verifique o limite para o seu antes de transferir um valor.
3 - Gerar o Payload a partir da cobrança criada
var payload = cobranca.ToPayload("O-TxtId-Aqui", new Merchant("Alexandre Sanlim", "Presidente Prudente"));4 - Pegar uma string para setar em um QrCode a aprtir do Payload gerado
var stringToQrCode = payload.GenerateStringToQrCode();Retornará uma string como esta:
00020126580014br.gov.bcb.pix0136bee05743-4291-4f3c-9259-595df1307ba1520400005303986540510.005802BR5914Alexandre Lima6019Presidente Prudente62180514Um-Id-Qualquer6304D475
5 - Por fim, basta setar em um QRCode! ;)
Testes
- Este projeto possuí testes, onde poderão ser usados para colocar os valores que quiser e gerar seus payloads.
- Copie a string gerada para este site para validar e ver o QrCode.
Extra
- Caso necessite das funções de QrCode dinâmico, onde é possível acompanhar o status de pagamento e conectar com as funções disponíveis na pix-api use este pacote.