2026-10-22 · 12 min
Rekonsiliasi Pembayaran Otomatis: Pesantren dan UMKM Butuh Job Harian, Bukan Dashboard Realtime
Hari Santri Nasional setiap 22 Oktober mengingatkan kita pada Resolusi Jihad 22 Oktober 1945, seruan para ulama yang menggerakkan santri ikut mempertahankan kemerdekaan yang baru saja diproklamasikan. Tulisan ini membahas sesuatu yang jauh lebih sederhana dan sama sekali tidak heroik, tapi ikut menentukan apakah sebuah pesantren bisa berjalan tenang: rekonsiliasi pembayaran otomatis, pekerjaan mencocokkan uang yang benar-benar masuk dengan uang yang dicatat sudah masuk.
Bayangkan sebuah pesantren fiktif, sebut saja Pondok Al-Misal di pinggiran Tangerang. Bendaharanya, Ustazah Hilma (tokoh rekaan), menerbitkan tagihan syahriah setiap awal bulan untuk beberapa ratus santri. Sejak pondok memakai virtual account dari payment gateway, wali santri tidak perlu lagi antre di kantor tata usaha. Pembayaran masuk, callback menandai tagihan lunas, dan semuanya terlihat beres. Sampai suatu pagi seorang wali menelepon: anaknya ditegur karena syahriah bulan ini “belum dibayar”, padahal ia punya bukti transfer ke VA yang benar.
Semua angka dan nama di artikel ini ilustratif. Pesantren saya pakai sebagai contoh kasus karena pola tagihannya sangat jelas: tagihan bulanan, nominal tetap, pembayar yang banyak, dan satu orang bendahara yang menanggung semuanya. Polanya sama persis untuk katering langganan, bimbel, kos-kosan, atau UMKM mana pun yang menagih pelanggan secara rutin.
Argumen saya sederhana dan mungkin terdengar kurang keren: job rekonsiliasi harian yang membosankan jauh lebih penting daripada dashboard realtime. Tapi sebelum membela argumen itu, jawab dulu pertanyaan yang paling praktis.
Verdict Dulu: Cukup Laporan Gateway, atau Bangun Job Sendiri?
Jangan membangun apa pun sebelum memastikan Anda memang membutuhkannya. Payment gateway umumnya sudah menyediakan laporan transaksi dan laporan settlement yang bisa diunduh, dan untuk sebagian bisnis itu sudah cukup.
Cukup pakai laporan atau settlement report dari payment gateway kalau:
- Semua pembayaran masuk lewat satu gateway. Tidak ada transfer langsung ke rekening, tidak ada pembayaran tunai yang kemudian diinput manual.
- Tidak ada orang yang bisa menandai tagihan lunas secara manual di sistem Anda.
- Jumlah transaksinya masih bisa dicek satu orang dalam waktu singkat, misalnya dengan mencocokkan CSV settlement ke ekspor tagihan di spreadsheet seminggu sekali.
- Status lunas tidak memicu konsekuensi otomatis, seperti memblokir akses aplikasi, menahan kartu ujian, atau menghentikan layanan.
Bangun job rekonsiliasi sendiri kalau satu saja dari kondisi ini berlaku:
- Ada lebih dari satu kanal pembayaran: VA lewat gateway, transfer langsung, QRIS, atau tunai di loket.
- Ada lebih dari satu orang yang bisa mengubah status tagihan.
- Status lunas di sistem Anda menentukan sesuatu yang penting bagi pembayar.
- Anda sudah pernah mengalami kejadian “pembayar bilang sudah bayar, sistem bilang belum”, dan butuh lebih dari sepuluh menit untuk membuktikan siapa yang benar.
Kenapa laporan gateway tidak cukup untuk kasus kedua? Karena gateway hanya tahu apa yang ia terima. Gateway tidak tahu apa yang Anda tagih, dan tidak tahu apa yang sistem Anda yakini. Rekonsiliasi payment gateway versi bawaan mencocokkan transaksi dengan pencairan di sisi mereka. Rekonsiliasi yang Anda butuhkan mencocokkan tiga catatan sekaligus.
Tiga Catatan yang Tidak Pernah Sama
Di Pondok Al-Misal, setiap rupiah syahriah punya tiga jejak:
- Tagihan: apa yang seharusnya dibayar. Santri A, syahriah Oktober, Rp750.000 (ilustratif), lewat VA tertentu.
- Callback: apa yang menurut sistem sudah dibayar. Ini datang dari callback payment gateway yang diterima endpoint webhook Anda, lalu mengubah status tagihan menjadi lunas.
- Settlement: apa yang benar-benar dicairkan gateway ke rekening pondok, tercatat di laporan settlement dan pada akhirnya di mutasi rekening.
Dalam kondisi ideal, ketiganya identik. Dalam kenyataan, ada tiga jenis selisih yang terus berulang:
| Jenis selisih | Contoh ilustratif | Dampaknya |
|---|---|---|
| Dibayar tapi tidak tercatat | Uang ada di settlement, tapi callback tidak pernah diterima atau gagal diproses, sehingga tagihan masih “belum lunas” | Santri ditegur padahal walinya sudah bayar |
| Tercatat tapi tidak masuk | Admin menandai lunas berdasarkan foto bukti transfer di WhatsApp, tapi uangnya tidak pernah muncul di settlement | Kas pondok kurang, dan baru ketahuan saat tutup buku |
| Nominal beda | Tagihan Rp750.000, yang masuk Rp700.000 karena VA bernominal terbuka atau salah input | Tagihan terlihat lunas, padahal kurang bayar |
Selisih jenis pertama adalah yang paling menyakitkan secara reputasi. Jenis kedua paling menyakitkan secara keuangan. Jenis ketiga paling sulit dideteksi karena semua orang mengira urusannya sudah selesai.
Callback yang hilang bukan kejadian langka di dunia webhook. Server Anda bisa sedang restart, sertifikat TLS kedaluwarsa, handler melempar exception setelah membalas 200, atau retry dari gateway sudah habis. Saya tidak akan mengulang cara mengamankan dan menstabilkan callback di sini. Kalau handler webhook Anda belum memverifikasi signature dan belum idempoten, baca dulu tiga lapis keamanan webhook: HMAC, idempotency key, dan replay attack, lalu pola retry dan idempotency webhook di production. Untuk gambaran integrasi pembayaran dari sisi SaaS, ada juga catatan integrasi QRIS lewat aggregator vs direct.
Poin saya justru ini: seandal apa pun handler callback Anda, ia tetap bisa gagal. Rekonsiliasi adalah lapisan yang menangkap kegagalan itu, bukan menggantikan perbaikan di handler.
Kenapa Dashboard Realtime Adalah Jawaban untuk Pertanyaan yang Salah
Setiap kali saya membahas sistem pembayaran SPP pesantren atau sistem tagihan UMKM dengan pengembangnya, permintaan yang paling sering muncul adalah dashboard: grafik pemasukan hari ini, jumlah santri yang sudah bayar, angka yang bergerak setiap ada transaksi. Saya mengerti daya tariknya. Dashboard terlihat seperti kontrol.
Masalahnya, dashboard realtime hampir selalu membaca dari catatan kedua, yaitu status tagihan yang diubah oleh callback. Itu persis catatan yang sedang kita ragukan. Kalau callback hilang, dashboard tidak menampilkan error. Ia menampilkan angka yang salah dengan sangat percaya diri, dan diperbarui setiap detik.
Ada tiga alasan lain kenapa saya menaruh job harian di atas dashboard:
Kebenaran datang per hari, bukan per detik. Laporan settlement dari gateway umumnya terbit per hari atau per periode pencairan sesuai kontrak. Dashboard yang diperbarui setiap detik lebih cepat dari sumber kebenarannya sendiri. Kecepatan itu tidak menambah kepastian.
Bendahara butuh daftar pengecualian, bukan grafik. Ustazah Hilma tidak perlu tahu berapa persen santri yang sudah bayar. Ia perlu tahu tiga nama yang statusnya janggal, lengkap dengan alasannya. Laporan yang kosong berarti hari itu aman. Laporan yang berisi tiga baris berarti ada tiga hal yang perlu ia kerjakan sebelum zuhur.
Biaya perawatannya berbeda jauh. Dashboard butuh frontend, autentikasi, hosting yang selalu menyala, dan orang yang rutin membukanya. Job rekonsiliasi cukup berupa satu fungsi SQL, satu skrip shell, dan satu baris crontab. Untuk pesantren dan UMKM yang tim IT-nya satu orang, atau malah relawan alumni, perbedaan ini menentukan apakah sistemnya masih jalan setahun lagi.
Dashboard boleh menyusul. Tapi kalau anggaran waktu Anda hanya cukup untuk satu, bangun yang membosankan dulu.
Reference Implementation: Rekonsiliasi Virtual Account dengan SQL dan Cron
Implementasi di bawah ini sengaja minimal: PostgreSQL, psql, bash, dan cron. Asumsinya, setiap tagihan punya nomor VA sendiri dengan nominal tertutup, sehingga nomor VA unik per tagihan. Kalau Anda memakai VA tetap per santri, ganti kunci pencocokan dari va_number menjadi pasangan nomor VA dan referensi periode.
Saya sudah menjalankan seluruh SQL ini di PostgreSQL 16 dengan data uji fiktif.
1. Empat tabel
-- Tagihan yang diterbitkan sistem
CREATE TABLE invoices (
id BIGSERIAL PRIMARY KEY,
invoice_no TEXT NOT NULL UNIQUE,
payer_name TEXT NOT NULL,
period DATE NOT NULL, -- bulan tagihan, misal 2026-10-01
va_number TEXT NOT NULL UNIQUE, -- satu tagihan satu VA
amount BIGINT NOT NULL CHECK (amount > 0), -- rupiah, tanpa desimal
status TEXT NOT NULL DEFAULT 'UNPAID'
CHECK (status IN ('UNPAID', 'PAID', 'VOID')),
paid_at TIMESTAMPTZ,
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
-- Setiap callback yang diterima dari payment gateway
CREATE TABLE payment_callbacks (
id BIGSERIAL PRIMARY KEY,
gateway_txn_id TEXT NOT NULL UNIQUE, -- kunci idempotency
va_number TEXT NOT NULL,
amount BIGINT NOT NULL,
paid_at TIMESTAMPTZ NOT NULL,
raw_payload JSONB NOT NULL,
received_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
-- Baris dari laporan settlement yang diunduh dari gateway
CREATE TABLE settlement_lines (
id BIGSERIAL PRIMARY KEY,
gateway_txn_id TEXT NOT NULL UNIQUE,
va_number TEXT NOT NULL,
gross_amount BIGINT NOT NULL,
fee BIGINT NOT NULL DEFAULT 0,
net_amount BIGINT NOT NULL,
txn_time TIMESTAMPTZ NOT NULL,
settled_on DATE,
source_file TEXT NOT NULL,
imported_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
-- Hasil rekonsiliasi: satu baris per selisih
CREATE TABLE recon_findings (
id BIGSERIAL PRIMARY KEY,
kind TEXT NOT NULL CHECK (kind IN
('PAID_NOT_RECORDED', 'RECORDED_NOT_SETTLED', 'AMOUNT_MISMATCH')),
ref_key TEXT NOT NULL,
invoice_no TEXT,
expected BIGINT,
actual BIGINT,
note TEXT NOT NULL,
ref_time TIMESTAMPTZ NOT NULL,
first_seen_at TIMESTAMPTZ NOT NULL,
last_seen_at TIMESTAMPTZ NOT NULL,
resolved_at TIMESTAMPTZ,
resolved_by TEXT,
resolution_note TEXT,
UNIQUE (kind, ref_key)
);
Dua keputusan kecil di sini penting. Nominal disimpan sebagai BIGINT rupiah, bukan FLOAT, karena selisih satu rupiah akibat pembulatan akan memenuhi laporan Anda dengan temuan palsu. Lalu raw_payload disimpan utuh, karena saat bendahara bertanya “sebenarnya gateway mengirim apa?”, Anda butuh jawabannya tanpa menebak.
2. Yang dilakukan callback handler
Handler webhook cukup melakukan dua hal dalam satu transaksi. Placeholder $1 sampai $5 diisi oleh driver database Anda:
BEGIN;
INSERT INTO payment_callbacks (gateway_txn_id, va_number, amount, paid_at, raw_payload)
VALUES ($1, $2, $3, $4, $5)
ON CONFLICT (gateway_txn_id) DO NOTHING;
UPDATE invoices
SET status = 'PAID', paid_at = $4
WHERE va_number = $2
AND status = 'UNPAID'
AND amount = $3;
COMMIT;
Perhatikan syarat amount = $3. Kalau nominalnya beda, handler sengaja tidak menandai lunas. Biarkan job rekonsiliasi yang mengangkatnya ke permukaan, bukan handler yang memutuskan diam-diam.
3. Impor laporan settlement
Format CSV settlement berbeda di setiap gateway, jadi sesuaikan kolom staging dengan file milik Anda. Skrip ini membaca CSV dari standard input:
-- import-settlement.sql
-- Dipanggil: psql ... -v source_file=nama.csv -f import-settlement.sql < nama.csv
CREATE TEMP TABLE settlement_staging (
gateway_txn_id TEXT,
va_number TEXT,
gross_amount BIGINT,
fee BIGINT,
net_amount BIGINT,
txn_time TIMESTAMPTZ,
settled_on DATE
);
\copy settlement_staging FROM pstdin WITH (FORMAT csv, HEADER true)
INSERT INTO settlement_lines
(gateway_txn_id, va_number, gross_amount, fee, net_amount,
txn_time, settled_on, source_file)
SELECT gateway_txn_id, va_number, gross_amount, fee, net_amount,
txn_time, settled_on, :'source_file'
FROM settlement_staging
ON CONFLICT (gateway_txn_id) DO NOTHING;
ON CONFLICT DO NOTHING membuat impor aman diulang. Kalau file yang sama tidak sengaja diimpor dua kali, tidak ada transaksi yang tercatat ganda.
4. Inti cron job rekonsiliasi SQL
Ini bagian yang mencocokkan callback dengan settlement, lalu membandingkan keduanya dengan tagihan. Semuanya dibungkus dalam satu fungsi supaya cron cukup memanggil satu baris:
CREATE OR REPLACE FUNCTION run_reconciliation(
p_window interval DEFAULT interval '14 days', -- rentang yang dipindai
p_grace interval DEFAULT interval '3 days' -- masa tunggu settlement
) RETURNS integer
LANGUAGE plpgsql AS $$
DECLARE
v_open integer;
BEGIN
WITH matched AS (
SELECT
COALESCE(c.gateway_txn_id, s.gateway_txn_id) AS txn_id,
COALESCE(c.paid_at, s.txn_time) AS ref_time,
c.amount AS cb_amount,
s.gross_amount AS st_amount,
i.invoice_no,
i.amount AS inv_amount,
i.status AS inv_status
FROM payment_callbacks c
FULL OUTER JOIN settlement_lines s
ON s.gateway_txn_id = c.gateway_txn_id
LEFT JOIN invoices i
ON i.va_number = COALESCE(c.va_number, s.va_number)
WHERE COALESCE(c.paid_at, s.txn_time) >= now() - p_window
),
findings AS (
-- 1. Uang masuk, tapi tagihan tidak berstatus PAID
SELECT 'PAID_NOT_RECORDED' AS kind,
'txn:' || txn_id AS ref_key,
invoice_no,
inv_amount AS expected,
COALESCE(st_amount, cb_amount) AS actual,
CASE
WHEN invoice_no IS NULL THEN 'Pembayaran ke VA yang tidak dikenal'
WHEN cb_amount IS NULL THEN 'Ada di settlement, callback tidak pernah diterima'
ELSE 'Callback diterima, tapi tagihan berstatus ' || inv_status
END AS note,
ref_time
FROM matched
WHERE inv_status IS DISTINCT FROM 'PAID'
UNION ALL
-- 2a. Callback ada, settlement belum muncul setelah masa tenggang
SELECT 'RECORDED_NOT_SETTLED', 'txn:' || txn_id, invoice_no,
cb_amount, NULL,
'Callback ada, belum muncul di settlement',
ref_time
FROM matched
WHERE cb_amount IS NOT NULL
AND st_amount IS NULL
AND ref_time < now() - p_grace
UNION ALL
-- 2b. Ditandai lunas manual, tanpa jejak di gateway sama sekali
SELECT 'RECORDED_NOT_SETTLED', 'inv:' || i.invoice_no, i.invoice_no,
i.amount, NULL,
'Ditandai PAID tanpa callback maupun settlement',
i.paid_at
FROM invoices i
WHERE i.status = 'PAID'
AND i.paid_at >= now() - p_window
AND i.paid_at < now() - p_grace
AND NOT EXISTS (SELECT 1 FROM payment_callbacks c WHERE c.va_number = i.va_number)
AND NOT EXISTS (SELECT 1 FROM settlement_lines s WHERE s.va_number = i.va_number)
UNION ALL
-- 3. Nominal tidak sama di salah satu pasangan
SELECT 'AMOUNT_MISMATCH', 'txn:' || txn_id, invoice_no,
inv_amount, COALESCE(st_amount, cb_amount),
format('tagihan=%s callback=%s settlement=%s',
COALESCE(inv_amount::text, '-'),
COALESCE(cb_amount::text, '-'),
COALESCE(st_amount::text, '-')),
ref_time
FROM matched
WHERE cb_amount <> st_amount
OR cb_amount <> inv_amount
OR st_amount <> inv_amount
)
INSERT INTO recon_findings AS f
(kind, ref_key, invoice_no, expected, actual, note,
ref_time, first_seen_at, last_seen_at)
SELECT kind, ref_key, invoice_no, expected, actual, note,
ref_time, now(), now()
FROM findings
ON CONFLICT (kind, ref_key) DO UPDATE
SET expected = EXCLUDED.expected,
actual = EXCLUDED.actual,
note = EXCLUDED.note,
last_seen_at = EXCLUDED.last_seen_at,
-- temuan yang ditutup otomatis boleh dibuka lagi,
-- temuan yang ditutup manusia tidak diganggu
resolved_at = CASE WHEN f.resolved_by = 'auto' THEN NULL ELSE f.resolved_at END,
resolved_by = CASE WHEN f.resolved_by = 'auto' THEN NULL ELSE f.resolved_by END;
-- Tutup otomatis temuan yang hari ini tidak muncul lagi,
-- tapi hanya kalau sumbernya masih di dalam jendela pemindaian.
UPDATE recon_findings
SET resolved_at = now(),
resolved_by = 'auto'
WHERE resolved_at IS NULL
AND last_seen_at < now()
AND ref_time >= now() - p_window;
SELECT count(*) INTO v_open
FROM recon_findings
WHERE resolved_at IS NULL;
RETURN v_open;
END;
$$;
Beberapa hal yang perlu dipahami sebelum memakainya:
FULL OUTER JOINadalah jantungnya. Join biasa hanya menampilkan transaksi yang ada di kedua sisi, padahal yang kita cari justru transaksi yang hanya ada di salah satu sisi.p_graceharus mengikuti jadwal settlement di kontrak Anda. Kalau gateway Anda mencairkan dana beberapa hari kerja setelah transaksi, masa tenggang tiga hari akan menghasilkan temuan palsu setiap Senin. Tanyakan jadwalnya ke gateway, jangan menebak.- Temuan yang hilang ditutup otomatis, tapi dengan batas. Kalau settlement yang terlambat akhirnya masuk, temuan “tercatat tapi tidak masuk” tertutup sendiri dengan
resolved_by = 'auto'. Temuan yang sudah lebih tua darip_windowtidak ditutup otomatis. Selisih berumur dua minggu memang pantas diperiksa manusia. - Penutupan oleh manusia bersifat permanen. Kalau bendahara sudah memutuskan sesuatu, misalnya mengembalikan dana yang masuk ke tagihan yang sudah dibatalkan, job tidak akan membukanya lagi setiap pagi.
Bendahara atau admin menutup temuan dengan satu perintah, idealnya lewat tombol kecil di aplikasi admin:
UPDATE recon_findings
SET resolved_at = now(),
resolved_by = 'Bendahara',
resolution_note = 'Dana dikembalikan ke wali, tagihan sudah VOID'
WHERE id = 42;
5. Skrip harian dan crontab
#!/usr/bin/env bash
# /opt/recon/run-recon.sh
set -euo pipefail
: "${DATABASE_URL:?DATABASE_URL belum di-set}"
BASE=/opt/recon
INBOX=/var/lib/recon/inbox # tempat menaruh CSV settlement
DONE=/var/lib/recon/processed
REPORTS=/var/lib/recon/reports
TODAY=$(date +%F)
mkdir -p "$INBOX" "$DONE" "$REPORTS"
# 1. Impor semua file settlement yang baru masuk
for f in "$INBOX"/*.csv; do
[[ -e "$f" ]] || continue
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -q \
-v source_file="$(basename "$f")" \
-f "$BASE/import-settlement.sql" < "$f"
mv "$f" "$DONE/"
done
# 2. Jalankan rekonsiliasi
OPEN=$(psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -tA -c "SELECT run_reconciliation();")
# 3. Tulis laporan harian untuk bendahara
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 --csv \
-f "$BASE/daily-report.sql" > "$REPORTS/rekon-$TODAY.csv"
echo "$(date -Is) selisih terbuka: $OPEN, laporan: $REPORTS/rekon-$TODAY.csv"
Baris crontab-nya, dengan asumsi zona waktu server sudah Asia/Jakarta dan password database disimpan di ~/.pgpass:
30 5 * * * DATABASE_URL='postgresql://recon@localhost/pondok' /opt/recon/run-recon.sh >> /var/log/recon.log 2>&1
Cara CSV settlement sampai ke folder inbox bisa sesederhana bendahara mengunduhnya dari dashboard gateway lalu mengunggahnya, atau lebih otomatis kalau gateway Anda menyediakan API laporan. Mulailah dari cara manual. Otomatisasi pengunduhan bisa menyusul setelah alurnya terbukti berguna.
Opsi --csv di psql tersedia sejak PostgreSQL 12, jadi pastikan klien psql di server tidak terlalu lama.
6. Laporan harian untuk bendahara
-- daily-report.sql
SELECT
f.kind AS jenis,
f.invoice_no AS no_tagihan,
i.payer_name AS nama,
to_char(i.period, 'YYYY-MM') AS periode,
f.expected AS seharusnya,
f.actual AS tercatat,
f.note AS keterangan,
current_date - f.first_seen_at::date AS umur_hari
FROM recon_findings f
LEFT JOIN invoices i ON i.invoice_no = f.invoice_no
WHERE f.resolved_at IS NULL
ORDER BY umur_hari DESC, f.kind, f.invoice_no;
Dengan data uji fiktif, laporan pagi Ustazah Hilma kira-kira berbentuk seperti ini:
| jenis | no_tagihan | keterangan | umur_hari |
|---|---|---|---|
| AMOUNT_MISMATCH | SPP-2610-004 | tagihan=750000 callback=700000 settlement=700000 | 0 |
| PAID_NOT_RECORDED | SPP-2610-002 | Ada di settlement, callback tidak pernah diterima | 0 |
| PAID_NOT_RECORDED | SPP-2610-004 | Callback diterima, tapi tagihan berstatus UNPAID | 0 |
| PAID_NOT_RECORDED | (kosong) | Pembayaran ke VA yang tidak dikenal | 0 |
| RECORDED_NOT_SETTLED | SPP-2610-003 | Callback ada, belum muncul di settlement | 0 |
| RECORDED_NOT_SETTLED | SPP-2610-005 | Ditandai PAID tanpa callback maupun settlement | 0 |
Baris kedua adalah wali santri yang menelepon tadi. Uangnya ada, callback-nya hilang. Tanpa laporan ini, membuktikannya butuh membuka dashboard gateway, mencari nomor VA, dan mencocokkan tanggal secara manual. Dengan laporan ini, jawabannya sudah tertulis sebelum telepon itu datang.
Perhatikan juga tagihan SPP-2610-004 yang muncul dua kali, sebagai nominal beda dan sebagai belum lunas. Itu disengaja. Keduanya adalah fakta yang berbeda, dan bendahara perlu melihat keduanya untuk memutuskan apakah wali diminta melunasi kekurangannya atau tagihannya dikoreksi.
Kolom umur_hari adalah kolom yang paling sering saya lihat diabaikan, padahal paling penting. Selisih berumur nol hari itu wajar. Selisih berumur sepuluh hari berarti ada proses yang macet.
Kalau bendahara lebih suka ringkasan, tambahkan satu kueri ini di atas laporan:
SELECT kind, count(*) AS jumlah, sum(COALESCE(actual, expected)) AS total_rupiah
FROM recon_findings
WHERE resolved_at IS NULL
GROUP BY kind
ORDER BY kind;
Yang Sengaja Tidak Dikerjakan Job Ini
Implementasi minimal berarti ada hal yang sengaja ditinggalkan. Saya lebih suka menyebutnya terang-terangan daripada membiarkan Anda mengira semuanya sudah tertangani.
Tidak ada koreksi otomatis. Job ini tidak pernah mengubah status tagihan. Pembayaran ke tagihan yang sudah VOID, wali yang membayar dua bulan sekaligus, atau dana yang perlu dikembalikan, semuanya butuh keputusan manusia yang tahu konteksnya. Koreksi otomatis yang salah jauh lebih sulit dilacak daripada selisih yang menunggu satu hari.
Belum mencocokkan ke mutasi rekening. Settlement adalah klaim gateway bahwa mereka sudah mencairkan dana. Langkah berikutnya adalah mencocokkan total net_amount per tanggal pencairan dengan mutasi rekening pondok dari internet banking. Itu layak dibangun kalau lapisan pertama sudah berjalan beberapa bulan dan terbukti dipakai.
Belum menangani pembayaran ganda ke satu tagihan. Dengan VA nominal tertutup, kasus ini jarang terjadi. Dengan VA tetap per santri, kasus ini perlu kueri tambahan yang mengelompokkan transaksi per VA dan periode.
Belum ada notifikasi. Mengirim laporan ke email atau grup WhatsApp bendahara itu urusan lima belas menit. Tapi pastikan dulu isi laporannya dipercaya. Notifikasi yang berisi temuan palsu setiap hari akan diabaikan dalam seminggu.
Untuk UMKM: Rumusnya Sama Persis
Ganti “syahriah” dengan “langganan katering mingguan”, “santri” dengan “pelanggan”, dan “bendahara” dengan pemilik usaha yang merangkap admin keuangan. Tiga catatan yang sama tetap ada: tagihan, callback, dan settlement. Tiga jenis selisih yang sama tetap muncul.
Bedanya, di UMKM kanal pembayaran biasanya lebih campur aduk. Ada VA, QRIS, transfer langsung ke rekening pemilik, dan kadang pembayaran tunai yang dicatat di buku. Justru di sinilah rekonsiliasi pembayaran otomatis paling terasa manfaatnya, karena semakin banyak kanal, semakin besar peluang ada transaksi yang lolos dari salah satu catatan. Satu prinsip yang saya pegang: setiap kanal yang bisa mengubah status lunas harus punya sumber data yang bisa direkonsiliasi. Kalau ada kanal yang tidak bisa direkonsiliasi, misalnya status lunas yang ditandai manual dari foto bukti transfer, kanal itu harus muncul di laporan sebagai kategori tersendiri, seperti cabang 2b di atas.
Penutup
Saya tidak anti dashboard. Saya hanya menolak urutan prioritas yang menempatkan grafik yang bergerak di atas kepastian bahwa angkanya benar. Untuk pesantren yang mengelola titipan wali santri, dan untuk UMKM yang marginnya tipis, kepastian itu bukan fitur tambahan. Itu fondasinya.
Kalau Anda hanya punya satu akhir pekan, urutannya begini: pastikan handler callback idempoten dan menyimpan payload mentah, buat tabel settlement_lines dan impor CSV pertama Anda, jalankan run_reconciliation() secara manual, lalu baca hasilnya bersama bendahara. Kalau laporan pertama itu berisi selisih yang tidak pernah Anda duga, dan biasanya memang begitu, Anda sudah tahu job ini layak masuk crontab.
Ditulis oleh Reno Adipraja