Documentation

Configuration

Every setting on the Paddle payment method screen, and what each one controls.

Gateway settings

Navigate to WooCommerce → Settings → Payments → Paddle and configure:

  • Environment — Staging (sandbox) or production.
  • Staging / Production API Key — separate Paddle API keys for each environment.
  • Staging / Production Seller ID — your Paddle seller ID for each environment.
  • Checkout Display — whether Paddle's payment form opens as an overlay popup (the default) or is embedded inline in the page. See Checkout for what each mode means in practice.
  • Checkout Theme — Paddle's hosted checkout is white by default, which can look out of place on a dark page. Dark switches Paddle's own checkout theme to match. It changes the Paddle checkout only, not your store around it.
  • Checkout Language — by default Paddle follows the customer's browser language, even if they deliberately switched your store to another language first. "Match the store language" sends Paddle whatever language WordPress is serving the page in, so a WPML or Polylang store gets the right checkout language on every request. If the store's language is not one Paddle supports, it falls back to following the browser.
  • Physical Products — hide Paddle when the cart contains a shippable item. Paddle is a merchant of record for digital goods and its terms do not cover physical ones. Off by default.
  • Gateway Logo — upload a custom logo shown next to the Paddle payment option at checkout.
  • Webhook Settings — register webhooks to receive real-time payment notifications from Paddle, and check delivery health.
  • Auto-Sync — enable scheduled product sync, set the interval (minimum 5 minutes), and choose the product tag that marks products for syncing (default: paddle).
  • Default Tax Category — the Paddle tax category products are sold under unless one is set on the product itself. See Tax categories — only Standard and SaaS are enabled on a Paddle account by default.
  • Debug log — enable logging to WooCommerce → Status → Logs for troubleshooting.

The API Key and Webhook Secret fields are password inputs, so a saved value is never displayed back to you in the settings form. To change one, type the new value over it.