kangmin/api-wipay
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e15ff0baf87b5c8b819cf88cc262353b719821f1
api-wipay/ALL_FEATURES_COMPARISON.md

15 KiB
Raw Blame History

Perbandingan Lengkap Semua Fitur: timo.wipay.id vs timo.wipay.id_api

✅ Status: Semua Fitur Sudah Sesuai

1. User Management (Manajemen Pengguna) ✅

1.1 Registrasi User (/timo/daftar) ✅

Backend Lama:

  • Input: nama, username, email, no_hp, password
  • Validasi: username & email unik
  • Password: MD5 hash
  • Default biaya_admin: 2500 (dari config.php: default_biaya_admin)
  • Response: status 200 jika berhasil

Backend Baru:

  • ✅ Input sama dengan backend lama
  • ✅ Validasi username & email unik
  • ✅ Password: MD5 hash
  • ✅ Default biaya_admin: 2500 ✅ (sudah diperbaiki)
  • ✅ Response format sama

1.2 Login (/timo/login) ✅

Backend Lama:

  • Input: username, password, fcm_token (opsional)
  • Validasi: MD5 password
  • Update FCM token jika ada
  • Response: user object + data_sl array

Backend Baru:

  • ✅ Input sama dengan backend lama
  • ✅ Validasi MD5 password
  • ✅ Update FCM token jika ada
  • ✅ Response format sama: user + data_sl

1.3 Login Token (/timo/login_token) ✅

Backend Lama:

  • Input: username, password (sudah di-hash), fcm_token
  • Validasi: password langsung compare (tidak di-hash lagi)
  • Response: user + data_sl

Backend Baru:

  • ✅ Input sama dengan backend lama
  • ✅ Validasi password langsung compare
  • ✅ Response format sama

1.4 Update Akun (/timo/update_akun) ✅

Backend Lama:

  • Update: nama_lengkap, email, no_hp
  • Validasi token
  • Response: data user terbaru

Backend Baru:

  • ✅ Update fields sama
  • ✅ Validasi token
  • ✅ Response format sama

1.5 Update Password (/timo/update_password) ✅

Backend Lama:

  • Validasi password lama (MD5)
  • Update password baru (MD5)
  • Response: status sukses/gagal

Backend Baru:

  • ✅ Validasi MD5 password lama
  • ✅ Update MD5 password baru
  • ✅ Response format sama

2. Service Line (SL) Management ✅

2.1 Cek SL (/timo/cek_sl) ✅

Backend Lama:

  • Input: token, no_sl
  • Validasi: SL tidak boleh sudah terdaftar oleh user lain (status 300)
  • Cek ke API TIMO: enquiry-dil/{no_sl}
  • Response: data pelanggan dari TIMO API

Backend Baru:

  • ✅ Input sama
  • ✅ Validasi status 300 jika sudah terdaftar
  • ✅ Cek ke API TIMO sama
  • ✅ Response format sama

2.2 Confirm SL (/timo/confirm_sl) ✅

Backend Lama:

  • Input: token, no_sl
  • Cek apakah sudah terdaftar (status 300 jika ya)
  • Cek ke API TIMO: enquiry-dil/{no_sl}
  • Simpan ke daftar_sl dengan mapping:
    • pel_nama → nama
    • pel_alamat → alamat
    • dkd_kd → cabang
    • rek_gol → golongan
  • Response: data SL yang baru terdaftar

Backend Baru:

  • ✅ Input sama
  • ✅ Validasi status 300
  • ✅ Cek ke API TIMO sama
  • ✅ Mapping field sama
  • ✅ Response format sama

2.3 Hapus SL (/timo/hapus_sl) ✅

Backend Lama:

  • Input: token, no_sl
  • Validasi: SL harus terdaftar di akun user ini
  • Delete dari daftar_sl
  • Response: status sukses

Backend Baru:

  • ✅ Input sama
  • ✅ Validasi sama
  • ✅ Delete dari database
  • ✅ Response format sama

3. Tagihan Management ✅

3.1 History Tagihan (/timo/history/{sl}/{periode}) ✅

Backend Lama:

  • Input: sl, periode (dari URL path)
  • Call TIMO API: enquiry-his/{sl}/{periode}
  • Response: data history tagihan

Backend Baru:

  • ✅ Input dari URL path sama
  • ✅ Call TIMO API sama
  • ✅ Response format sama

3.2 Tagihan Saat Ini (/timo/tagihan/{sl}) ✅

Backend Lama:

  • Input: sl (dari URL path)
  • Call TIMO API: enquiry/{sl}
  • Response: data tagihan aktif

Backend Baru:

  • ✅ Input dari URL path sama
  • ✅ Call TIMO API sama
  • ✅ Response format sama

4. Payment Flow (Alur Pembayaran) ✅

