PHPAY-85: adicionar o gateway Rede (e.Rede v2)

[mariolucasdev]

Closes #85

Sétimo gateway, e a segunda adquirente. A Rede lidera o mercado por volume transacionado (18%), à frente de Cielo e PagBank.

Capacidades: 1 de 5

Apenas SupportsCharges. É a forma mais estreita da biblioteca, ao lado do Efí, e é a esperada para uma adquirente.

Não declarei SupportsSubscriptions de propósito. A transação tem um campo subscription, mas ele é uma flag para a adquirente marcar uma cobrança recorrente — não um recurso que se liste, altere ou cancele. Declarar seria o mesmo erro que eu quase cometi com o /hooks do Pagar.me: API parecida, semântica diferente.

Duas particularidades, ambas novas

1. Host de OAuth separado, com caminho de token por ambiente

	Sandbox	Produção
API	sandbox-erede.useredecloud.com.br/v2/	api.userede.com.br/erede/v2/
OAuth	rl7-sandbox-api.useredecloud.com.br/	api.userede.com.br/
Token	oauth2/token	redelabs/oauth2/token

Repare que o caminho do token muda entre ambientes — não é só o domínio. Isso ficou em RedeEnvironment, fora do trait, para o gateway ler a configuração sem puxar os verbos HTTP que não usa.

2. O token expira — e este é o primeiro gateway assim

O Efí autoriza sob demanda mas nunca renova, porque o token dele não vence em uso normal. Aqui a resposta traz expires_in, então um processo longo precisa renegociar.

Resources/Authorization guarda o token com validade e renegocia sozinho, com margem de 30 segundos para o token nunca vencer entre ser entregue e ser usado:

$gateway = new RedeGateway(REDE_PV, REDE_TOKEN);   // nenhuma chamada de rede aqui

$gateway->authorization()->hasValidToken();
$gateway->authorization()->forget();

O Charge pede um token a cada chamada e injeta como Bearer por requisição, em vez de fixar no header do client — é o que faz a renovação ser invisível para quem usa. Há testes cobrindo o reaproveitamento, a renegociação após expirar, e o descarte manual.

⚠️ Confiança menor que nos gateways anteriores

Preciso ser explícito: nos seis anteriores eu conferi endpoints na documentação oficial. Aqui não deu.

O portal da Rede publica a documentação apenas em PDF. As URLs, os caminhos de token e o fluxo de OAuth vieram de um SDK PHP de terceiros em funcionamento (filipegar/eRede) — evidência razoável, já que é código que roda, mas não é a fonte oficial.

Bem evidenciado: URLs, caminhos de token, grant client_credentials, e os endpoints POST transactions, PUT transactions/{tid}, POST transactions/{tid}/refunds, GET transactions/{tid}.

Não confirmado: os nomes exatos de todos os campos do payload, e se a v2 suporta Pix. Por isso o escopo ficou em cartão, que é o núcleo de uma adquirente, e a checagem contra o sandbox importa mais aqui do que nos outros gateways.

Recursos

• Charge — setReference, setCard, setPayment, setSoftDescriptor, create, find, findByReference, getStatus, capture, refund
• Authorization — token, hasValidToken, forget

Verificação

171 testes (459 asserções) nesta branch — a Cielo está no #84, ainda não mergeada. PHPStan nível 9 limpo, Pint limpo.