=== Billplz for WooCommerce ===
Contributors: wanzulnet, yiedpozi
Tags: billplz
Tested up to: 6.8.2
Stable tag: 3.28.13
Requires at least: 4.6
License: GPL-3.0-or-later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Requires PHP: 7.0

Accept payment by using Billplz.

== Description ==
Install this plugin to accept payment using Billplz.

== Upgrade Notice ==

== Screenshots ==
* Billplz for WooCommerce installation
* Activate plugin after installation
* Set API Secret Key, Collection ID and X Signature Key
* Enable X Signature Key at Billplz Account Settings

== Changelog ==

= 3.28.13 - 2025-07-28 =
* FIXED: X-Signature mismatch caused by special character encoding in the payment callback data (e.g., slash)

= 3.28.12 - 2025-06-18 =
* ADDED: Enable/disable automatic bill deletion upon order marked as "Cancelled"

= 3.28.11 - 2025-04-28 =
* FIXED: Removed "IC Number" field from refund form

= 3.28.10 - 2025-01-28 =
* FIXED: Missing payment option - Bank of China
* FIXED: Exclude live FPX and SWIFT banks when sandbox is enabled

= 3.28.9 - 2025-01-27 =
* NEW: Add payment icon in WooCommerce checkout block
* NEW: Introduced new filter hook: `bfw_checkout_block_icon`
* FIXED: Include all payment options in the dropdown including FPX B2B, e-Wallet and Cards when "Bypass Billplz Bill Page" is enabled
* MODIFIED: Removed action hooks: `bfw_payment_fields`, `bfw_payment_fields_with_collection`; no longer used as we have updated the payment options function
* MODIFIED: Removed filters hook: `billplz_bank_name`; no longer used as we have updated the payment options function

= 3.28.8 - 2024-08-13 =
* FIXED: Resolved PHP 8.x deprecation warnings

= 3.28.7 - 2024-07-29 =
* FIXED: Remove special characters from the Payment Order description

= 3.28.6 - 2024-06-13 =
* FIXED: Missing script dependencies for refund metabox

= 3.28.5 - 2024-05-29 =
* FIXED: Duplicate admin notice issue
* FIXED: Missing "Billplz Refund" metabox in order details page when HPOS is enabled

= 3.28.4 - 2024-03-18 =
* FIXED: Remove deprecation notice of woocommerce log file path

= 3.28.3 - 2023-11-28 =
* NEW: Added support for WooCommerce checkout blocks

= 3.28.2 - 2023-11-16 =
* FIXED: Blank order editor page in WordPress admin

= 3.28.1 - 2023-10-25 =
* FIXED: Resolved SSL verification error during the WP remote request by removing the 'sslverify' parameter

= 3.28.0 - 2023-08-23 =
* NEW: Support order refunds via Billplz payment order
* NEW: Added compatibility for WooCommerce High-Performance Order Storage (HPOS)
* NEW: Added Paydee credit/debit card payment
* FIXED: Retrieve the customer's name from the checkout page instead of their profile information for a logged-in customer
* FIXED: Issue with admin notices when saving the plugin settings

= 3.27.4 =
* NEW: Added compatibility for advanced checkout plugin; eg: WooCommerce Fast Cart

= 3.27.3 =
* NEW: Added 2c2p Shopee Pay

= 3.27.2 =
* FIXED: Issue with unpaid bill result to processing for order in callback

= 3.27.1 =
* FIXED: Order status not updated when order are created from version prior to 3.27.0.

= 3.27.0 =
* NEW: Added ability to hard code API Key, X Signature Key and Collection ID
* NEW: Mobile phone number regular expression pattern to ensure non mobile phone number are removed
* NEW: Avoid cluttering the post meta key by using new table
* NEW: Changed how X Signature Hash is constructed
* NEW: Support for FPX B2B1 for pending transaction state

= 3.26.3 =
* IMPROVED: Bank list is now synched with Billplz API docs. 

= 3.26.2 =
* IMPROVED: Fix issue where no error message are displayed when payment cancelled 

= 3.26.1 =
* IMPROVED: Fix issue with 2c2p-wallet not appearing when 2c2p-card deactivated

= 3.26.0 =
* NEW: Added option to activate 2c2p wallet
* IMPROVED: Using woocommerce_form_field to generate select option
* IMPROVED: Using wp_remote_retrieve_response_code to prevent unexpected errors
* IMPROVED: Changed bank name according to Billplz

= 3.25.6 =
* NEW: Support for Enable Extra Payment Completion Information

== Installation ==

**Step 1:**

- Login to your *WordPress Dashboard*
- Navigate to **Plugins >> Add New**
- Search **Billplz for WooCommerce >> Install Now**

**Step 2:**

- Activate Plugin

**Step 3:**

- Navigate to **WooCommerce** >> **Settings** >> **Checkout** >> **Billplz**
- Insert your **API Secret Key**, **Collection ID** and **X Signature Key**
- Save changes

**Hiding API Key, Collection ID and X Signature Key**

The API Key, Collection and X Signature Key can be hidden from WordPress Dashboard by setting it on wp-config.php

#### API Credentials
- API Key: `define('BFW_API_KEY', '<your-api-key-here>');`
- X Signature: `define('BFW_X_SIGNATURE', '<your-x-signature-here>');`
- Collection ID: `define('BFW_COLLECTION_ID', '<your-collection-id-here>');`
- Payment Order Collection ID: `define('BFW_PAYMENT_ORDER_COLLECTION_ID', '<your-payment-order-collection-id-here>');`

== Frequently Asked Questions ==

= Where can I get API Secret Key? =

You can the API Secret Key at your Billplz Account Settings.

= Where can I get Collection ID? =

You can the Collection ID at your Billplz >> Billing.

= Where can I get X Signature Key? =

You can the X Signature Key at your Billplz Account Settings.

= Troubleshooting =

1. If you are not getting a **Callback/Redirect** response from Billplz:

	Please make sure you have **Tick "Enable XSignature Payment Completion"** on Billplz Account Settings and make sure you have set your **X Signature Key**.

2. To immediately reduce stock on add to cart, we strongly recommend you to use [WooCommerce Cart Stock Reducer](http://bit.ly/1UDOQKi) plugin.

== Links ==
[Sign Up](https://www.billplz.com) for Billplz account to accept payment using Billplz now!
