AcapaPay · Laravel SDK

Requisitos e Instalação

Requisitos do Sistema

Componente	Versão Mínima	Notas
PHP	8.1+	Requer tipos nativos e enumerações
Laravel	9.x / 10.x / 11.x	Totalmente testado nestas versões
Guzzle / Laravel HTTP	Incluído no Laravel	Utilizado internamente pelo SDK para chamadas à API
Credenciais SSO	—	Client ID e Client Secret criados no painel Developer do SSO Acapadev

Instalação via Composer

Adicione o pacote ao seu projeto via Composer. O Laravel fará o auto-discovery do ServiceProvider automaticamente:

composer require devkussema/acapapay-laravel

Publicar o Ficheiro de Configuração (Opcional)

O SDK funciona inteiramente com variáveis .env. No entanto, se precisar de personalizar comportamentos avançados (como a model de planos para sincronização), publique o ficheiro de configuração:

php artisan vendor:publish --tag="acapapay-config"

Isto copiará o ficheiro config/acapapay.php para o diretório de configuração da sua aplicação.

Testar a Conexão (Diagnóstico)

Antes de escrever qualquer código, o SDK disponibiliza um comando Artisan de diagnóstico que envia um ping M2M ao servidor central e valida as suas credenciais e a conectividade de rede:

php artisan acapapay:test-connection

• ✅ Sucesso: Confirmação de que as credenciais são válidas e o servidor responde.
• ❌ Falha: Relatório detalhado indicando o problema exato (credenciais inválidas, firewall, SSL, etc.).