# Changelog - Paylabs Payment Gateway for WooCommerce

All notable changes to this project are documented in this file.
For detailed WordPress plugin repository metadata, refer to [`readme.txt`](./readme.txt).

## [1.2.2] - 2026-09-23

Rilis ini berisi perbaikan keamanan. Seluruh merchant disarankan memperbarui.
Silakan lihat `readme.txt` bagian Upgrade Notice untuk tindakan yang perlu diambil
setelah memperbarui.

### Added
- **Kompatibilitas HPOS (High-Performance Order Storage)**: Seluruh meta order kini dibaca dan ditulis lewat CRUD API WooCommerce, menggantikan pemakaian post meta API. Kompatibilitas `custom_order_tables` dan `cart_checkout_blocks` dideklarasikan lewat `FeaturesUtil::declare_compatibility()`, sehingga peringatan "incompatible with currently enabled WooCommerce features" pada halaman Plugins tidak lagi muncul.

  Pembacaan meta tetap jatuh kembali ke penyimpanan lama bila nilai CRUD kosong. Ini menjaga order yang dibuat **sebelum** update: order VA/QRIS yang sedang menunggu pembayaran tidak kehilangan nomor VA atau link pembayarannya.
- **Header dependensi plugin**: Menambahkan `Requires Plugins: woocommerce` beserta `Requires at least`, `Requires PHP`, `WC requires at least`, `WC tested up to`, dan `License`. WordPress 6.5+ kini mencegah plugin ini diaktifkan tanpa WooCommerce dan memperingatkan sebelum WooCommerce dinonaktifkan.

### Security
- Pengerasan keamanan menyeluruh pada plugin, mencakup penanganan kredensial, verifikasi kepemilikan sebelum menampilkan data pesanan, escaping output, dan pembatasan akses langsung ke berkas plugin.

### Fixed
- **Validasi notifikasi pembayaran**: Nominal yang dibayar kini diverifikasi terhadap total order; kurang bayar material ditolak tanpa mengubah status order. Toleransi ditetapkan 1 satuan mata uang agar pembulatan nominal tidak menolak pembayaran yang sah pada toko yang memakai desimal harga.
- **Guard idempotensi notifikasi**: Notifikasi berulang tidak lagi memaksa order yang sudah `refunded`, `cancelled`, atau `completed` kembali ke status dibayar. Notifikasi sukses untuk order yang sudah batal dicatat sebagai anomali untuk ditinjau manual. Perbandingan memakai status target dari setting merchant, sehingga konfigurasi New Order Status selain `processing` tetap berjalan normal.
- **Penentuan status pembayaran**: Menambahkan pengaman agar status pembayaran order ditentukan semata-mata oleh notifikasi pembayaran yang terkonfirmasi.
- **Plugin tidak aktif di instalasi multisite**: Pemeriksaan WooCommerce hanya membaca option `active_plugins` yang bersifat per-site. Pada multisite dengan WooCommerce diaktifkan network-wide, pemeriksaan ini selalu gagal sehingga **seluruh gateway Paylabs tidak pernah terdaftar** dan metode pembayaran tidak muncul di checkout. Kini `active_sitewide_plugins` ikut diperiksa.
- **Block checkout**: Memperbaiki pembacaan setting yang menunjuk option yang tidak pernah ada, sehingga judul dan deskripsi metode pembayaran kosong. Menambahkan 17 gateway yang sebelumnya tidak didaftarkan sama sekali (hanya 4 dari 21 yang terdaftar), sehingga seluruh channel Virtual Account dan E-Wallet kini muncul pada block checkout.
- **Paylabs Payment Page (H5) tanpa url**: Respons HTTP 200 tanpa penanda error namun juga tanpa url pembayaran sebelumnya membuat customer diarahkan ke URL kosong dengan keranjang yang sudah dikosongkan dan order tertinggal berstatus pending. Kini ditangani sebagai kegagalan pembayaran, sejalan dengan perilaku channel non-H5.
- **Hook global yang menyentuh order gateway lain**: `woocommerce_thankyou` dan `woocommerce_order_details_after_order_table_items` berlaku untuk semua order, sehingga plugin ini ikut memproses pesanan dari gateway lain (COD, transfer manual, gateway pihak ketiga). Ketiga hook tersebut kini membatasi diri pada order Paylabs saja:
  - Script auto-reload halaman thank-you sebelumnya tercetak sekali untuk setiap channel (20+ kali pada satu halaman) dan terus memuat ulang selamanya. Kini tercetak satu kali dan berhenti setelah order tidak lagi menunggu pembayaran.
  - Pengurangan stok tidak lagi dijalankan untuk order gateway lain (WooCommerce inti sudah menanganinya), dan `wc_reduce_stock_levels()` kini dipanggil satu kali, bukan berulang per item.
  - Halaman detail order gateway lain tidak lagi mendapat baris tabel kosong.
- **Penanganan permintaan tidak valid**: Memperbaiki fatal error pada endpoint publik plugin ketika menerima parameter order yang kosong atau tidak valid.
- **Properti order yang deprecated**: Mengganti akses properti magic (`$order->billing_email` dan sejenisnya) dengan getter resmi, serta `new WC_Order()` dengan `wc_get_order()`.
- Menghilangkan sejumlah PHP warning pada variabel dan array key yang tidak selalu tersedia.

## [1.2.1] - 2026-09-22
### Fixed
- **Critical Hotfix**: Memperbaiki masalah pada penentuan status pembayaran order yang dapat terpicu ketika rendering email terjadi di tengah proses checkout.
- **HPOS & WooCommerce 11 Compatibility**: Menghilangkan ketergantungan pada `global $post` saat rendering email. Objek order kini diambil lewat `$email->object` dan `wc_get_order()`, sehingga kompatibel penuh dengan WooCommerce High-Performance Order Storage (HPOS) serta checkout AJAX/Store API.
- **Omnichannel Conflict Prevention**: Menyelesaikan benturan waktu dengan plugin ERP/pengiriman pihak ketiga (seperti Jubelio Shipment) dengan membatasi cakupan filter email secara ketat.
- **Defense-in-Depth**: Menambahkan pembersihan state tanpa syarat pada akhir rendering email, didukung failsafe pada siklus pengiriman email.

## [1.2.0]
- Add option "Payment Page Paylabs" per channel: redirect customer to Paylabs Payment Page (H5) with paymentType locked to the selected channel.

For previous release notes, please refer to [`readme.txt`](./readme.txt).