Skip to content

v2.4.0 — QR Code estático de Pix, CI no PHP 8.1 e a documentação em docs/

Choose a tag to compare

@mariolucasdev mariolucasdev released this 22 Oct 20:45
· 37 commits to develop since this release
04a52c3

Quatro frentes de melhoria entraram desde a v2.3.0 — e a maior delas não é código, é a documentação ficar legível.

Nenhuma assinatura de método mudou. O que mudou de lugar foi a documentação.

QR Code estático de Pix, composto aqui

Pelo padrão do BACEN um QR Code estático é montado localmente, a partir da chave: não há o que pedir a ninguém. Asaas e Woovi expõem endpoint por conveniência, a Efí não expõe — e até agora a biblioteca só podia repassar essa assimetria para quem integrava.

use PHPay\Support\{Money, StaticPixCode};

StaticPixCode::make('fale@phpay.io', 'Sixtec LTDA', 'BRASILIA')
    ->withAmount(Money::reais('100,50'))   // opcional: sem valor, o pagador digita
    ->withTxid('PEDIDO1234')               // opcional: *** quando ausente
    ->payload();

É suporte, como o Money: não é Resource, não é capacidade, não entra na enum Capability — não há chamada HTTP. Devolve só o copia-e-cola; renderizar a imagem exigiria um codificador de QR Code, e dependência nova numa biblioteca de pagamentos custa mais que a conveniência.

O CRC é a parte que erra. Ele cobre o literal 6304 que o anuncia, não para antes dele — e parar antes gera um código que simplesmente não lê, erro que aparece na frente do pagador e não no log. Por isso o vetor de teste do Manual de Padrões para Iniciação do Pix está na suíte exigindo o payload byte a byte, e também no smoke test do PHP 8.1.

Dois detalhes que valem a leitura da documentação: o nome do recebedor é exigido pelo padrão e ignorado pelo app do pagador, que mostra o nome vindo do DICT; e o txid aceita só letras e números, então PEDIDO-1234 não passa.

O PHP 8.1 passa a ser verificado por execução

O composer.json promete ^8.1, mas o CI rodava a matriz a partir do 8.2 — a compatibilidade com a versão mínima era garantida só pela análise estática. Agora existe um job próprio no 8.1: valida o composer.json, instala apenas as dependências de runtime, confere a sintaxe de src/ e roda um smoke test que carrega o autoload, instancia os nove gateways, percorre as capacidades e exercita os value objects. A suíte do Pest continua fora dessa versão, porque o toolchain de dev exige 8.2+.

Junto: cobertura de testes medida no CI, num job só, com o número no log e no resumo.

A documentação saiu do README

O README tinha 1.338 linhas e 46 KB; quem chegava pelo Packagist rolava 500 linhas de conceito antes de achar o gateway que usa. Agora tem 308 linhas, com o essencial — o que é, a matriz de capacidades, requisitos, instalação, início rápido — e um índice.

O resto virou docs/: sete páginas de conceito e nove de gateway.

Atenção: link externo que apontava para uma âncora do README antigo deixa de funcionar. O índice de docs/ cobre todos os destinos.

Nesse trabalho apareceu um defeito que estava escondido: o bloco de código do exemplo de recorrência da Cielo nunca era fechado, e cercas de markdown alternam — o título da Rede e a prosa embaixo dele renderizavam como código no GitHub, e isso seguia por AbacatePay, Woovi e Efí. Dez links do sumário apontavam para âncoras que, por causa disso, não existiam. Corrigido, e a matriz de capacidades ganhou a coluna de assinatura de webhook, que entrou na v2.3.0 e tinha ficado fora da tabela.

Para não repetir: o gate agora tem composer test:links, que confere todo link relativo e toda âncora dos markdowns do repositório — e não conta título dentro de bloco de código, que foi justamente como o erro passou.

Também

  • O Dependabot deixa de propor major do Guzzle: a 8 removeu o acessor de que a RetryPolicy depende para não repetir um POST já processado. O motivo e o que falta estão registrados.
  • 506 testes (de 483), PHPStan nível 9, e CI obrigatório para mergear.

O detalhamento item por item está no CHANGELOG.

Instalação: composer require phpay-io/phpay