AcapaPay · Laravel SDK
Introdução e Funcionalidades Principais
O AcapaPay Laravel SDK é a biblioteca oficial para integrar de forma rápida, segura e padronizada a gateway de pagamentos centralizada do ecossistema AcapaDev em qualquer projeto baseado no Laravel Framework. Trata automaticamente da autenticação OAuth2 Machine-to-Machine (M2M), expõe componentes Blade prontos a usar, e garante que os eventos de pagamento chegam à sua aplicação de forma segura via HMAC.
🔐 Autenticação M2M Automática
Gestão transparente de Access Tokens via OAuth2 Client Credentials. Nunca precisa de gerir tokens manualmente.
💳 Checkout Integrado
Cria sessões de pagamento e redireciona utilizadores com uma única chamada via Facade.
🧩 Blade Component iFrame
Embute o checkout dentro do seu site via iFrame bidirecional com deteção automática de pagamento concluído.
🔔 Webhooks & Eventos Laravel
Recebe notificações de pagamento com validação HMAC e dispara eventos nativos do Laravel.
🔬 Modo Sandbox
Simula pagamentos completos (incluindo webhooks) sem afetar dados reais nem gateways de produção.
🔄 Sincronização de Planos
Artisan Command para sincronizar o catálogo de planos local com o portal central AcapaPay via API.
Compatibilidade Exclusiva — Laravel Obrigatório
Este pacote foi desenhado exclusivamente para o Laravel Framework. O AcapaPayServiceProvider valida em runtime se a instância da aplicação é uma Illuminate\Foundation\Application e lança um RuntimeException fatal se isso não se verificar. Não é compatível com PHP puro, Symfony ou outras frameworks. Para CodeIgniter, use o pacote dedicado.