Lewati ke konten utama

Update Payment Page: Tampilan Kelola Pembayaran yang Terpusat & Berbasis State

Pembaruan ini memperkenalkan tampilan Payment Page baru yang memusatkan Event Transaction dan Billing Intent ke dalam satu tabel terpadu. Tujuannya adalah agar admin dapat mengelola dan memantau seluruh alur pembayaran — mulai dari tagihan hingga transaksi selesai — dalam satu halaman, dengan action button yang muncul secara dinamis sesuai state setiap baris.

ℹ️ Informasi Rilis

InformasiDetail
Tanggal RilisSenin, 4 Mei 2026
Status✅ Deployed (Production)
Tipe UpdateFeature Enhancement & UX Improvement

1. Latar Belakang Perubahan

Sebelumnya, transaksi dan tagihan dikelola di tempat-tempat terpisah. Admin harus berpindah halaman untuk mengecek status tagihan terkirim, memverifikasi bukti transfer, atau melihat billing intent yang belum direspons. Hal ini memperlambat proses verifikasi dan meningkatkan risiko terlewatnya transaksi yang butuh perhatian.

🚫 Sebelum — Data Terpisah

  • Transaksi tiket dan billing intent berada di halaman atau section yang berbeda.
  • Tidak ada indikator pusat untuk melihat jumlah pembayaran yang menunggu verifikasi.
  • Admin harus ingat status masing-masing record secara terpisah.

✅ Sesudah — Satu Tabel Terpadu

  • Seluruh transaction dan billing intent muncul dalam satu tabel yang sama.
  • Statistik total (Lunas, Menunggu, Billing Intent, Estimasi Pendapatan) tersedia di bagian atas secara real-time.
  • Filter dan pencarian terintegrasi: event, status transaksi, status tagihan, hingga pencarian invoice/nama/email.
Tampilan utama tabel kelola pembayaran

Tampilan utama halaman Kelola Pembayaran dengan statistik di atas, filter status, pencarian, dan tabel terpadu TX + BI.


2. Struktur Tabel & Badge Status

Setiap baris memiliki badge status yang bersatu antara transaksi dan billing intent:

BadgeDeskripsi
TXTransaction — catatan pembayaran langsung dari peserta.
BIBilling Intent — tagihan yang dikirim ke penerima undangan (belum menjadi transaksi).

Status masing-masing ditampilkan dengan warna dan ikon yang konsisten sehingga admin bisa membedakan tingkat urgensi dengan sekali lihat.

Status Urgensi

Baris dengan status Menunggu Verifikasi (payment_submitted) akan ditandai dengan ikon peringatan (🔔) dan highlight indigo agar admin langsung menyadari adanya bukti transfer yang perlu ditinjau.


3. Action Button Berbasis State

Tombol aksi tidak muncul semuanya sekaligus — hanya tampil sesuai state dan tipe baris yang aktif. Berikut rincian seluruh aksi yang tersedia.

A. Aksi pada Transaksi (TX)

State / KondisiAksi yang TersediaFungsi
Semua TXLihat DetailMembuka modal ringkasan transaksi
payment_submittedSetujui PembayaranKonfirmasi bukti transfer valid; transaksi jadi Lunas
payment_submittedTolak PembayaranMenolak bukti transfer dengan wajib mengisi alasan
pending_paymentKonfirmasi LunasUpload bukti transfer manual oleh admin untuk menandai lunas
pending_payment (ada DOKU)Salin Tautan PembayaranMenyalin link DOKU + rekening fallback ke clipboard
pending_payment (belum ada DOKU)Generate DOKU OrderMembuat tautan pembayaran baru via DOKU
pending_payment (metode gateway)Cek Status PembayaranMenanyakan ulang status ke gateway DOKU
materai_pendingUnduh Templat KuitansiMengunduh PDF kuitansi sebagai dasar tanda tangan e-meterai
materai_pendingUnggah E-MeteraiMengunggah dokumen tanda tangan elektronik untuk menyelesaikan transaksi
Dokumen tersediaLihat Invoice / Kuitansi / Bukti TransferMengunduh atau membuka dokumen terkait baris
Menu aksi pada baris Transaction

Menu Aksi — Transaction
Tombol aksi muncul sesuai state TX aktif. Contoh di atas menunjukkan status Menunggu Verifikasi dengan opsi Setujui / Tolak.

