CodePopular Paddle Checkout For WooCommerce

=== CodePopular Paddle Checkout For WooCommerce === Contributors: codepopular Donate link: https://codepopular.com/woopaddle Tags: woocommerce, paddle, payment gateway, checkout, paddle payment Requires at least: 6.0 Tested up to: 7.0 Requires PHP: 8.0 Stable tag: 1.0.3 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept one-time payments in WooCommerce with Paddle Classic checkout — cards, PayPal, and more via a trusted Merchant of Record.

== Description ==

CodePopular Paddle Checkout For WooCommerce is the free Paddle payment gateway for WooCommerce. It connects your store to Paddle so customers can pay securely through Paddle Classic checkout while Paddle handles tax, compliance, and payouts as your Merchant of Record.

Ideal for digital products, software, and online stores that need reliable one-time payments without building a custom Paddle integration.

= Why choose CodePopular Paddle Checkout For WooCommerce? =

• Merchant of Record — Paddle handles sales tax, VAT, and global compliance for you.
• Fast setup — Connect with your Vendor ID and API key; no custom checkout code required.
• Sandbox ready — Test payments safely before going live.
• Modern checkout — Works with classic WooCommerce checkout and Cart & Checkout Blocks.
• HPOS compatible — Declared compatible with WooCommerce High-Performance Order Storage.
• Free forever for Classic one-time payments — Upgrade only when you need Billing API or subscriptions.

= Features =

• Paddle Classic API one-time payments
• Sandbox and live (production) modes
• Popup or inline Paddle checkout display
• Classic checkout and WooCommerce Blocks checkout support
• Secure webhook payment confirmation
• Custom payment method title, description, and checkout logo
• Product name and icon shown in the Paddle overlay
• Optional per-product names in checkout
• VAT / tax price handling aligned with Paddle account settings
• One-click API and webhook connectivity tests in settings
• Compatible gateway ID / settings / order meta with WooPaddle Pro (easy upgrade path)

= Pro features (WooPaddle Pro) =

Need subscriptions or the Paddle Billing API? Those are available in the Pro version:

• Paddle Billing API
• WooCommerce Subscriptions support
• Billing product sync and subscription webhooks

Get WooPaddle Pro →

= Requirements =

• WordPress 6.0 or higher
• WooCommerce 7.0 or higher
• PHP 8.0 or higher
• An active Paddle vendor account
• Store currency: USD, GBP, or EUR

= Privacy & data =

This plugin sends order and customer details required for checkout to Paddle when a payment is initiated, and receives payment status via webhooks. Review Paddle’s privacy policy and configure your store’s privacy policy accordingly.

