karawaci.kode

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:

  1. Tagihan: apa yang seharusnya dibayar. Santri A, syahriah Oktober, Rp750.000 (ilustratif), lewat VA tertentu.
  2. Callback: apa yang menurut sistem sudah dibayar. Ini datang dari callback payment gateway yang diterima endpoint webhook Anda, lalu mengubah status tagihan menjadi lunas.
  3. 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 selisihContoh ilustratifDampaknya
Dibayar tapi tidak tercatatUang 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 masukAdmin menandai lunas berdasarkan foto bukti transfer di WhatsApp, tapi uangnya tidak pernah muncul di settlementKas pondok kurang, dan baru ketahuan saat tutup buku
Nominal bedaTagihan Rp750.000, yang masuk Rp700.000 karena VA bernominal terbuka atau salah inputTagihan 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 JOIN adalah 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_grace harus 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 dari p_window tidak 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:

jenisno_tagihanketeranganumur_hari
AMOUNT_MISMATCHSPP-2610-004tagihan=750000 callback=700000 settlement=7000000
PAID_NOT_RECORDEDSPP-2610-002Ada di settlement, callback tidak pernah diterima0
PAID_NOT_RECORDEDSPP-2610-004Callback diterima, tapi tagihan berstatus UNPAID0
PAID_NOT_RECORDED(kosong)Pembayaran ke VA yang tidak dikenal0
RECORDED_NOT_SETTLEDSPP-2610-003Callback ada, belum muncul di settlement0
RECORDED_NOT_SETTLEDSPP-2610-005Ditandai PAID tanpa callback maupun settlement0

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