=== ZionPe Payments ===
Contributors: zionpe
Tags: payments, stripe, woocommerce, payment gateway, credit card
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.24.1
Requires PHP: 7.4
WC requires at least: 3.0
WC tested up to: 9.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept payments on WordPress & WooCommerce: credit/debit card, Google Pay, Apple Pay, and bank transfer. Sign up at ZionPe, connect your store—secure, trusted, and easy.

== Description ==

ZionPe Payments lets you accept online payments on your WordPress and WooCommerce store—credit and debit cards, Google Pay, Apple Pay, and bank transfer. Sign up at ZionPe, connect your store, and get paid. Secure, trusted, and simple.

**Key Features:**

* **WooCommerce Integration** - Accept payments directly on checkout
* **Multiple payment methods** - Card, Google Pay, Apple Pay, Pay by Bank, Link, Klarna (toggle what you need)
* **Standalone Shortcodes** - Add payment forms to any page or post
* **Secure & trusted** - Protected payments; funds to your connected account
* **3D Secure** - Enhanced security for card payments
* **Multi-currency** - GBP, USD, EUR, and more
* **Refund Support** - Process refunds from WooCommerce
* **HPOS Compatible** - Works with WooCommerce High-Performance Order Storage

**WooCommerce Checkout Integration:**

Once configured, ZionPe appears as a payment option on your WooCommerce checkout page. Customers can select it and pay securely with their credit/debit cards.

**Standalone Payment Forms:**

Use shortcodes to add payment forms anywhere on your site - perfect for:
* Service pages
* Landing pages
* Donation pages
* One-time payments

== Installation ==

1. Download the ZionPe Payments plugin ZIP file from your ZionPe dashboard
2. In WordPress admin, go to **Plugins → Add New → Upload Plugin**
3. Choose the ZIP file and click **Install Now**
4. Activate the plugin
5. Go to **ZionPe** in the admin menu
6. Enter your **ZionPe API Base URL**: `https://zionpe.com/api`
7. Enter your **ZionPe Site Key** (copy from your ZionPe dashboard)
8. Click **Save Changes**

**For WooCommerce:**

1. Go to **WooCommerce → Settings → Payments**
2. Enable **ZionPe Payments**
3. Click **Manage** to configure the gateway
4. Your customers can now pay with cards at checkout!

== Usage ==

= WooCommerce =

After enabling ZionPe in WooCommerce Payments settings, customers will see "Credit/Debit Card" (or your custom title) as a payment option during checkout.

= Shortcodes =

Add payment forms to any page or post:

`[zionpe_payment amount="100" currency="GBP" description="Product Name"]`

**Parameters:**

* `amount` (optional) - Fixed payment amount in main currency units (e.g., 100 = £100.00)
* `amounts` (optional) - Comma-separated preset amounts shown as buttons (e.g., "10,25,50")
* `custom_amount` (optional) - yes/no, lets customers type their own amount. Default: yes when `amounts` is set or `amount` is empty
* `min_amount` (optional) - Minimum custom amount. Default: 1
* `title` (optional) - Heading shown above the form
* `button_text` (optional) - Custom button label (e.g., "Donate") — the amount is appended automatically
* `collect_email` (optional) - yes/no, ask for the customer's email for their receipt. Default: yes
* `currency` (optional) - Currency code: GBP, USD, EUR, etc. Default: GBP
* `description` (optional) - Description shown during checkout

Provide at least one of `amount`, `amounts`, or `custom_amount="yes"`.

**Examples:**

Fixed price:
`[zionpe_payment amount="50" currency="GBP" description="Consulting Fee"]`

Donation form with preset and custom amounts:
`[zionpe_payment amounts="10,25,50" custom_amount="yes" title="Support our work" button_text="Donate" currency="GBP"]`

"Pay what you want" (custom amount only):
`[zionpe_payment custom_amount="yes" min_amount="5" currency="USD" description="Tip jar"]`

== External Services ==

This plugin connects to external third-party services to process payments:

