=== NICEPay Payment Gateway for WooCommerce ===
Contributors: nicepay
Tags: woocommerce, payment, nicepay, checkout, indonesia
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 1.0.1
Requires PHP: 7.4
Requires Plugins: woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Official NICEPay payment gateway for WooCommerce. Single checkout option with redirect to the NICEPay hosted payment page.

== Description ==

**NICEPay Payment Gateway for WooCommerce** is the official NICEPay integration for WooCommerce stores in Indonesia.

It provides a single checkout payment method — **NICEPay Redirect**. After customers place an order, they are redirected to the secure NICEPay payment page to choose from the payment methods enabled on your merchant account (Credit Card, Virtual Account, QRIS, E-Wallet, CVS, Payloan, and more).

**Key features:**

* Single checkout gateway — All Payment Method (payMethod 00)
* Redirect to NICEPay hosted payment page (no card data stored on your site)
* WooCommerce Blocks checkout support
* HPOS (Custom Order Tables) compatible
* Centralized admin page: **WooCommerce → NICEPay Payment Gateway**
* Payment notification validation (status, referenceNo, txId, merchantToken SHA256)
* Payment status verification via NICEPay inquiry API before updating order status
* Optional debug logs (visible in **NICEPay Logs** admin menu when Debug Mode is enabled)
* Optional "Powered by NICEPAY" attribution on the thank-you page (disabled by default)
* Sandbox and production environments (Premise and Cloud hosts)

**Requirements:**

* [WooCommerce](https://wordpress.org/plugins/woocommerce/) plugin
* Active NICEPay merchant account with Merchant ID (iMid) and Merchant Key
* Currency: IDR

**Documentation & support:**

* [NICEPay Documentation](https://docs.nicepay.co.id)
* Integration: integration@nicepay.co.id
* Technical support: technical.support@nicepay.co.id

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/nicepay-payment-gateway-for-woocommerce`, or install via the WordPress Plugins screen.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Ensure WooCommerce is installed and active.
4. Open **WooCommerce → NICEPay Payment Gateway**.
5. Set **Environment** (Sandbox or Production) and **Host** (Premise or Cloud).
6. Click **Configure** for **NICEPay Redirect**, then enter your **Merchant ID** and **Merchant Key** from the NICEPay Merchant Dashboard.
7. Place a test order in Sandbox before switching to Production.

== Frequently Asked Questions ==

= Is this the official NICEPay plugin? =

Yes. This plugin is developed and maintained by NICEPay as the official WooCommerce payment gateway integration.

= How do I get a Merchant ID and Merchant Key? =

Register at the NICEPay Merchant Dashboard and request API credentials (iMid / Merchant ID and Merchant Key). Visit [nicepay.co.id](https://www.nicepay.co.id) for more information.

= Does this support WooCommerce Blocks checkout? =

Yes. This plugin includes WooCommerce Blocks checkout integration and declares compatibility with Cart/Checkout Blocks.

= Does this support WooCommerce HPOS (Custom Order Tables)? =

Yes. The plugin declares compatibility with WooCommerce High-Performance Order Storage (HPOS).

= Do customers choose VA, QRIS, or E-Wallet on the WooCommerce checkout page? =

No. Customers see **NICEPay Redirect** on the WooCommerce checkout page, then choose their payment method on the NICEPay hosted payment page.

= How do I enable debug logs? =

Open **WooCommerce → NICEPay Payment Gateway**, enable **Debug Mode**, and save. The **NICEPay Logs** menu will appear in the WordPress admin sidebar. Disable Debug Mode in production.

= What currency is supported? =

IDR (Indonesian Rupiah) only.

= Where can I report bugs or request features? =

Contact **integration@nicepay.co.id** or **technical.support@nicepay.co.id**.

== External services ==

This plugin connects to NICEPay payment APIs to process transactions. A NICEPay merchant account is required.

**Service provider:** NICEPay — [https://www.nicepay.co.id](https://www.nicepay.co.id)

**API endpoints used:**

* Production (Premise): `https://www.nicepay.co.id`
* Production (Cloud): `https://services.nicepay.co.id`
* Sandbox (Premise): `https://dev.nicepay.co.id`
* Sandbox (Cloud): `https://dev-services.nicepay.co.id`

**API paths:**

* `POST /nicepay/redirect/v2/registration` — create transaction and obtain payment URL
* `POST /nicepay/direct/v2/inquiry` — verify payment status after notification

**Data sent to NICEPay per transaction:**

* Order reference number, amount, and currency (IDR)
* Customer billing and shipping details (name, email, phone, address)
* Cart line items (product name, SKU, quantity, price)
* Server IP address and user agent
* Merchant ID and Merchant Key (stored in WordPress options; Merchant Key is used locally to generate SHA256 signatures)

**Data received from NICEPay:**

* Transaction ID (tXid), payment status, payment method code, and amount
* Payment details (e.g. Virtual Account number, card mask, QRIS info) stored as WooCommerce order metadata

**When data is sent:**

Data is transmitted to NICEPay only when a customer initiates a payment or when NICEPay sends a server-to-server payment notification to your site.

For more information, see the [NICEPay Privacy Policy](https://www.nicepay.co.id) and [NICEPay Documentation](https://docs.nicepay.co.id).

== Privacy ==

* This plugin does not collect or store payment card data on your WordPress site. All payment processing occurs on NICEPay's hosted payment page.
* Customer and order data is sent to NICEPay solely for payment processing purposes.
* Optional debug logs are stored locally on your server in the uploads directory (`nicepay-logs/`) when Debug Mode is enabled. Log files are protected from direct web access. Disable debug mode in production.
* This plugin does not include analytics or third-party tracking.
* Store owners are responsible for their own site privacy policy and compliance with applicable data protection laws.

== Screenshots ==

1. NICEPay settings page in WooCommerce admin (environment, host, and gateway configuration).
2. WooCommerce checkout with the NICEPay Redirect payment option.

== Changelog ==

= 1.0.1 =
* WordPress.org review compliance: proper wp_enqueue for JS/CSS, input sanitization, unique class prefixes
* Optional "Powered by NICEPAY" attribution on thank-you page (admin opt-in, disabled by default)
* NICEPay Logs menu visible only when Debug Mode is enabled
* Log files protected from direct web access; admin-only download
* Removed hardcoded sandbox credentials from default settings
* Renamed admin class to Nicepay_Admin; prefixed stored options

= 1.0.0 =
* Initial release — official NICEPay WooCommerce payment gateway
* Gateway `nicepay_all` — NICEPay Redirect (All Payment Method, payMethod 00)
* Redirect to NICEPay hosted payment page via Direct V2 registration API
* Centralized admin: environment, host, debug, order status, credential configuration
* WooCommerce Blocks checkout integration
* Notification callback with validation for status, referenceNo, txId, and merchantToken (SHA256)
* Inquiry API to confirm payment before updating order status
* HPOS and Cart/Checkout Blocks compatibility declarations
* Activity log channel in NICEPay Logs admin menu

== Upgrade Notice ==

= 1.0.1 =
Compliance and security improvements for WordPress.org guidelines. Debug logs and attribution are now optional admin-controlled features.

= 1.0.0 =
Initial release of the official NICEPay Payment Gateway for WooCommerce.
