pix-payload-generator.net 1.0.19-pre-release

.NET 5.0 .NET Standard 2.0 .NET Framework 4.5
This is a prerelease version of pix-payload-generator.net.
Install-Package pix-payload-generator.net -Version 1.0.19-pre-release
dotnet add package pix-payload-generator.net --version 1.0.19-pre-release
<PackageReference Include="pix-payload-generator.net" Version="1.0.19-pre-release" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add pix-payload-generator.net --version 1.0.19-pre-release
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: pix-payload-generator.net, 1.0.19-pre-release"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install pix-payload-generator.net as a Cake Addin
#addin nuget:?package=pix-payload-generator.net&version=1.0.19-pre-release&prerelease

// Install pix-payload-generator.net as a Cake Tool
#tool nuget:?package=pix-payload-generator.net&version=1.0.19-pre-release&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

PIX - Payload generator DotNet

<img width='200' src='https://user-images.githubusercontent.com/5353685/101644586-233eb080-3a14-11eb-9cec-2172586abfde.png'/>

Nuget Nuget

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"<br/> R$ 1.000,00 = "1000.00"<br/> R$ 100,00 = "100.00"<br/> R$ 10,00 = "10.00"<br/> R$ 1,00 = "1.00"<br/> 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! 😉

<img src='https://dyn-qrcode.vercel.app/api?url=00020126580014br.gov.bcb.pix0136bee05743-4291-4f3c-9259-595df1307ba1520400005303986540510.005802BR5914Alexandre%20Lima6019Presidente%20Prudente62180514Um-Id-Qualquer6304D475' />

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.
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net45 net451 net452 net46 net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on pix-payload-generator.net:

Package Downloads
pix-dynamic-payload-generator.net

Auxilia na geração de QRCodes dinâmicos para pagamentos com PIX (Sistema de pagamento instantâneo do Banco Central do Brasil).

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.19-pre-release 1,066 2/12/2022
1.0.18 2,940 8/31/2021
1.0.17 1,501 2/1/2021
1.0.16 170 1/26/2021
1.0.15 475 1/7/2021
1.0.10 541 12/17/2020
1.0.9 217 12/17/2020
1.0.8 199 12/16/2020
1.0.7 211 12/16/2020
1.0.6 206 12/16/2020
1.0.5 218 12/16/2020
1.0.4 212 12/16/2020
1.0.3 232 12/16/2020
1.0.2 201 12/9/2020
1.0.1 194 12/9/2020
1.0.0 205 12/9/2020

Adicionado validações e suporte a .net5 e .net6