**ZionPe Payments API (https://zionpe.com)**

* Used for: Payment processing, creating Stripe payment intents, verifying payments
* Data sent: Site URL, Site Key, payment amounts, currency, order details
* When: During checkout when customer initiates payment
* Terms of Service: https://zionpe.com/legal/terms
* Privacy Policy: https://zionpe.com/legal/privacy

**Stripe (https://stripe.com)**

* Used for: Secure card payment processing via Stripe Elements
* Data sent: Card details are sent directly to Stripe (never stored on your server)
* When: When customer enters payment information
* Terms of Service: https://stripe.com/legal
* Privacy Policy: https://stripe.com/privacy

By using this plugin, you acknowledge that payment data will be processed through these external services.

== Frequently Asked Questions ==

= How do I get my ZionPe Site Key? =

Log in to your ZionPe account at zionpe.com, go to the ZionPe WP Plugin page, and copy your unique Site Key.

= Does it work with WooCommerce? =

Yes! ZionPe integrates directly with WooCommerce checkout. Enable it in WooCommerce → Settings → Payments.

= What WordPress versions are supported? =

ZionPe Payments requires WordPress 5.0 or higher and is tested up to WordPress 6.9.

= What WooCommerce versions are supported? =

ZionPe Payments works with WooCommerce 3.0 and higher, including the latest 8.x versions with HPOS support.

= What currencies are supported? =

ZionPe supports GBP, USD, EUR, and other currencies supported by Stripe.

= Where do payments go? =

Payments are processed through your Stripe Connected Account via ZionPe and appear in both your Stripe dashboard and ZionPe dashboard.

= Is it secure? =

Yes! All payments are processed securely through Stripe with 3D Secure support. No card data is stored on your WordPress site.

= What data does this plugin share externally? =

This plugin sends the following data to ZionPe servers:
* Your WordPress site URL (for verification)
* Your ZionPe Site Key (for authentication)
* Payment amounts and currency
* Order details (for WooCommerce orders)

Card payment details are sent directly to Stripe and never pass through or are stored on your server.

= Is this GDPR compliant? =

The plugin itself does not store personal data. Payment processing is handled by Stripe which is GDPR compliant. You should include appropriate disclosures in your site's privacy policy about payment processing.

= Can I process refunds? =

Yes, refunds can be processed directly from the WooCommerce order page.

== Screenshots ==

1. ZionPe settings page in WordPress admin
2. WooCommerce payment gateway settings
3. Payment option on WooCommerce checkout
4. Successful payment confirmation

== Changelog ==

= 1.24.1 =
* Sandbox is now labelled on the WooCommerce payment providers list and on the ZionPe gateway settings screen, so a store left in sandbox cannot look like a live one.

= 1.24.0 =
* NEW: Sandbox. A sandbox Site Key puts the whole checkout in sandbox, with a badge on the payment form. No real card is charged and sandbox orders never reach your revenue figures.

= 1.23.2 =
* FIXED: Backing out of a payment now cancels it properly. Stripe sends bank transfer instructions the moment the payment starts, so a customer who then chose another method had been asked to send money for an order that was never placed. The request is cancelled, and the dialog tells them to ignore that email.

= 1.23.1 =
* FIXED (important): Cancelling a Pay by Bank payment still placed the order. Closing the bank window leaves the payment unfinished, and we were reading that as success. An order is now only created when the payment actually succeeded or is genuinely settling.

= 1.23.0 =
* FIXED: Choosing Pay by Bank could pop up the bank transfer question. That question now only appears for an actual bank transfer.
* IMPROVED: The ZionPe settings pages use the full width of your screen and adapt properly on smaller ones.
* IMPROVED: The confirmation dialog is roomier and its buttons no longer wrap onto two lines.
* IMPROVED: Wording tidied across the plugin to match the ZionPe writing style.

= 1.22.0 =
* NEW: Finance tab — twelve months of ZionPe volume as a chart, plus refunds, disputes and success rate, with your store name, description and location.
* NEW: Express Checkout switches (product / cart / checkout pages, button colour, height and width) are now on the ZionPe page too, not only in WooCommerce settings.
* FIXED: Payment methods could not be dragged into order on the ZionPe page.
* FIXED: Orders created by express checkout showed "Origin: Unknown" in WooCommerce. They now carry the same attribution data a normal checkout order does.

= 1.21.0 =
* IMPROVED: The bank transfer confirmation now uses a proper ZionPe dialog instead of the browser's grey "this site says" pop-up — the least reassuring thing to show someone at the moment they are paying.
* IMPROVED: Cancelling a payment always reads the same: "No problem — your order has not been placed. Choose another payment method." — whether it was a bank transfer, Pay by Bank or a wallet, and whatever wording the provider used.

= 1.20.3 =
* NEW: ZionPe now emails you the moment a bank transfer is started — amount, order and the payment reference — so an on-hold order is never a mystery. You still get the usual "payment received" email when the money lands.

= 1.20.2 =
* FIXED: Closing the bank transfer details window still placed the order, so a customer who cancelled was told "Order received". The checkout now asks "Have you made the bank transfer?" — confirm and the order is placed on hold; cancel and no order is created at all, so they can pick another payment method.
* NEW: The bank details now stay with the order — shown again on the order-received page and in the customer's email, with the reference. Closing Stripe's window no longer loses them.
* IMPROVED: The order-received page for an unpaid bank transfer says the payment is still awaited instead of simply thanking the customer.

= 1.20.1 =
* FIXED: Bank Transfer said "Not available" even after you switched Bank Transfers on in Stripe. Stripe names this capability per country (gb_bank_transfer_payments, us_bank_transfer_payments, sepa_bank_transfer_payments…) and we were looking for a generic name that does not exist.

= 1.20.0 =
* NEW: Bank Transfer. Customers can push money from their own bank; the order is held on-hold with the payment instructions and completes on its own the moment the funds arrive. Switch Bank Transfers on in Stripe first — the settings row tells you if it is not.
* NEW: Settlement callback. ZionPe now tells your store directly when a payment succeeds, fails or is still settling, signed with your Site Secret. Orders no longer depend on the customer reaching the thank-you page — close the tab, lose signal, pay by bank days later: the order still completes.
* IMPROVED: A payment that is still settling is no longer treated as a decline. Those orders go On hold with a clear note instead of Failed.
* NOTE: The Site Secret is now required for the callback. Add it in ZionPe settings or on the WooCommerce gateway — either one fills in the other.

= 1.19.8 =
* IMPROVED: The Pay by Bank row now names the rail your account actually uses — "Pay by Bank (UK open banking)", "ACH Direct Debit" or "Pre-authorized debit (ACSS)" — so it is clear what you are switching on.
* NEW: Bank Transfer is listed as "Coming soon". It is a push payment that settles in days rather than seconds, so it needs order-status handling we have not shipped yet.

= 1.19.7 =
* FIXED: Apple Pay / Google Pay express payments failed at the final step with "Payment details were collected through Stripe Elements using automatic payment methods and cannot be confirmed...". The express button and the payment were configured two different ways; they now match.
* FIXED: Buying straight from a product page answered "Your cart is empty" — a product-page purchase legitimately starts with an empty cart, and the check was firing before the product was considered.
* FIXED: A cancelled or declined wallet payment left its order sitting in Pending. Those orders are now released as Failed, so your pending total reflects real money in flight.
* FIXED: After updating, WordPress left you on the update screen. You are taken to the ZionPe page with the confirmation.

= 1.19.6 =
* NEW: Separate switches for where the express button appears — product page, cart page, checkout page — so you choose each one.
* NEW: Button height (small/medium/large) and width (full / fit content / centred) so the button matches your theme.
* FIXED: On product pages the button sat inside the Add to cart row and looked squashed. It is now its own row underneath.
* FIXED: An express order is now marked paid the moment the wallet confirms, instead of waiting for the shopper to land on the thank-you page. Closing the tab no longer leaves a paid charge on a pending order.
* FIXED: Buying one item from a product page no longer disturbs coupons already applied to the shopper's cart — the cart and its coupons are restored exactly as they were.

= 1.19.5 =
* NEW: Express Apple Pay / Google Pay button on product pages — buy one item without going through the cart. The order is created in WooCommerce and appears in your ZionPe dashboard exactly like any other order, and the shopper's existing cart is left untouched.
* NEW: Site Secret can now be entered on the ZionPe settings page too. Credentials saved on either screen appear on both — enter them once, wherever you are.
* FIXED: After updating the plugin the old "new version available" banner stayed up. You now land back on the ZionPe page with a clear "updated" confirmation.
* FIXED: Blocks checkout still showed "Credit/Debit Card" as the heading above Google Pay — it now reads ZionPe Payments, like the classic checkout.

= 1.19.4 =
* FIXED: The Apple Pay / Google Pay express button was landing inside the checkout's address column and breaking the layout. It now sits in its own full-width band above the form, with an "OR" divider, and disappears entirely when the shopper's device has no wallet.
* IMPROVED: The ZionPe option at checkout shows the ZionPe mark with rounded corners, and the extra frame around it is gone — each payment method reads as its own block.
* NEW: The ZionPe settings page now has tabs — Settings, Payment methods and Shortcode builder — instead of one very long page. Payment methods are editable right there, no more hunting through WooCommerce settings.
* IMPROVED: The Apple Pay status panel sits under its heading instead of floating to the right, and method availability now reads "Active on your ZionPe account".
* FIXED: "Check for Updates" button icon alignment.

= 1.19.3 =
* NEW: Each payment method now shows whether your Stripe account can actually do it — "Active on your Stripe account" or "Not available" with the reason. No more guessing why a method you switched on never appears.
* FIXED: Pay by Bank could be switched on and still never show at checkout. Bank payments are region-specific (UK open banking, US ACH, Canadian ACSS) and we were falling back to the UK rail when your account country was unknown, which is refused for any non-GBP charge. Your account country is now read from Stripe.
* FIXED: Switching a method on did not always reach shoppers who already had the checkout open — the saved payment session ignored the change.
* IMPROVED: Checkout methods render as separate blocks instead of one stacked list.
* CHANGED: Klarna, Clearpay/Afterpay, Affirm and Cash App Pay are listed as "Coming soon" and cannot be switched on yet. ZionPe currently supports card, Apple Pay, Google Pay, Link and Pay by Bank.

= 1.19.2 =
* FIXED: The Payment methods list and the Apple Pay status panel showed as empty boxes in ZionPe settings, and the plugin could deactivate itself. A bad edit in 1.19.1 removed the code behind them — restored.
* FIXED: Google Pay appeared nested under a heading that said "Credit/Debit Card". The heading now describes the group ("ZionPe Payments") whenever more than one method is on, and names the method when only one is on.
* FIXED: Express Apple Pay / Google Pay buttons never appeared on stores using the new Cart and Checkout blocks. They now render there too.
* FIXED: Express payments failed at the final step on some stores (a required Stripe step was missing).

= 1.19.1 =
* FIXED: ZionPe is one row again in WooCommerce → Settings → Payments. Splitting each method into its own row filled that screen with ZionPe entries — every method is now managed in one place, inside ZionPe Payments → Manage.
* FIXED: Choosing "Pay by Bank" at checkout could show a card form. If a method your account or currency cannot do made the payment fail to start, we replaced your whole selection with cards; now only the unusable method is dropped and the rest stay.
* FIXED: A method could appear twice at checkout (e.g. Google Pay as its own option and again inside the card option).
* IMPROVED: Payment methods at checkout are now clear radio options — pick one and only that one's form opens, so what you select is what you pay with.

= 1.19.0 =
* NEW: Apple Pay / Google Pay express buttons on the cart and checkout pages — one tap, the wallet fills in the email and delivery address. Off by default; switch it on in ZionPe settings after testing. Your store always prices the order, never the wallet.
* NEW: Any method can now be its own payment option at checkout. Enable "ZionPe — Klarna" (or Pay by Bank, Clearpay, …) in WooCommerce → Settings → Payments and it gets its own row, its own toggle and its own place in the list, alongside every other gateway.
* NEW: Apple Pay status panel in ZionPe settings — see whether your domain is verified and registered, and activate it with one button.
* NEW: Payment methods are now a switch-and-drag list in ZionPe settings. Turn each method on or off, and drag them into the order your customers see at checkout — the top one appears first.
* NEW: Apple Pay and Google Pay are now proper switches. Turn one off and it never appears; turn it on and it shows wherever the shopper's device supports it.
* FIXED: Apple Pay often never appeared at all. Your store's domain is now registered with Stripe automatically the first time a checkout loads, which is what Apple Pay (and Link) require.
* NEW: More methods available — Clearpay/Afterpay, Affirm and Cash App Pay, alongside cards, Link, Pay by Bank and Klarna.
* NEW: The payment methods you offer now show as icons next to ZionPe Payments in WooCommerce → Settings → Payments and at checkout.

= 1.18.0 =
* FIXED: Classic (shortcode) WooCommerce checkout now sends the customer's billing name, email, phone and address with the payment. Orders paid this way used to show "No billing details were captured" in your ZionPe dashboard, and card postcode/address checks had nothing to match against.
* IMPROVED: The customer's email, name and billing city/postcode/country are stamped on the payment itself at creation, so a payment is always attributable to a buyer — even on Pay by Bank and other redirect methods where the bank tells us nothing about the payer.
* IMPROVED: Pay by Bank orders now carry the buyer's details from the order, server-side.

= 1.17.0 =
* NEW: Shortcode Builder in WordPress → ZionPe — build your payment/donation form visually and copy the ready-made shortcode.
* IMPROVED: Shortcode forms are wider (560px) with a cleaner white card, and the payment methods now show as compact tabs instead of one long vertical list.
* IMPROVED: Dashboard revenue widget now includes payment-form (shortcode/donation) revenue, not just WooCommerce orders — with a clear "Store currency: GBP (£)" line so figures are unambiguous.
* IMPROVED: Dashboard revenue widget appears at the top of the dashboard by default on new installs.
* FIXED: Revenue widget now works on sites without WooCommerce (shows payment-form revenue).

= 1.16.0 =
* NEW: Donation-style shortcode forms — preset amount buttons (amounts="10,25,50"), custom amount input (custom_amount="yes"), minimum amount, optional title and custom button text (e.g. "Donate").
* NEW: Optional customer email field on shortcode forms (collect_email, default on) — powers Stripe receipts and shows the customer on your merchant notification.
* FIXED: The "Success Message" setting is now actually shown after shortcode payments (it was ignored before).
* FIXED: The "Redirect URL after payment" setting now works for shortcode payments.
* FIXED: Bank-redirect payments (3D Secure, Pay by Bank, Klarna) returning to the page now show a clear payment result instead of an empty form, and the merchant notification email is sent.
* FIXED: If Stripe.js cannot load, the form now shows an error instead of silently waiting forever.
* IMPROVED: Pay button shows the live amount (e.g. "Pay £25.00" / "Donate • £25.00").

= 1.15.1 =
* NEW: Site Secret is now shown on your ZionPe dashboard (WordPress Plugin page) with a copy button — no more hunting for it.
* NEW: When you save the gateway settings with a Site Secret, the plugin instantly verifies it with ZionPe and shows "Site Secret verified — active and working" (or a clear error if it does not match).
* NEW: Your ZionPe dashboard shows an "Active" badge once the secret is verified from your store.

= 1.15.0 =
* CRITICAL FIX: Orders no longer stay in "Pending Payment" after a successful card payment when no Site Secret is configured. Payment verification completes, the order moves to Processing, customers reach the Thank You page, and order emails are sent.
* FIXED: Failed payment verification now writes a note on the order with the exact reason, so merchants can see what happened.
* FIXED: If ZionPe cannot be reached during verification after the card was charged, the order is placed On Hold (instead of being auto-cancelled and re-selling stock) and the customer still reaches the Thank You page.
* FIXED: Pay by Bank / redirect payments now return to the real checkout page even when it is not at /checkout/.
* ADDED: Admin notice when the Site Secret is missing — refunds require it and verification runs in reduced-security mode without it.

= 1.14.0 =
* ACTION REQUIRED: Paste your Site Secret in WooCommerce > Payments > ZionPe. Refunds now require it and will fail without it.
* SECURITY: Refund and verify-payment requests are HMAC-signed with your Site Secret. The public Site Key alone can no longer refund your orders.
* ADDED: "ZionPe Site Secret" setting in the gateway settings

= 1.13.0 =
* FIXED: Google Pay and Apple Pay not showing on WooCommerce classic checkout
* FIXED: Link and Pay by Bank tabs missing from checkout payment form
* FIXED: Blocks checkout not sending enabled payment method types to server
* IMPROVED: Explicit wallets config (applePay: auto, googlePay: auto) on Payment Element for reliable display on Connect accounts
* IMPROVED: paymentMethodOrder now includes card, Google Pay, Apple Pay, and Link in correct order
* IMPROVED: Blocks checkout now passes merchant-enabled payment methods to create-intent API

= 1.12.1 =
* FIXED: Payment form "Network error" on checkout after plugin activation
* FIXED: Payment form loading indefinitely on WooCommerce Blocks checkout
* NEW: Automatic retry with exponential backoff when payment server is slow or temporarily unavailable
* IMPROVED: Better error messages — shows specific cause (timeout, connection, server error) instead of generic "Network error"
* IMPROVED: Added "Retry" button on payment form errors (no full page refresh needed)
* IMPROVED: CORS preflight caching (24h) reduces checkout latency
* IMPROVED: Blocks checkout now has proper request timeout (30s) instead of hanging indefinitely

= 1.12.0 =
* FIXED: ZionPe Dashboard links now point to https://zionpe.com/user-app/zionpe (Help & Support and dashboard widget)

= 1.11.0 =
* Updated plugin description: credit/debit card, Google Pay, Apple Pay, bank transfer; no Stripe mention; secure & trusted
* FIXED: Visit plugin site link now points to https://zionpe.com/zionpe-plugin
* NEW: Docs link (opens in new tab) to https://docs.zionpe.com/plugins/woocommerce
* NEW: Rate the plugin ★★★★★ link (opens in new tab) to WordPress.org reviews
* NEW: Review request in WooCommerce → Settings → Payments → ZionPe → Manage

= 1.10.0 =
* NEW: Woo Payments–style payment method toggles (Credit/Debit Card, Bank Transfer, Link, Klarna)
* NEW: Choose which payment options to show in WooCommerce → Settings → Payments → ZionPe → Manage
* IMPROVED: Checkout form loads faster; only enabled methods appear for a cleaner buyer experience
* DOCS: Payment Methods section and user app updated

= 1.9.0 =
* CRITICAL FIX: Pay by Bank – WooCommerce order now created and merchant notified
* NEW: Two-step Pay by Bank flow – order is created first, then customer is redirected to bank
* FIXED: Pay by Bank success now creates order in WordPress and shows on thank you page
* FIXED: Merchant receives congratulations email with full details (amount, order ID, payment ID, customer) when Pay by Bank succeeds
* FIXED: Email uses existing black/gray style with pill-shaped button and complete payment details
* IMPROVED: Redirect-based payment methods (Pay by Bank, BACS, iDEAL, etc.) use same reliable flow

= 1.8.9 =
* FIXED: One-click update now works directly from the update banner
* FIXED: Update banner now uses WordPress native update mechanism
* FIXED: Stale cache automatically cleared when visiting plugins page
* IMPROVED: Reduced update cache time to 30 minutes for faster update detection
* IMPROVED: More aggressive cache validation to prevent stale version display

= 1.8.8 =
* NEW: Dashboard widget showing real-time revenue stats from your store
* NEW: Today's revenue, monthly revenue, pending payments, and all-time stats
* NEW: Quick links to ZionPe Dashboard and Contact Support
* FIXED: Update banner now properly validates cached version against installed version
* FIXED: Stale update notifications no longer shown after plugin update
* IMPROVED: More robust version comparison for update notices

= 1.8.7 =
* FIXED: Hide outdated WordPress.org update banner on plugins page
* FIXED: Forcefully suppress stale version notifications from WordPress.org
* IMPROVED: Better cache management for plugin updates

= 1.8.6 =
* CRITICAL FIX: Prevent duplicate PaymentIntents from being created
* FIXED: PaymentIntent now cached in sessionStorage and reused during checkout
* FIXED: Each checkout session now uses same PaymentIntent until amount changes
* FIXED: Cache cleared after successful payment so next order creates new PaymentIntent
* IMPROVED: Reduced unnecessary API calls and duplicate transaction records

= 1.8.5 =
* CRITICAL FIX: Payment form not showing on WooCommerce Blocks checkout
* FIXED: Simplified redirect handler integration to prevent JS errors
* FIXED: Proper null-safe destructuring for props

= 1.8.4 =
* CRITICAL FIX: Pay By Bank cancelled payments now handled properly
* FIXED: Cancelled bank payments no longer show "Thank you" page
* FIXED: Proper error message shown when user cancels at bank
* FIXED: Return URL now goes to checkout (not order-received) for proper status check
* FIXED: Redirect handler component now properly renders in Blocks checkout

= 1.8.3 =
* FIXED: Duplicate update banners - now only shows one correct banner
* FIXED: WordPress.org stale cache automatically cleared on mismatch
* IMPROVED: Update checker runs with higher priority to override WP.org

= 1.8.2 =
* FIXED: Plugin update banner now shows correct version from ZionPe server
* FIXED: WordPress.org cached version properly overridden by ZionPe updates
* IMPROVED: Reduced cache time for faster update detection

= 1.8.1 =
* NEW: Self-hosted update checker - updates now show on plugins page immediately
* IMPROVED: Faster update delivery without waiting for WordPress.org review
* FIXED: Update notification banner now shows correct new version

= 1.8.0 =
* NEW: Full support for Pay By Bank App and other redirect-based payment methods
* FIXED: WooCommerce orders now properly created when customer pays via bank transfer
* FIXED: Email notifications now sent correctly for bank payments
* FIXED: Order confirmation page now displays correctly after bank payment redirect
* IMPROVED: Better handling of async payment methods (bank transfers, instant bank payments)
* IMPROVED: Payment verification after redirect return from bank
* IMPROVED: User feedback during bank payment processing

= 1.7.6 =
* FIXED: Moved inline CSS to external stylesheet (WordPress.org compliance)
* FIXED: Removed all license-related code and messaging (WordPress.org Guideline 5 compliance)
* IMPROVED: Cleaner error handling without upgrade prompts

= 1.7.5 =
* FIXED: Removed external branding from public-facing payment form (WordPress.org Guideline 10 compliance)
* IMPROVED: Payment form now shows generic "Secure payment" text instead of third-party credits

= 1.7.4 =
* FIXED: Added version parameter to all wp_enqueue_script and wp_register_script calls
* IMPROVED: Better browser caching support for Stripe.js

= 1.7.3 =
* FIXED: Class naming conventions - all classes now use Zionpe_ prefix
* FIXED: Renamed WC_Gateway_Zionpe to Zionpe_WC_Gateway
* FIXED: Renamed WC_Gateway_Zionpe_Blocks_Support to Zionpe_WC_Gateway_Blocks_Support
* IMPROVED: Full WordPress.org naming conventions compliance

= 1.7.2 =
* FIXED: All output escaping for security compliance (esc_html, esc_attr, esc_textarea, wp_kses_post)
* FIXED: Reduced tags to 5 as per WordPress.org guidelines
* IMPROVED: Full WordPress.org Plugin Check compliance

= 1.7.1 =
* FIXED: Added translator comments for internationalization (i18n) compliance
* FIXED: Ordered placeholders in translatable strings (%1$s, %2$s)
* IMPROVED: WordPress.org Plugin Check compatibility

= 1.7.0 =
* NEW: WordPress.org compatible release
* IMPROVED: Compatibility with WordPress 6.9
* IMPROVED: Compatibility with WooCommerce 9.5
* IMPROVED: Streamlined plugin for WordPress.org guidelines
* REMOVED: Custom updater (now handled by WordPress.org)

= 1.6.2 =
* FIXED: Plugin URI and Author URI now properly differentiated
* IMPROVED: Better WordPress.org guideline compliance

= 1.5.3 =
* FIXED: WooCommerce checkout now validates form before processing payment
* FIXED: Payment no longer deducted if shipping or other validation fails
* IMPROVED: Custom return URL redirect after successful payment
* IMPROVED: Better error handling and user feedback

= 1.5.2 =
* FIXED: Updated API Base URL from uk.micahguru.com to zionpe.com
* IMPROVED: API URL now matches ZionPe dashboard for seamless setup
* FIXED: Connection verification now works correctly with new API endpoint

= 1.5.1 =
* FIXED: WooCommerce payment icon now correctly displays yellow Z logo
* IMPROVED: Using JPG icon format for better WooCommerce compatibility

= 1.5.0 =
* NEW: Updated ZionPe icon with official yellow Z branding
* IMPROVED: Better icon visibility in WooCommerce Payment Providers list
* IMPROVED: High-quality icon in WordPress admin sidebar

= 1.4.9 =
* NEW: Custom ZionPe icon in WordPress admin menu
* NEW: ZionPe icon displayed in WooCommerce payment settings
* IMPROVED: Better plugin branding throughout WordPress admin

= 1.4.8 =
* FIXED: Check for Updates button now works correctly
* IMPROVED: Better loading state and feedback when checking updates
* IMPROVED: Toast notifications for update status

= 1.4.7 =
* NEW: Dashboard update notification banner (like other plugins)
* NEW: Dismissible update notices across all admin pages
* NEW: Smart update caching (checks every 12 hours)
* IMPROVED: Better visibility for available updates

= 1.4.6 =
* NEW: "Check for Updates" button on settings page
* NEW: Update available alert with prominent notification
* NEW: Automatic update check on page load
* IMPROVED: Better update notification UI with animations

= 1.4.5 =
* FIXED: CRITICAL - Payment element now only shows AFTER billing is complete
* FIXED: Prevents Stripe Link/saved cards from charging before validation
* FIXED: Shows warning message when billing fields are incomplete
* IMPROVED: Complete rewrite of WooCommerce Blocks checkout integration

= 1.4.4 =
* IMPROVED: New ZionPe branded email templates for payment notifications
* IMPROVED: Modern email design with emerald/teal color scheme
* IMPROVED: Better email deliverability and formatting

= 1.4.3 =
* FIXED: Critical - Payment now only processed AFTER form validation passes
* FIXED: Billing address validation added before card is charged
* FIXED: Prevents payment when required fields are empty
* IMPROVED: Better billing details passed to Stripe

= 1.4.2 =
* FIXED: WooCommerce Blocks checkout amount calculation (pence to pounds conversion)
* FIXED: Correct amount now charged (was multiplying by 100 twice)

= 1.4.1 =
* NEW: Merchant email notifications when payments are received
* NEW: Payments now visible in ZionPe Analytics dashboard
* IMPROVED: Shortcode payments now properly tracked
* IMPROVED: Better payment data storage for analytics

= 1.4.0 =
* IMPROVED: WordPress.org compatibility updates
* IMPROVED: Better security with wp_unslash sanitization
* IMPROVED: WooCommerce Blocks checkout support
* UPDATED: Tested with WordPress 6.4 and WooCommerce 8.4
* FIXED: Various code improvements and bug fixes

= 1.3.0 =
* FIXED: Connection verification now works reliably with direct API calls
* IMPROVED: Better error messages with specific troubleshooting guidance
* IMPROVED: Site Key format validation before API call
* IMPROVED: Auto-verify connection on page load when key exists
* IMPROVED: Network error handling with detailed messages
* Added: Console logging for debugging

= 1.2.0 =
* NEW: WordPress update system integration
* NEW: Connection verification with visual feedback
* NEW: WooCommerce checkout toggle switch
* NEW: Custom return URL setting
* NEW: Success message customization

= 1.0.0 =
* Major update: WooCommerce Payment Gateway integration
* Added: Full WooCommerce checkout support
* Added: WooCommerce refund support
* Added: HPOS (High-Performance Order Storage) compatibility
* Added: Improved admin settings page
* Updated: Better error handling and user feedback
* Updated: Enhanced security with 3D Secure support

= 0.1.4 =
* Improved Payment Element initialization
* Better error handling and user feedback
* Enhanced security with 3D Secure support

= 0.1.3 =
* Added support for multiple currencies
* Improved form styling

= 0.1.2 =
* Initial public release

== Upgrade Notice ==

= 1.3.0 =
IMPORTANT: Fixes connection verification issues. If you see "API URL or Site Key is missing" error, please update to this version.

= 1.0.0 =
Major update! Now includes full WooCommerce checkout integration. Recommended for all users.

== Compatibility ==

* WordPress 5.0 - 6.9+
* WooCommerce 3.0 - 9.5+
* PHP 7.4+
* WooCommerce HPOS (High-Performance Order Storage)
* WooCommerce Blocks Checkout
* All major WordPress themes
* Multisite compatible