4.1 Request Pembayaran (/timo/request_pembayaran) ✅

Backend Lama:

  • Input: token, no_sl, nama_bank, no_rek
  • Cek pembayaran aktif (DIBUAT & belum expired)
  • Jika expired → update status EXPIRED
  • Buat pembayaran baru:
    • Call TIMO API: enquiry/{no_sl}
    • Hitung total + biaya admin
    • Generate kode unik
    • Expired: +1 hari
  • Response: data pembayaran

Backend Baru:

  • ✅ Input sama + payment_method (transfer/qris)
  • ✅ Cek pembayaran aktif & expired sama
  • ✅ Buat pembayaran baru sama
  • ✅ Fitur Baru: Support QRIS (< 70rb)
  • ✅ Response format sama

4.2 Cek Pembayaran (/timo/cek_pembayaran) ✅

Backend Lama:

  • Input: token, no_sl
  • Cari pembayaran: DIBUAT atau MENUNGGU VERIFIKASI
  • Response: data pembayaran

Backend Baru:

  • ✅ Input sama
  • ✅ Cari status sama
  • ✅ Response format sama

4.3 Cek Transfer (/timo/cek_transfer) ✅

Backend Lama:

  • Input: token, no_sl
  • Cari pembayaran: MENUNGGU VERIFIKASI
  • Update: tanggal_cek_bayar, banyak_cek (increment)
  • Response: data pembayaran

Backend Baru:

  • ✅ Input sama
  • ✅ Cari status sama
  • ✅ Update fields sama
  • ✅ Response format sama

4.4 Upload Bukti Transfer (/timo/upload_bukti_transfer) ✅

Backend Lama:

  • Input: token, no_sl, pembayaran (no_trx), photo (base64)
  • Upload foto
  • Update bukti_transfer & status MENUNGGU VERIFIKASI
  • Kirim Telegram ke admin
  • Response: status sukses

Backend Baru:

  • ✅ Input sama
  • ✅ Upload foto sama
  • ✅ Update status sama
  • ✅ Kirim Telegram ke admin ✅
  • ✅ Response format sama

4.5 Batal Pembayaran (/timo/batal_pembayaran) ✅

Backend Lama:

  • Input: token, no_rek (no_trx)
  • Cari pembayaran: DIBUAT
  • Update status: DIBATALKAN
  • Response: status 200 (pesan tetap default)

Backend Baru:

  • ✅ Input sama
  • ✅ Cari status sama
  • ✅ Update status sama
  • ✅ Response format sama (pesan tetap default)

4.6 Confirm Pembayaran (/timo/confirm_pembayaran) ✅

Backend Lama:

  • Input: token, no_rek (no_trx)
  • Cari pembayaran: MENUNGGU VERIFIKASI
  • Update status: DIBAYAR
  • Response: status 200 (pesan tetap default)

Backend Baru:

  • ✅ Input sama
  • ✅ Cari status sama
  • ✅ Update status sama
  • ✅ Response format sama

4.7 History Bayar (/timo/history_bayar) ✅

Backend Lama:

  • Input: token
  • Ambil semua pembayaran: DIBAYAR
  • Response: array history pembayaran

Backend Baru:

  • ✅ Input sama
  • ✅ Filter status sama
  • ✅ Response format sama

4.8 Cek Status QRIS (/timo/cek_status_qris) ✅ FITUR BARU

Backend Baru:

  • Input: token, no_sl
  • Cek status QRIS via API (max 3 attempts, 15s interval)
  • Jika paid → auto approve → kirim WhatsApp
  • Jika unpaid (setelah 3x) → show upload proof form
  • Response: status pembayaran

5. Upload Features ✅

5.1 Upload Catat Meter (/timo/upload_catat_meter) ✅

Backend Lama:

  • Input: token, no_sl, angka, photo (base64)
  • Validasi: user baru → cek no_sl tidak digunakan user lain
  • Validasi: user lama → cek no_sl sesuai dengan data user
  • Upload foto
  • Simpan ke catat_meter
  • Kirim ke external API: upload-catat-meter/{no_sl}
  • Response: status sukses

Backend Baru:

  • ✅ Input sama
  • ✅ Validasi sama (user baru/lama)
  • ✅ Upload foto sama
  • ✅ Simpan ke database sama
  • ✅ Kirim ke external API sama (payload: filename, bukan URL)
  • ✅ Response format sama

5.2 Upload Pasang Baru (/timo/upload_pasang_baru) ✅

Backend Lama:

  • Input: token, no_sl, nama, email, telepon, nik, alamat, photo
  • Upload foto
  • Simpan ke pasang_baru
  • Kirim ke external API: push-registrasi (payload dalam data key)
  • Jika berhasil, dapat reg_id (no SL baru)
  • Auto insert ke daftar_sl jika dapat no SL
  • Response: status sukses