On checkout and order-received pages, the plugin loads the official Paddle.js library from Paddle’s CDN (https://cdn.paddle.com/paddle/paddle.js). This is required for Paddle Classic checkout and is provided by Paddle as part of their payment service. No other third-party scripts are loaded. Paddle.js is not bundled in this plugin.

= Source code and development =

Human-readable source for this plugin (including JavaScript and CSS) is included in the plugin package and maintained publicly:

• Public repository: https://github.com/shamimbdpro/codepopular-paddle-checkout-for-woocommerce
• Admin JS source: assets/src/js/admin.js (also shipped as assets/dist/js/admin.js)
• Admin CSS/SCSS source: assets/src/sass/admin.scss and assets/src/sass/admin.css (also shipped as assets/dist/css/admin.css)
• Checkout / Blocks JS (uncompressed): assets/dist/js/codepach-engine.js, assets/dist/js/codepach-helpers.js, assets/dist/js/codepach-blocks-checkout.js
• Checkout CSS (uncompressed): assets/dist/css/checkout.css

Paddle.js is loaded only from Paddle’s official CDN (https://cdn.paddle.com/paddle/paddle.js) and is not bundled in this plugin. Docs: https://developer.paddle.com/paddlejs/overview

No build step is required to run the plugin. If you edit admin Sass, compile assets/src/sass/admin.scss to assets/dist/css/admin.css with any Sass compiler.

== Installation ==

= Automatic installation =

1. In your WordPress admin, go to Plugins → Add New.
2. Search for CodePopular Paddle Checkout For WooCommerce.
3. Click Install Now, then Activate.

= Manual installation =

1. Download the plugin ZIP and extract it.
2. Upload the codepopular-paddle-checkout-for-woocommerce folder to /wp-content/plugins/.
3. Activate CodePopular Paddle Checkout For WooCommerce from the Plugins screen.

= Configuration =

1. Go to WooCommerce → Settings → Payments.
2. Enable Paddle (CodePopular Paddle Checkout For WooCommerce) and open its settings.
3. Enter your Vendor ID and API Key from the Paddle vendor dashboard.
4. Choose Sandbox or live mode, then reconnect credentials if you switch modes.
5. Copy the Webhook URL from the settings screen into your Paddle dashboard alert / webhook configuration.
6. Use the built-in API connection test and Webhook connection test to verify setup.
7. Optionally customize the payment method title, logo, product name, and checkout display mode (popup or inline).
8. Place a test order to confirm payments complete and orders update correctly.

== Frequently Asked Questions ==

= Do I need a Paddle account? =

Yes. Sign up at paddle.com, then use your Vendor ID and API key in the gateway settings.

= Does CodePopular Paddle Checkout For WooCommerce support subscriptions? =

No. One-time Classic payments only. Subscriptions and the Paddle Billing API require WooPaddle Pro.

= Can I use Paddle Billing API with the Light version? =

No. Billing API is a Pro feature. Light uses the Paddle Classic API for one-time checkouts.

= Can I run CodePopular Paddle Checkout For WooCommerce and WooPaddle Pro at the same time? =

No. If Pro is active, this free plugin stays inactive to avoid class and gateway conflicts. Settings, webhook URL, and order meta stay under the shared Paddle gateway ID so you can upgrade without reconfiguring from scratch.

= Which currencies are supported? =

USD, GBP, and EUR. Your WooCommerce store currency must be one of these.

= Does it work with WooCommerce Blocks / block checkout? =

Yes. CodePopular Paddle Checkout For WooCommerce registers a Blocks payment method and declares Cart & Checkout Blocks compatibility.

= Does it support High-Performance Order Storage (HPOS)? =

Yes. Compatibility with custom order tables (HPOS) is declared.

= Popup vs inline checkout — which should I use? =

Popup opens Paddle in an overlay (recommended for most stores). Inline embeds the Paddle checkout on your store page. You can switch this anytime in the gateway settings.

= Payments succeed in Paddle but the order stays pending — what should I check? =

Confirm the webhook URL from the CodePopular Paddle Checkout For WooCommerce settings is correctly added in your Paddle dashboard, and run the webhook connection test. Also ensure sandbox/live mode matches the environment you are using in Paddle.

= Where can I get support? =

For the free version, use the WordPress.org support forum for this plugin. For Pro features and priority help, visit codepopular.com/woopaddle.

== Screenshots ==

1. Gateway settings — Vendor ID, API key, sandbox mode, and connectivity tests.
2. Checkout display options — title, logo, message, and popup/inline mode.
3. Customer checkout with Paddle payment method enabled.
4. Paddle Classic checkout overlay completing a one-time payment.

== Changelog ==

= 1.0.3 =

• Renamed plugin-owned prefixes to WordPress.org recommended codepach / CODEPACH (classes, functions, defines, AJAX, scripts, unique options).
• Prefixed the vendor public key option as codepach_vendor_public_key.
• Gateway ID, settings option, webhook endpoint, and order meta remain shared with WooPaddle Pro.
• Removed unused bundled Paddle.js and minified admin assets; ship uncompressed JS/CSS and load Paddle.js from the official CDN.
• Documented public source repository and asset locations in the readme.

= 1.0.1 =

• Initial WordPress.org release.
• Paddle Classic one-time payments for WooCommerce.
• Sandbox and live modes.
• Popup and inline checkout display.
• Classic and Blocks checkout support.
• Webhook-based payment confirmation.
• Custom payment method title and checkout logo.
• API and webhook connectivity tests.
• HPOS and Cart & Checkout Blocks compatibility declarations.
• Feature-gated free edition (Billing API and subscriptions reserved for Pro).

== Upgrade Notice ==

= 1.0.3 = WordPress.org review fixes: codepach / CODEPACH prefixes throughout plugin-owned code. Shared Pro gateway settings and order meta are unchanged.