SaleMint Paddle Checkout for WooCommerce

SaleMint Paddle Checkout for WooCommerce connects your WooCommerce store to Paddle, a merchant-of-record payment platform built for digital products. Paddle handles the checkout, tax calculation, and invoicing, while this plugin keeps your WooCommerce orders fully in sync.

How it works

When a customer places an order, the plugin opens Paddle’s hosted checkout (modal or full-page). After the customer completes payment, the Paddle transaction ID is captured and attached to the WooCommerce order. The plugin then fetches the authoritative order totals from Paddle — including any tax Paddle applied — and updates the WooCommerce order to match, so your records are always accurate.

Key features

• Classic checkout & WooCommerce Blocks — Works with both the classic WooCommerce checkout and the modern block-based checkout.
• Modal or full-page checkout — Choose between an overlay modal or a full-page Paddle checkout, configurable from the gateway settings.
• Sandbox / live mode — Toggle between Paddle’s sandbox environment for testing and the live environment for production, without touching any code.
• Digital-only enforcement — The Paddle payment option is automatically hidden whenever the cart contains a physical product that requires shipping. This prevents it from appearing for orders Paddle cannot fulfil.
• Paddle tax categories — Assign a Paddle tax category (e.g. standard, digital-goods, ebooks, SaaS, software) to products, with a configurable store-wide default. Supports all 13 Paddle tax classifications.
• Automatic order totals sync — After payment, the plugin synchronises WooCommerce order totals — including line-item subtotals, tax lines, and the grand total — with the values reported by Paddle. An order note is added documenting the sync for auditing purposes.
• Transaction & invoice ID tracking — The Paddle transaction ID and invoice ID are saved directly to the WooCommerce order and visible on the order detail screen.
• Order-pay page support — Customers can retry a failed or pending payment from the WooCommerce order-pay page; billing details are pre-populated automatically.
• Light and dark themes — Choose between Paddle’s light and dark checkout UI to match your store’s design.

Requirements

• PHP 8.1 or higher
• WordPress 6.0 or higher
• WooCommerce (latest recommended)
• A Paddle account with an API key and client-side token

External Services

This plugin connects to Paddle’s servers to process payments and load the Paddle JavaScript SDK. By using this plugin you agree to Paddle’s terms and privacy policy.

Paddle JavaScript SDK

The Paddle checkout SDK is loaded from Paddle’s CDN on any page where the payment gateway is active:

• Production: https://cdn.paddle.com/paddle/v2/paddle.js
• Sandbox: same URL (environment is set via the client-side token)

This script is provided by Paddle.com Inc. and is required to open the hosted checkout modal.

• Paddle website
• Paddle Terms of Service
• Paddle Privacy Policy

Paddle REST API

The plugin communicates with the Paddle REST API from your server to create transactions and retrieve order details:

• Production: https://api.paddle.com
• Sandbox: https://sandbox-api.paddle.com

Data sent includes order line items, customer billing information (email, country, postcode), and currency. No data is sent unless a customer initiates checkout.