Backend Baru:

  • ✅ Input sama
  • ✅ Upload foto sama
  • ✅ Simpan ke database sama
  • ✅ Kirim ke external API sama (payload dalam data key)
  • ✅ Auto insert ke daftar_sl jika dapat no SL
  • ✅ Response format sama

5.3 Upload Gangguan (/timo/upload_gangguan) ✅

Backend Lama:

  • Input: token, no_sl, gangguan (id jenis), feedback, lokasi, photo (opsional)
  • Validasi: jenis gangguan wajib foto jika harus_ada_foto = 'YA'
  • Insert ke gangguan dengan status DILAPORKAN
  • Upload foto jika diperlukan
  • Kirim ke external API: pengaduan/{no_sl}
  • Kirim Telegram ke admin gangguan
  • Response: status sukses

Backend Baru:

  • ✅ Input sama
  • ✅ Validasi wajib foto sama
  • ✅ Insert status DILAPORKAN sama
  • ✅ Upload foto sama
  • ✅ Kirim ke external API sama
  • ✅ Kirim Telegram ke admin gangguan ✅
  • ✅ Response format sama

5.4 Upload Baca Mandiri (/timo/upload_baca_mandiri) ✅

Backend Lama:

  • Input: token, wrute_id, stand_baca, abnorm_wm, abnorm_env, note, lonkor, latkor
  • Validasi koordinat (GPS > Geocoding > Default)
  • Kirim ke external API: upload-cater/{wrute_id} (form-urlencoded)
  • Simpan ke baca_mandiri_log
  • Response: status sukses

Backend Baru:

  • ✅ Input sama
  • ✅ Validasi koordinat sama (GPS > Geocoding > Default)
  • ✅ Kirim ke external API sama (form-urlencoded)
  • ✅ Simpan ke database sama
  • ✅ Response format sama

5.5 Upload Bukti Transfer (/timo/upload_bukti_transfer) ✅

Backend Lama:

  • Input: token, no_sl, pembayaran (no_trx), photo (base64)
  • Upload foto
  • Update bukti_transfer & status MENUNGGU VERIFIKASI
  • Response: status sukses

Backend Baru:

  • ✅ Input sama
  • ✅ Upload foto sama
  • ✅ Update status sama
  • ✅ Response format sama

5.6 Upload PP (/timo/upload_pp) ✅

Backend Lama:

  • Input: token, photo (base64)
  • Upload foto profil
  • Update photo di tabel pengguna_timo
  • Response: status sukses

Backend Baru:

  • ✅ Input sama
  • ✅ Upload foto sama
  • ✅ Update database sama
  • ✅ Response format sama

5.7 Hapus PP (/timo/hapus_pp) ✅

Backend Lama:

  • Input: token
  • Hapus foto profil
  • Update photo = NULL
  • Response: status sukses

Backend Baru:

  • ✅ Input sama
  • ✅ Hapus foto sama
  • ✅ Update database sama
  • ✅ Response format sama

6. Other Features ✅

6.1 Promo (/timo/promo) ✅

Backend Lama:

  • Response: data promo aktif

Backend Baru:

  • ✅ Response format sama

6.2 Riwayat Pasang (/timo/riwayat_pasang) ✅

Backend Lama:

  • Input: token
  • Ambil semua pasang_baru user
  • Response: array riwayat pasang baru

Backend Baru:

  • ✅ Input sama
  • ✅ Filter by token sama
  • ✅ Response format sama

6.3 Jadwal Catat Meter (/timo/jadwal_catat_meter) ✅

Backend Lama:

  • Input: token
  • Ambil jadwal catat meter user
  • Response: array jadwal

Backend Baru:

  • ✅ Input sama
  • ✅ Filter by token sama
  • ✅ Response format sama

6.4 Request Order Baca Mandiri (/timo/request_order_baca_mandiri) ✅

Backend Lama:

  • Input: token, no_sl
  • Kirim ke external API: order-cater/{no_sl} (form-urlencoded)
  • Response: status sukses

Backend Baru:

  • ✅ Input sama
  • ✅ Kirim ke external API sama (form-urlencoded)
  • ✅ Response format sama

6.5 Reset Password (/timo/buat_kode, /timo/cek_kode, /timo/reset_kode) ✅

Backend Lama:

  • buat_kode: Generate kode unik untuk reset password
  • cek_kode: Validasi kode unik
  • reset_kode: Update password dengan kode unik

Backend Baru:

  • ✅ Flow sama dengan backend lama
  • ✅ Response format sama

7. Fast WIPAY API (External) ✅

7.1 Check Bill (/fast/check_bill) ✅

Backend Lama:

  • Auth: API Key (X-Client-ID, X-Client-Secret)
  • Input: no_sl
  • Get admin user → timo user
  • Call TIMO API: enquiry/{no_sl}
  • Response: data tagihan

