=== PKPay+ Secured Checkout ===
Contributors: pkpayplus
Donate link: https://pkpayplus.com/
Tags: woocommerce, payments, checkout, credit card, google pay
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
WC requires at least: 7.0
WC tested up to: 9.0

Secure hosted checkout for WooCommerce. Accept cards and Google Pay with PKPay+.

== Description ==

PKPay+ Secured Checkout is the official WooCommerce payment gateway for [PKPay+](https://pkpayplus.com/). It lets customers pay with Visa, Mastercard, American Express, Discover, and Google Pay through a hosted checkout that stays on your store (embedded iframe) or opens PKPay+ hosted checkout (redirect).

Create a merchant account, copy your API keys, and enable the gateway. PKPay+ handles card collection, 3-D Secure when required, and payment confirmation. WooCommerce marks the order paid after a signed webhook or a server-side verification.

= Features =

* Embedded checkout on WooCommerce Blocks and classic checkout
* Optional redirect checkout to the hosted PKPay+ payment page
* Cards: Visa, Mastercard, American Express, Discover
* Google Pay on the hosted checkout
* Signed payment webhooks so orders can complete even if the shopper closes the browser
* Merchant ID, publishable key, and secret key from your PKPay+ dashboard
* Compatible with WooCommerce High-Performance Order Storage (HPOS)

= Get your keys =

1. Sign in to the [PKPay+ merchant dashboard](https://merchant.pkpayplus.com/dashboard).
2. Open [API Keys](https://merchant.pkpayplus.com/api-keys).
3. Create a live or sandbox key pair.
4. Copy **Merchant ID**, **Publishable Key**, and **Secret Key** into WooCommerce → Settings → Payments → PKPay+ Secured Checkout.

Need an account? Register at [https://merchant.pkpayplus.com/dashboard](https://merchant.pkpayplus.com/dashboard).

= Checkout flows =

**Embedded Checkout** keeps the shopper on your checkout page. The PKPay+ payment form loads in a secure Checkout.

**Redirect checkout** sends the shopper to PKPay+ hosted checkout to finish payment, then returns them to your order received page.

== Installation ==

= Requirements =

* WordPress 6.0 or later
* WooCommerce 7.0 or later
* PHP 7.4 or later
* A PKPay+ merchant account

= Steps =

1. Upload the `pkpay-secured-checkout` folder to `/wp-content/plugins/`, or install the zip from Plugins → Add New → Upload Plugin.
2. Activate **PKPay+ Secured Checkout**.
3. Go to [https://merchant.pkpayplus.com/dashboard](https://merchant.pkpayplus.com/dashboard) and sign in.
4. Open [https://merchant.pkpayplus.com/api-keys](https://merchant.pkpayplus.com/api-keys) and create an API key.
5. In WordPress, go to **WooCommerce → Settings → Payments → PKPay+ Secured Checkout**.
6. Paste Merchant ID, Publishable Key, and Secret Key.
7. Enable the gateway, choose **Embedded iframe checkout** or **Redirect checkout**, and save.

You can also enter the same keys under **Settings → PKPay+ Secured Checkout**. Both screens stay in sync.

== Frequently Asked Questions ==

= Where do I get API keys? =

Sign in at [https://merchant.pkpayplus.com/dashboard](https://merchant.pkpayplus.com/dashboard), then create keys at [https://merchant.pkpayplus.com/api-keys](https://merchant.pkpayplus.com/api-keys). You need Merchant ID, Publishable Key, and Secret Key.

= Does this work with WooCommerce Blocks checkout? =

Yes. The plugin registers a WooCommerce Blocks payment method and also supports classic shortcode checkout.

= What is the difference between iframe and redirect? =

Iframe keeps the payment form on your checkout page. Redirect sends the customer to PKPay+ hosted checkout and back to your thank-you page after payment.

= Which cards are supported? =

Visa, Mastercard, American Express, Discover, and Google Pay, subject to your PKPay+ merchant settings and the customer’s bank.

= Is a PKPay+ account required? =

Yes. The plugin does not process cards by itself. It creates a checkout session with PKPay+ using your merchant credentials.

= Does the plugin store card numbers? =

No. Card details are entered on PKPay+ hosted checkout. Your WordPress site stores the checkout session ID and order metadata only.

== Screenshots ==

1. Hosted PKPay+ checkout with order summary, card fields, and Google Pay.
2. WooCommerce checkout with PKPay+ Secured Checkout selected and the embedded card form.
3. WooCommerce payment settings: Merchant ID, publishable key, secret key, and checkout flow.

== External services ==

This plugin uses the PKPay+ payment service to process checkout. When a customer pays, the store sends the order and customer details needed to complete payment to PKPay+. Card numbers are entered on PKPay+ hosted checkout, not stored in WordPress.

PKPay+: https://pkpayplus.com/
Terms of Service: https://www.pkpayplus.com/terms-of-service
Privacy Policy: https://www.pkpayplus.com/privacy

== Changelog ==

= 1.0.0 =
* Initial WordPress.org release.
* WooCommerce Blocks and classic checkout support.
* Embedded iframe and redirect checkout flows.
* Signed payment webhook handling.
* Merchant ID, publishable key, and secret key settings.

== Upgrade Notice ==

= 1.0.0 =
First public release. Install, add your PKPay+ API keys, and enable the gateway.
