'Payout amount must be greater than zero']; } elseif (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $payout_date)) { $flash = ['err'=>'Invalid date']; } else { $payout_cents = (int)round($payout_rand * 100); $fee_cents = (int)round($fee_rand * 100); // Create local row first so we can track even if Zoho fails $local_id = db_insert('payfast_payouts', [ 'payout_amount_cents' => $payout_cents, 'fee_cents' => $fee_cents, 'payout_date' => $payout_date, 'notes' => $notes ?: null, 'status' => 'processing', 'created_by' => (int)($_SESSION['admin_id'] ?? 0) ?: null, ]); // Push to Zoho $r = zoho_record_payfast_payout($payout_cents, $fee_cents, $payout_date, $notes); if ($r['ok']) { db_exec( "UPDATE payfast_payouts SET zoho_transfer_id = :tr, zoho_expense_id = :ex, status = 'created', sync_error = NULL WHERE id = :id", ['tr'=>$r['transfer_id'], 'ex'=>$r['expense_id'] ?: null, 'id'=>$local_id] ); $flash = ['ok'=>'Payout recorded in Zoho.' . (empty($r['expense_id']) && $fee_cents > 0 ? ' (Fee expense couldn\'t be created — check that "Bank Charges" expense account exists in Zoho.)' : '')]; app_log("PayFast payout #$local_id recorded — transfer={$r['transfer_id']}, expense={$r['expense_id']}"); } else { db_exec( "UPDATE payfast_payouts SET status='error', sync_error=:e WHERE id=:id", ['e'=>mb_substr((string)$r['error'], 0, 1000), 'id'=>$local_id] ); $flash = ['err'=>'Zoho sync failed: ' . ($r['error'] ?? 'unknown')]; app_log("PayFast payout #$local_id sync failed: " . ($r['error'] ?? 'unknown')); } header('Location: payfast-payouts.php?msg='.urlencode($flash['ok'] ?? '').'&err='.urlencode($flash['err'] ?? '')); exit; } } if ($action === 'mark_received') { $id = (int)($_POST['id'] ?? 0); if ($id > 0) { db_exec( "UPDATE payfast_payouts SET status='matched', matched_at=NOW() WHERE id=:id AND status='created'", ['id'=>$id] ); } header('Location: payfast-payouts.php?msg=' . urlencode('Marked as received.')); exit; } if ($action === 'retry') { $id = (int)($_POST['id'] ?? 0); $row = db_row('SELECT * FROM payfast_payouts WHERE id=:id', ['id'=>$id]); if ($row && $row['status'] === 'error') { $r = zoho_record_payfast_payout( (int)$row['payout_amount_cents'], (int)$row['fee_cents'], (string)$row['payout_date'], (string)($row['notes'] ?? '') ); if ($r['ok']) { db_exec( "UPDATE payfast_payouts SET zoho_transfer_id=:tr, zoho_expense_id=:ex, status='created', sync_error=NULL WHERE id=:id", ['tr'=>$r['transfer_id'], 'ex'=>$r['expense_id'] ?: null, 'id'=>$id] ); $flash = ['ok'=>'Retry succeeded.']; } else { db_exec( "UPDATE payfast_payouts SET sync_error=:e WHERE id=:id", ['e'=>mb_substr((string)$r['error'], 0, 1000), 'id'=>$id] ); $flash = ['err'=>'Retry failed: ' . ($r['error'] ?? 'unknown')]; } header('Location: payfast-payouts.php?msg='.urlencode($flash['ok'] ?? '').'&err='.urlencode($flash['err'] ?? '')); exit; } } if ($action === 'delete') { // Only allows deleting an "error" row (one that never made it to Zoho) $id = (int)($_POST['id'] ?? 0); if ($id > 0) { db_exec("DELETE FROM payfast_payouts WHERE id=:id AND status='error'", ['id'=>$id]); } header('Location: payfast-payouts.php?msg=' . urlencode('Removed.')); exit; } } $page_title = 'PayFast Payouts'; require __DIR__ . '/_guard.php'; // ── Read state ────────────────────────────────────────────── $tab = $_GET['tab'] ?? 'pending'; // pending | matched | error | all $where_status = '1=1'; switch ($tab) { case 'pending': $where_status = "status='created'"; break; case 'matched': $where_status = "status='matched'"; break; case 'error': $where_status = "status IN ('error','processing')"; break; } $payouts = db_all( "SELECT * FROM payfast_payouts WHERE $where_status ORDER BY payout_date DESC, id DESC LIMIT 200" ); // Counts for the tab badges $counts = db_row(" SELECT SUM(CASE WHEN status='created' THEN 1 ELSE 0 END) AS pending, SUM(CASE WHEN status='matched' THEN 1 ELSE 0 END) AS matched, SUM(CASE WHEN status IN ('error','processing') THEN 1 ELSE 0 END) AS errored, COUNT(*) AS total FROM payfast_payouts "); // Settings — to know whether the form is operable $payfast_account_id = (string)setting_get('zoho.payfast_account_id', ''); $real_bank_account_id = (string)setting_get('zoho.real_bank_account_id', ''); $payout_fee_default = (int)setting_get('zoho.payfast_payout_fee_default_cents', 1000); $config_ok = ($payfast_account_id !== '' && $real_bank_account_id !== '' && zoho_is_configured()); function payout_status_pill(string $status): string { $map = [ 'processing' => ['label'=>'Processing', 'style'=>'background:#e5e7eb;color:#374151;'], 'created' => ['label'=>'Pending bank', 'style'=>'background:#dbeafe;color:#1e40af;'], 'matched' => ['label'=>'Received', 'style'=>'background:#dcfce7;color:#166534;'], 'error' => ['label'=>'Error', 'style'=>'background:#fee2e2;color:#991b1b;'], ]; $info = $map[$status] ?? ['label'=>ucfirst($status), 'style'=>'background:#e5e7eb;color:#374151;']; return '' . htmlspecialchars($info['label']) . ''; } function rand_fmt(int $cents): string { return 'R ' . number_format($cents/100, 2, '.', ','); } ?>

← Back to accounting

PayFast Payouts

Record a payout from PayFast → bank. We'll create the transfer and the payout fee in Zoho automatically. PayFast holding-account drops by total deducted; the matching deposit on your real bank account arrives via the bank feed.

Configuration incomplete Before recording payouts, set both the PayFast Zoho bank account and the Destination bank account in Settings → Payment Fees.

Record a payout

>
Gross amount PayFast paid out to your bank.
>
Default editable in Settings → Payment Fees.
>
Use the date PayFast initiated the payout.
>
Pending bank match Received Errors All

No payouts in this view yet.

Date Notes Payout Fee Total deducted Status
0 ? '−'.rand_fmt($fee) : '—' ?>
 ·