Backend Baru:

  • ✅ Auth API Key sama
  • ✅ Input sama
  • ✅ Flow sama
  • ✅ Response format sama

7.2 Process Payment (/fast/process_payment) ✅

Backend Lama:

  • Auth: API Key
  • Input: no_sl, amount
  • Validasi saldo WIPAY
  • Cek tagihan via TIMO API
  • Jika saldo cukup:
    • Deduct saldo WIPAY
    • Call TIMO API: payment/{token}
    • Simpan pembayaran: status DIBAYAR
  • Response: data pembayaran

Backend Baru:

  • ✅ Auth API Key sama
  • ✅ Input sama
  • ✅ Flow sama
  • ✅ Response format sama

7.3 Payment Status (/fast/payment_status) ✅

Backend Lama:

  • Auth: API Key
  • Input: transaction_id atau pembayaran_id
  • Cari pembayaran berdasarkan API Key
  • Response: status pembayaran

Backend Baru:

  • ✅ Auth API Key sama
  • ✅ Input sama
  • ✅ Filter by API Key sama
  • ✅ Response format sama

7.4 Check WIPAY Saldo (/fast/check_wipay_saldo) ✅

Backend Lama:

  • Auth: API Key
  • Get admin user → timo user → wipay user
  • Hitung saldo dari mutasi terakhir
  • Response: saldo WIPAY

Backend Baru:

  • ✅ Auth API Key sama
  • ✅ Flow sama
  • ✅ Response format sama

8. Admin API (/site/*) ✅

8.1 Verify BRI (/site/verify_bri) ✅

Backend Lama:

  • Ambil token BRI
  • Cari pembayaran BRI: MENUNGGU VERIFIKASI & banyak_cek < 2
  • Call BRI API untuk ambil mutasi
  • Bandingkan jumlah transfer dengan total pembayaran
  • Jika cocok → auto approve → kirim WhatsApp
  • Response: HTML message

Backend Baru:

  • ✅ Flow sama
  • ✅ Auto approve sama
  • ✅ Kirim WhatsApp ✅ (sudah ditambahkan)
  • ✅ Response HTML format sama

8.2 Approve (/site/approve/{id_trx}) ✅

Backend Lama:

  • Input: id_trx (dari URL path)
  • Cari pembayaran: MENUNGGU VERIFIKASI
  • Prepare data payment
  • Call TIMO API: payment/{token}
  • Jika sukses:
    • Update status: DIBAYAR
    • Set tanggal_bayar, jumlah_bayar
    • Kirim WhatsApp ke user
  • Response: status sukses/gagal

Backend Baru:

  • ✅ Input sama
  • ✅ Flow sama
  • ✅ Kirim WhatsApp ✅ (sudah ditambahkan)
  • ✅ Response format sama

9. API Mandiri (/api/mandiri/{tanggal}) ✅

Backend Lama:

  • Input: tanggal (dari URL path)
  • Ambil data catat_meter berdasarkan tanggal
  • Response: data catat meter dengan format khusus (status: 1)

Backend Baru:

  • ✅ Input sama
  • ✅ Filter by tanggal sama
  • ✅ Response format sama (status: 1)

📋 Summary

✅ Semua Fitur Sudah Sesuai:

  1. ✅ User Management - Registrasi, Login, Update Akun, Update Password
  2. ✅ SL Management - Cek SL, Confirm SL, Hapus SL
  3. ✅ Tagihan Management - History Tagihan, Tagihan Saat Ini
  4. ✅ Payment Flow - Request, Cek, Upload Bukti, Batal, Confirm, History
  5. ✅ Upload Features - Catat Meter, Pasang Baru, Gangguan, Baca Mandiri, Bukti Transfer, PP
  6. ✅ Other Features - Promo, Riwayat Pasang, Jadwal Catat Meter, Reset Password
  7. ✅ Fast WIPAY API - Check Bill, Process Payment, Payment Status, Check Saldo
  8. ✅ Admin API - Verify BRI, Approve
  9. ✅ API Mandiri - Data Catat Meter

🆕 Fitur Baru (Tidak Ada di Backend Lama):

  1. ✅ QRIS Payment - Payment method baru untuk transaksi < 70rb
  2. ✅ QRIS Status Check - Endpoint untuk cek status QRIS dengan retry mechanism

🔔 Notifikasi:

  1. ✅ Telegram - Kirim ke admin transaksi & gangguan
  2. ✅ WhatsApp - Kirim ke user setelah pembayaran berhasil (BRI & QRIS)

✅ Kesimpulan

Semua logika bisnis sudah 100% sesuai dengan backend lama (timo.wipay.id).

Tidak ada perbedaan logika bisnis yang signifikan. Semua endpoint, validasi, flow, dan response format sudah sesuai dengan backend lama.