Verde-Web/app/Services/Payment/ManualPaymentDriver.php

<?php

namespace App\Services\Payment;

use App\Models\Payment;
use Illuminate\Support\Str;

/**
 * Manual driver — admin marks payments as paid by hand. Useful for
 * dev/testing and as a fallback when a real provider is unavailable.
 */
class ManualPaymentDriver implements PaymentDriver
{
    public function initiate(Payment $payment): InitiateResult
    {
        $providerId = 'manual_'.Str::random(16);
        $payment->forceFill([
            'provider' => Payment::PROVIDER_MANUAL,
            'provider_payment_id' => $providerId,
            'status' => Payment::STATUS_PENDING,
        ])->save();

        return InitiateResult::success(null, $providerId);
    }

    public function verifyWebhook(string $rawBody, string $signature): bool
    {
        // Manual driver doesn't accept real webhooks; always reject.
        return false;
    }

    public function applyWebhook(array $payload): ?Payment
    {
        return null;
    }
}