pix-charge

pix-charge

Library to generate BCB's Pix Payment BR Code

Install 📦

#NPM
npm i pix-charge

#YARN
yarn add pix-charge

Usage ✍️

import { dinamicPix, staticPix } from "pix-charge";

let brCode = staticPix({
  merchantKey: "[e-mail]",
  merchantName: "Gabriel Molter",
});

QRCode 🤳

This lib was created with the goal of being as small and simple as possible, therefore, it only creates the BR Code. If you need to transform it into a QR Code, there are many ways to do it. I recomend using the qrcode lib. Here is an example:

On your HTML, create an Canvas element with an id

<canvas id="canvas"></canvas>

Then use .toCanvas to create a QR Code from the BR Code

import { dinamicPix, staticPix } from "pix-charge";

let brCode = staticPix({
  merchantKey: "[e-mail]",
  merchantName: "Gabriel Molter",
});

QRCode.toCanvas(document.getElementById("canvas"), brCode, (error) => {
  if (error) {
    console.error(error);
  } else {
    console.log("success!");
  }
});

Params 🎛️

staticPix()

staticPix({ object }). object:

param	type	required
merchantKey	string	✅
merchantName	string	✅
amount	number	❌
merchantCity	string	❌
merchantCep	string	❌
description	string	❌
isUnique	boolean	❌

dinamicPix()

dinamicPix({ object }). object:

param	type	required
merchantName	string	✅
location	string	✅
amount	number	❌
merchantCity	string	❌
merchantCep	string	❌
isUnique	boolean	❌

merchantKey

The merchantKey can be any DICT key:

• Email: [e-mail] (regular email string)

• CPF: 12345678900 (11 characters, no separators)

• CPF: 00038166000105 (14 characters, no separators)

• Telephone: [phone] (string starting with +, then country code, area code and actual phone number)

• EVP: 123e4567-e12b-12d1-a456-426655440000 (string with lowercase characters with separators)

Wanna buy me a beer?

If this lib has helped you and you want to support further development, you can do a Pix transfer using this QR Code:

or copying-and-pasting this BR Code:

[e-mail]5204000053039865802BR5914GABRIEL MOLTER63044E95

More info from BCB

BCB - Iniciação do Pix

License

MIT © gjmolter