AcapaPay · Laravel SDK

Configuração

Variáveis de Ambiente (.env)

A configuração mínima obrigatória é o par de credenciais OAuth. Adicione ao .env da sua aplicação:

# ─── URLs do Ecossistema AcapaDev ──────────────────────────────
# URL do servidor de identidade/OAuth (usado para obter tokens)
ACAPAPAY_HOST=https://id.acapadev.com

# URL da API (endpoints de checkout, faturas, planos)
ACAPAPAY_API_HOST=https://api.acapadev.com

# ─── Credenciais da sua App Satélite ───────────────────────────
# Criadas no painel Developer do Acapadev SSO
ACAPAPAY_CLIENT_ID=9a8b7c6d-1234-5678-abcd-ef0123456789
ACAPAPAY_CLIENT_SECRET=super_secret_do_teu_client...

# ─── Segurança de Webhooks ─────────────────────────────────────
# Chave HMAC para validar que os Webhooks são legítimos
ACAPAPAY_WEBHOOK_SECRET=hmac_secret_configurado_no_painel...

# ─── Ambiente ──────────────────────────────────────────────────
# 'production' para pagamentos reais (default se não definido)
# 'sandbox' para simulação completa de pagamentos em testes
ACAPAPAY_MODO=production

# ─── SSL (Opcional) ────────────────────────────────────────────
# Define como false APENAS em ambientes locais com certificados
# auto-assinados. NUNCA usar em produção.
# ACAPAPAY_VERIFY_SSL=false

Obter as Credenciais no Painel SSO

1. Aceda a https://id.acapadev.com e faça login com a sua conta de developer.
2. Navegue até Developer → Apps Satélite → Nova App.
3. Defina o nome da sua aplicação e o URL do Webhook (https://seudominio.com/webhooks/acapapay).
4. Após criação, copie o Client ID e o Client Secret gerados.
5. Na secção de Webhooks da App, pode também definir ou obter o Webhook Secret.

Ficheiro de Configuração (config/acapapay.php)

Após publicar a configuração, o ficheiro expõe as seguintes chaves relevantes:

<?php
return [
    'host'           => env('ACAPAPAY_HOST', 'https://id.acapadev.com'),
    'api_host'       => env('ACAPAPAY_API_HOST', 'https://api.acapadev.com'),
    'client_id'      => env('ACAPAPAY_CLIENT_ID'),
    'client_secret'  => env('ACAPAPAY_CLIENT_SECRET'),
    'webhook_secret' => env('ACAPAPAY_WEBHOOK_SECRET'),
    'modo'           => env('ACAPAPAY_MODO', 'production'),
    'verify_ssl'     => env('ACAPAPAY_VERIFY_SSL', true),

    // Model dos planos de faturação (para o sync-plans)
    'plan_model'     => \App\Models\Plan::class,
];