Guia de Expansão

Adicione os valores padrão do novo gateway no array de config_defaults.php:

// Em config_defaults.php — adicionar as novas chaves:
'NOVO_GW_API_KEY'    => '',
'NOVO_GW_SECRET_KEY' => '',
'NOVO_GW_API_URL'    => 'https://api.novogateway.com/v1',

Em seguida, registre as constantes em config.php (seção de gateways, após os existentes):

// Em config.php — definir constantes:
if (!defined('NOVO_GW_API_KEY'))
    define('NOVO_GW_API_KEY', $CFG['NOVO_GW_API_KEY'] ?? '');
if (!defined('NOVO_GW_SECRET_KEY'))
    define('NOVO_GW_SECRET_KEY', $CFG['NOVO_GW_SECRET_KEY'] ?? '');

Adicione um card novo em configuracao.php seguindo o padrão dos gateways existentes. Use type="password" para tokens sensíveis e inclua a URL do webhook como campo readonly com botão de cópia:

<!-- Em configuracao.php — novo card para o gateway -->
<div class="card">
    <div class="card-header">Novo Gateway</div>
    <div class="card-body">
        <div class="row g-3">
            <div class="col-md-6">
                <label>API Key</label>
                <div class="input-group">
                    <input type="password" name="NOVO_GW_API_KEY"
                        value="<?= htmlspecialchars($v('NOVO_GW_API_KEY')) ?>">
                    <button onclick="togglePassword('novo_gw_key')">👁</button>
                </div>
            </div>
            <!-- URL do Webhook (readonly + cópia) -->
            <div class="col-12">
                <label>URL do Webhook</label>
                <div class="input-group webhook-url-group">
                    <input type="text" class="form-control" readonly
                        value="<?= BASE_URL ?>/gateways/novo_gateway/config/notification.php">
                    <button class="btn-copy-webhook">📋</button>
                </div>
            </div>
        </div>
    </div>
</div>

Crie /gateways/{novo_gateway}/pagamento.php. Ele deve:

• Incluir o config da raiz: require_once '../../config.php';
• Buscar os dados do pedido via $_GET['id'] usando buscarPedido()
• Apresentar as opções de pagamento ao cliente (PIX, Boleto, Cartão)
• Carregar os scripts do SDK/API do gateway

// Padrão mínimo de um arquivo de checkout:
require_once '../../config.php';

$pedido = buscarPedido($_GET['id'] ?? 0);
if (!$pedido) {
    header('Location: ../../index');
    exit;
}

// Atualizar o gateway no pedido:
$pdo->prepare("UPDATE pedido SET gateway='novo_gateway' WHERE id=:id")
    ->execute([':id' => $pedido['id']]);

Crie os arquivos de processamento dentro de /config/. Use cURL para comunicar com a API do gateway. Padrão recomendado:

// /gateways/novo_gateway/config/processa.php
require_once '../../../config.php';

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL            => NOVO_GW_API_URL . '/charges',
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . NOVO_GW_API_KEY],
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => AMBIENTE === 'production',
]);
$response = json_decode(curl_exec($curl), true);

if (curl_getinfo($curl, CURLINFO_HTTP_CODE) !== 200) {
    registrarLogSistema(json_encode($response), 'Novo Gateway', 'ERROR');
}

No arquivo pagamento.php da raiz, adicione o botão do novo gateway na seção de seleção para que o cliente possa escolhê-lo:

<!-- Em pagamento.php, na seção de botões de gateway -->
<div class="col-md-4">
    <a href="gateways/novo_gateway/pagamento.php?id=<?= $resultado_pedido['id'] ?>"
       class="payment-btn">
        <i class="bi bi-credit-card"></i> Pagar com Novo Gateway
    </a>
</div>

Adicione também o novo gateway no ENUM da coluna gateway na tabela pedido:

-- No banco de dados:
ALTER TABLE pedido
    MODIFY gateway ENUM('efi','asaas','mercadopago','stripe','pagarme','novo_gateway');