Download the PHP package climba-commerce/php-pix without Composer
On this page you can find all versions of the php package climba-commerce/php-pix. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download climba-commerce/php-pix
More information about climba-commerce/php-pix
Files in climba-commerce/php-pix
Package php-pix
Short Description Uma biblioteca para preparar e gerar o código Pix do Banco Central do Brasil.
License MIT
Homepage https://github.com/piggly-dev/php-pix
Informations about the package php-pix
Crie/Leia códigos Pix sem complicações com PHP
O Pix é o mais novo método de pagamento eletrônico criado pelo Banco Central do Brasil. Você encontra todos os detalhes na página oficial do Pix. Saiba mais como ele funciona e como nossa biblioteca trabalha clicando aqui.
Essa biblioteca foi criada para ser utilizada principalmente com o plugin de Woocommerce Pix por Piggly. Mas, pode ser utilizada em qualquer sistema onde seja necessário a criação de payloads, códigos e QRCodes Pix. Afinal, ela foi criada para otimizar o processo de trabalho com os códigos Pix. Com ela, você poderá:
- Gerar códigos Pix estáticos e dinâmicos;
- Criar QR Codes para os códigos pix gerados;
- Ler códigos Pix importando os dados Pix;
- Criar payloads de Cobranças e Devoluções para interagir com as APIs Pix;
- Usar uma base de comunicação com a Api para organizar seus códigos;
- Gerar códigos compatíveis com a última versão do Pix.
Leia sobre a solução de problemas clicando aqui caso suas chaves Pix sejam inválidas. E, não deixe de conferir nossa documentação completa.
Se você apreciar a função desta biblioteca e quiser apoiar este trabalho, sinta-se livre para fazer qualquer doação para a chave aleatória Pix
aae2196f-5f93-46e4-89e6-73bf4138427b
❤.
Atualização para a versão 2.0.0
Muitas coisas mudaram, além do suporte ao PHP 8 os campos EMV foram otimizados e expandidos. Além disso, as requisições para APIs foram removidas e os payloads para as APIs foram reformulados. Recomendamos ler a documentação de mudanças clicando aqui e verificar as diferenças.
A biblioteca chillerlan/php-qrcode
não pode ser atualizada em composer.json
, tornando necessário utilizar a flag
--ignore-platform-reqs
no PHP 8. Veja abaixo:
Muitos utilizadores dessa biblioteca ainda utilizando a versão
7.2
do PHP e não é o momento ideal para perder esse suporte. A partir da versão2.1.x
pretendemores remover esse suporte.
Para realizar as requisições da api, recomendamos a biblioteca piggly/php-api-client, ela foi desenvolvida para ser flexível e muito mais robusta que a solução anterior utilizada na versão 1.x.x.
Veja as principais mudanças da versão 2.x.x:
- O padrão EMV MPM foi atualizado e remodelado para suportar novos campos que podem ser utilizados nos Pix;
- A validação e verificação das chaves Pix foi aprimorada;
- A leitura de um código Pix resulta em um objeto de EMVs mais flexível;
- Os modificadores do payload foram removidos, sendo que agora, todos os dados preenchidos são automaticamente tratados e cortados respeitando completamente o padrão EMV;
- A classe
BaseAPI
foi removida, adotando como sugestão a biblioteca piggly/php-api-client que traz muito mais flexibilidade e segurança; - Os payloads para APIs foram remodelados para serem mais eficientes e flexíveis.
Instalação
Composer
- No terminal, dentro da sua pasta do projeto, digite
composer require piggly/php-pix
; - Não esqueça de iniciar o composer incluindo o arquivo
require_once('vendor/autoload.php);
na base do código.
Instalação Manual
- Baixe ou clone esse repositório com
git clone https://github.com/piggly-dev/php-pix.git
; - Depois, vá para a pasta
/path/to/php-pix
e dê o comandocomposer install
para instalar todas as dependências. - Adicione o
autoload
do composer na base do seu projetorequire_once('/path/to/php-pix/vendor/autoload.php);
.
Dependências
Essa bibliotecca possuí as seguintes dependências:
- Extensão GD do PHP para gerar QR Codes;
- PHP +7.2 ou PHP +8.0.
Como utilizar?
Recomendamos que leia a documentação completa clicando aqui
Em samples/reader.php você encontra um exemplo de implementação. Esta biblioteca é bem simples de utilizar e tudo que você precisa fazer é solicitar ao usuário ou ter os seguintes dados para gerar o Pix:
Obrigatórios:
$keyType = Parser::KEY_TYPE_RANDOM;
$keyValue = 'aae2196f-5f93-46e4-89e6-73bf4138427b';
$merchantName = 'STUDIO PIGGLY';
$merchantCity = 'Uberaba';
Opcionais:
$amount = 109.90;
$tid = '034593-09';
$description = 'Pagamento 01';
$reusable = false;
Depois crie o objeto Payload
e utilize os métodos getPixCode()
ou getQRCode()
, conforme as suas necessidades. Você também pode criar o objeto Reader
para extrair os dados de uma chave pix válida.
Testes realizados
O código Pix gerado por essa biblioteca, incluindo a função QR Code e Pix Copia & Cola, foi testado nos seguintes aplicativos de banco:
- Banco do Brasil;
- Banco Inter;
- BMG;
- Bradesco;
- C6;
- Itaú;
- Mercado Pago;
- Nubank;
- PagPank;
- Santander.
Como o código utiliza o padrão do Pix é possível que funcione em todos os bancos. Alguns bancos ainda estão resilientes em utilizar os padrões determinados. Então, caso encontre problemas ou dificuldades não hesite em abrir uma Issue ou enviar um e-mail para [email protected].
Ao enviar um e-mail ou abrir uma issue, certifique-se de informar:
- Versão da Biblioteca: 2.0.0;
- Banco Emitente: NuBank;
- Banco Pagador: Inter;
- Tipo de Erro: O QR Code é inválido;
- Chave Pix Gerada:
00020101021126740014br.gov.bcb.pix0136aae2196f-5f93-46e4-89e6-73bf4138427b0212Pagamento 0152040000053039865406109.905802BR5913STUDIO PIGGLY6007Uberaba62130509034593-09630444C9
;
Changelog
Veja o arquivo CHANGELOG para informações sobre todas as mudanças no código.
Testes de Código
Essa biblioteca utiliza o PHPUnit. Realizamos testes com todas as principais classes dessa aplicação.
Contribuições
Veja o arquivo CONTRIBUTING para informações antes de enviar sua contribuição.
Segurança
Se você descobrir qualquer issue relacionada a segurança, por favor, envie um e-mail para [email protected] ao invés de utilizar o rastreador de issues do Github.
Créditos
- Caique Araujo
- Todos os colaboradores
Apoie o projeto
Piggly Studio é uma agência localizada no Rio de Janeiro, Brasil. Se você apreciar a função desta biblioteca e quiser apoiar este trabalho, sinta-se livre para fazer qualquer doação para a chave aleatória Pix aae2196f-5f93-46e4-89e6-73bf4138427b
❤.
License
MIT License (MIT). Veja LICENSE para mais informações.