marcorabelo / pix-payload-generator.net

Gerar payload para qrcode estático PIX. (Sistema de pagamento instantâneo do Brasil) Sem a necessidade da conexão de um PSP.

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.