Adicionar o gateway Pagar.me (Core API v5)

[mariolucasdev]

Parte da v2.0.0. Depende de #76.

Adicionar o Pagar.me (Core API v5) como quinto gateway. É descrito no mercado como o favorito técnico, e o SDK oficial em PHP é autogerado e pouco amigável — o que deixa espaço para o PHPay agregar.

Capacidades

Capacidade	Declara?	Motivo
SupportsCustomers	✅	/customers com CRUD completo
SupportsCharges	✅	/orders, /charges
SupportsSubscriptions	✅	/plans, /subscriptions
SupportsWebhooks	❌	/hooks lista entregas de webhook; o cadastro de endpoints é no dashboard
SupportsPixKeys	❌	Pix é payment_method do pedido

Correção de uma avaliação anterior: o Pagar.me não encaixa nas cinco capacidades. O /hooks não é CRUD de endpoints.

Particularidades a tratar

• Autenticação Basic, com a secret key como usuário e senha vazia — diferente do Bearer dos outros gateways.
• Ambiente pela chave, não por host. Teste e produção usam https://api.pagar.me/core/v5; o que muda é o prefixo sk_test_. Mesmo modelo do Mercado Pago, então sem parâmetro $sandbox.
• Valores em centavos inteiros, como no PagBank.
• Pix é payments[].payment_method com um objeto pix: { expires_in }; o copia-e-cola volta em charges[].last_transaction.qr_code.
• Cancelamento é DELETE /charges/{id}, com valor opcional no corpo para estorno parcial.

Extra fora do modelo de capacidades

O /hooks (listar entregas, obter uma, reenviar) será exposto como recurso próprio no gateway concreto, não através da facade. É o caminho que o modelo de capacidades abre para funcionalidade específica de um gateway: quem segura PagarMeGateway alcança, quem tipa uma capacidade não.