=== FQris for WooCommerce ===
Contributors: fqris
Tags: qris, pembayaran, woocommerce, payment gateway, indonesia
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Terima pembayaran QRIS di WooCommerce lewat FQris.

== Description ==

Pembeli membayar dengan aplikasi e-wallet atau m-banking apa pun lewat QRIS. Status order diperbarui otomatis lewat webhook FQris.

Fitur:

* Metode bayar "QRIS (FQris)" di checkout klasik dan Checkout Block.
* Kompatibel dengan HPOS (penyimpanan order kustom).
* Mode test dan live dengan API key dan webhook secret terpisah.
* Menekan "Buat pesanan" berulang tidak membuat pembayaran ganda.
* Pembayaran ganda dan nominal yang tidak cocok dicatat di order, tidak dilunasi diam-diam.

Persyaratan: WooCommerce 8.3 atau lebih baru, mata uang toko Rupiah (IDR), dan akun FQris.

== Installation ==

1. Unduh berkas zip plugin, lalu di dasbor WordPress buka Plugin > Tambah Baru > Unggah Plugin, pilih zip, klik Pasang Sekarang, lalu Aktifkan. Pastikan WooCommerce sudah aktif.
2. Pastikan mata uang toko Rupiah: WooCommerce > Pengaturan > Umum > Mata uang = Rupiah Indonesia (IDR). Metode ini tidak muncul untuk mata uang lain.
3. Di dasbor FQris buat API key (mode test: diawali `fq_test_`, mode live: `fq_live_`).
4. Di dasbor FQris tambahkan webhook endpoint dengan URL `https://domain-toko-anda/?wc-api=fqris` dan event `payment.paid`, `payment.expired`, `payment.refunded`. Salin webhook secret (`whsec_...`) yang ditampilkan. URL yang tepat juga tertulis di halaman pengaturan metode bayar.
5. Buka WooCommerce > Pengaturan > Pembayaran > QRIS (FQris), centang Aktifkan, pilih Mode, lalu isi API key dan webhook secret untuk mode itu. Simpan.
6. Coba satu pesanan di mode test: pilih QRIS (FQris) di checkout, lalu simulasikan pembayaran dari dasbor FQris. Order harus berubah menjadi "Diproses" dan muncul catatan "Dibayar via QRIS (FQris)".
7. Setelah yakin, buat API key dan webhook endpoint mode live, isi kolom live, ubah Mode ke Live.

== Frequently Asked Questions ==

= Metode bayar tidak muncul di checkout. =
Periksa: metode sudah diaktifkan, mata uang toko IDR, dan API key untuk mode yang dipilih sudah diisi.

= Order tidak berubah menjadi lunas setelah pembeli membayar. =
Periksa webhook endpoint di dasbor FQris: URL harus `https://domain-toko-anda/?wc-api=fqris`, webhook secret harus sama dengan yang diisi di plugin, dan situs harus bisa diakses dari internet. Log tersimpan di WooCommerce > Status > Log (sumber `fqris`).

= Total order berdesimal. =
QRIS hanya menerima rupiah bulat. Atur jumlah desimal harga menjadi 0 (WooCommerce > Pengaturan > Umum), atau pastikan total order bilangan bulat.

= Ada pembayaran ganda. =
Plugin menambahkan catatan di order dan tidak mengubah statusnya. Refund lewat dasbor FQris.

== Changelog ==

= 0.1.0 =
* Rilis pertama: gateway QRIS, webhook, Checkout Block, dukungan HPOS.
