PHPAY-89: adicionar o gateway Woovi/OpenPix — segundo com as cinco capacidades

[mariolucasdev]

Closes #89

Nono gateway — e o segundo da biblioteca a declarar as cinco capacidades.

Por que isso importa além da cobertura

Até aqui só o Asaas populava as cinco. Isso deixava em aberto uma dúvida legítima sobre o modelo de capacidades introduzido em #72: ele generaliza, ou foi modelado em cima de um caso único?

O Woovi responde. Duas empresas independentes, com APIs independentes, preenchendo o mesmo contrato:

Gateway	Clientes	Cobranças	Assinaturas	Webhooks	Chaves Pix
Asaas	✅	✅	✅	✅	✅
Woovi/OpenPix	✅	✅	✅	✅	✅

Há um teste que assevera exatamente essa paridade — se um dos dois perder uma capacidade, ele falha.

Também confirma o que o modelo dizia sobre SupportsPixKeys: é sobre ser PSP e emitir chave própria. O AbacatePay é Pix-nativo e não tem; o Woovi é PSP e tem.

Particularidades

O AppID vai cru no Authorization — sem Bearer, sem Basic. É o único assim, e há teste garantindo que nenhum esquema é prefixado.

O sandbox tem domínio próprio: api.woovi-sandbox.com, não um subdomínio ou caminho de produção.

O webhook fica em api/openpix/v1/ enquanto os demais recursos ficam em api/v1/. Não é engano — é herança da fusão das duas marcas. Anotei no código para ninguém "corrigir" depois.

Todo objeto é endereçável pelo correlationID, o id no seu sistema em vez do id do gateway. Nenhum outro gateway da biblioteca oferece isso, então achei que valia expor em vez de esconder:

$cobranca = $phpay->charge()
    ->setCorrelationId('pedido-1')
    ->setCustomer(['name' => 'Mário Lucas', 'email' => 'fale@phpay.io'])
    ->create(10050);   // R$ 100,50

$phpay->charge()->find('pedido-1');   // pelo SEU id

Chaves Pix de verdade

$phpay->pix()->createKey(PixKeyTypeEnum::RANDOM);
$phpay->pix()->verifyKey('fale@phpay.io');      // antes de pagar um terceiro
$phpay->pix()->staticQrCode('Caixa 1');          // sem valor: o pagador escolhe

README: tabelas transpostas

Com nove gateways, uma coluna por gateway não renderia. Agora gateway é linha e capacidade é coluna — mais legível e escala daqui pra frente.

Verificação

240 testes (643 asserções), PHPStan nível 9 limpo, Pint limpo.