Enterprise Payment
Orchestration Platform

use Mostafax\PaymentEngine\Facades\PaymentEngine;

// Handles decryption, DB update, event firing automatically
$transaction = PaymentEngine::handleCallback(
    gateway: 'knet',
    payload: $request->all(),
);

if ($transaction->isCaptured()) {
    // fulfill order, send receipt...
}

// Live status inquiry from gateway
$response = PaymentEngine::inquire(
    trackId: $trackId,
    gateway: 'knet',
    amount:  25.500,
);
// → GatewayResponseDTO (status, amount, auth, ref...)

// In EventServiceProvider::boot()

Event::listen(PaymentCaptured::class, function(PaymentCaptured $event) {
    Order::find($event->transaction->metadata['order_id'])
        ?->markAsPaid(amount: $event->transaction->amount);
});

Event::listen(PaymentRecovered::class, function(PaymentRecovered $event) {
    // Auto-recovery happened — notify admin
    Notification::route('mail', config('payment-engine.monitoring.mail_to'))
        ->notify(new PaymentRecoveredNotification($event->transaction));
});

Event::listen(PaymentReconciled::class, function(PaymentReconciled $event) {
    if ($event->report->hasMismatches()) {
        // Send Slack / Telegram alert
    }
});

use Mostafax\PaymentEngine\Services\ReconciliationEngine;

// Synchronous reconciliation
$result = app(ReconciliationEngine::class)->run(
    gateway: 'knet',
    from:    '2026-06-01',
    to:      '2026-06-10',
);

// $result->missingInInternal  — on gateway, missing locally
// $result->amountMismatch      — differs by more than ±0.01
// $result->statusMismatch      — captured on gateway, failed locally

// Artisan
// php artisan payment:reconcile knet --from=2026-06-01 --to=2026-06-10
// php artisan payment:reconcile knet --async

use Mostafax\PaymentEngine\Services\RecoveryEngine;
use Mostafax\PaymentEngine\Services\BackfillEngine;

// Scan & recover stale pending transactions (> 30 min old)
$stats = app(RecoveryEngine::class)->recoverStale(
    olderThanMinutes: 30,
    maxPerRun: 1000,
);
// ['total' => 42, 'recovered' => 39, 'still_pending' => 3]

// Backfill missing transactions from gateway
$stats = app(BackfillEngine::class)->syncMissing(
    gateway: 'knet',
    from: '2026-01-01',
    to:   '2026-01-31',
);
// ['missing' => 7, 'created' => 7, 'errors' => 0]

// Artisan
// php artisan payment:recover --minutes=30 --max=1000
// php artisan payment:sync knet --missing --from=2026-01-01 --to=2026-01-31