Menu aksi pada baris Billing Intent

Menu Aksi — Billing Intent
Billing Intent yang masih pending menampilkan opsi konfirmasi manual, tandai diterima, dan batalkan tagihan.

B. Aksi pada Billing Intent (BI)

State / KondisiAksi yang TersediaFungsi
Semua BILihat DetailMembuka modal ringkasan billing intent
pending & belum kedaluwarsaKonfirmasi LunasMenandai tagihan sebagai lunas tanpa perlu penerima membayar
pending & belum kedaluwarsaTandai DiterimaMengkonversi billing intent menjadi transaksi baru dengan status Menunggu Pembayaran
pending & belum kedaluwarsaBatalkan TagihanMembatalkan undangan; slot peserta akan dibebaskan
Modal detail transaksi

Modal Detail
Menampilkan seluruh informasi baris: data peserta, event dan riwayat status.

Dialog konfirmasi lunas manual

Konfirmasi Manual
Dialog unggah bukti transfer untuk menandai transaksi atau billing intent sebagai lunas secara admin.


4. Panduan Status & Alur (Status Legend)

Tabel dilengkapi dengan panduan status yang bisa dibuka dan ditutup. Panduan ini menjelaskan:

  • Status Transaksi (TX) — mulai dari Menunggu Pembayaran hingga Kedaluwarsa.
  • Alur TX — visual alur state normal dari tagihan hingga lunas (termasuk cabang E-Meterai jika ≥ Rp5 juta).
  • Status Billing Intent (BI) — mulai dari Undangan Terkirim hingga Undangan Dibatalkan.
  • Alur BI — visual alur konversi dari undangan ke transaksi.

Tombol ini membantu admin baru memahami sistem tanpa harus bertanya ke tim teknis.

Panduan status yang diperluas di atas tabel

Panduan Status & Alur (Status Legend)
Panel yang bisa di-expand untuk melihat penjelasan setiap status TX dan BI beserta alur state-nya.


5. Ringkasan Statistik

Empat kartu statistik muncul di bagian atas tabel:

  1. Lunas (Paid) — total nilai transaksi yang sudah dikonfirmasi lunas.
  2. Menunggu Pembayaran — total nilai transaksi yang belum dibayar.
  3. Pending Billing Intent — total nilai tagihan yang masih menunggu respons.
  4. Estimasi Pendapatan — total seluruh nilai transaksi + billing intent.
Empat kartu ringkasan di bagian atas tabel

Ringkasan Statistik
Empat kartu di atas tabel menampilkan total Lunas, Menunggu Pembayaran, Pending Billing Intent, dan Estimasi Pendapatan secara real-time.


6. Diagram Alur (Flowchart)

Berikut visualisasi alur status menggunakan diagram Mermaid agar lebih mudah dipahami.

A. Alur Transaction (TX)

B. Alur Billing Intent (BI)

Interpretasi

Billing Intent adalah "pra-transaksi". Begitu penerima merespons atau admin bertindak, BI akan dikonversi menjadi transaksi nyata atau langsung dinyatakan lunas.


📖 Glosarium

Berikut istilah-istilah teknis yang digunakan dalam tampilan ini:

IstilahPenjelasan
TXSingkatan dari Transaction — catatan pembayaran aktual yang dilakukan oleh peserta.
BISingkatan dari Billing Intent — rencana tagihan yang dikirim ke calon peserta melalui undangan; belum menjadi transaksi nyata.
DOKUPayment gateway asal Indonesia yang digunakan untuk membuat tautan pembayaran digital.
E-MeteraiTanda tangan elektronik resmi (meterai digital) yang diwajibkan untuk transaksi bernilai ≥ Rp5 juta sesuai regulasi.
Billing Intent → TransaksiProses konversi di mana penerima undangan memilih metode bayar, sehingga sistem otomatis mencatatkan transaksi baru.
Konfirmasi ManualProses di mana admin mengunggah bukti transfer atas nama peserta untuk menandai transaksi lunas secara manual.
Payment SubmittedStatus TX yang menandakan peserta sudah mengunggah bukti transfer dan sedang menunggu tinjauan admin.
Materai PendingStatus TX yang menandakan pembayaran sudah lunas tetapi transaksi masih menunggu unggahan dokumen e-meterai.