README

=== PayPal Payment Buttons ===
Contributors: paypal,automattic,woocommerce
Tags: paypal, payments, buy now, payment buttons, ecommerce
Requires at least: 7.0
Requires PHP: 7.4
Tested up to: 7.1
Stable tag: 0.4.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept payments with PayPal — create branded Buy Now buttons directly in the WordPress block editor.

== Description ==

PayPal Payment Buttons lets you accept payments on your WordPress site using PayPal's Pay Links & Buttons API. Create professional, PayPal-branded Buy Now buttons without leaving the block editor.

**Key Features:**

* **API-driven button creation** — Fill in product name, price, and currency; the plugin creates a PayPal payment link automatically
* **PayPal-branded buttons** — Gold PayPal button with optional Debit/Credit Card secondary button, matching PayPal's official design
* **Live preview** — See exactly how your button will look before publishing — the frontend renders identically to the editor preview
* **26 currencies supported** — USD, EUR, GBP, JPY, and 22 more with proper currency symbol formatting
* **Stacked or single layout** — Choose between a two-button stack (PayPal + Debit/Credit) or PayPal-only button
* **Secure credential storage** — OAuth credentials are encrypted at rest using XSalsa20-Poly1305 authenticated encryption (libsodium)
* **Backward compatible** — Existing paste-code buttons continue to work unchanged

**How It Works:**

1. Connect your PayPal account using API credentials from the PayPal Developer Dashboard
2. Add the PayPal Payment Buttons block to any post or page
3. Enter your product details (name, price, currency, and optional description)
4. Click "Create New" — the plugin creates a payment link via PayPal's API
5. Publish your post — visitors see a styled PayPal button that links to checkout

== Installation ==

1. Upload the plugin to the `/wp-content/plugins/` directory, or install via the WordPress plugin screen.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. **Connect PayPal:**
a. Go to the [PayPal Developer Dashboard](https://developer.paypal.com/dashboard/applications/).
b. Create a new app (or use an existing one) under **Apps & Credentials**.
c. Copy the **Client ID** and **Client Secret**.
d. Add a PayPal Payment Buttons block in the editor and enter your credentials.
e. Start in **Sandbox** mode for testing, then switch to **Production** when ready.

= Requirements =

* WordPress 6.8 or later
* PHP 7.4 or later with OpenSSL extension
* A PayPal Business or Developer account with API credentials

== Frequently Asked Questions ==

= How do I get PayPal API credentials? =

1. Log in to the [PayPal Developer Dashboard](https://developer.paypal.com/dashboard/applications/).
2. Navigate to **Apps & Credentials**.
3. Select **Sandbox** or **Live** depending on your needs.
4. Click **Create App** or select an existing app.
5. Copy the **Client ID** and **Client Secret**.

= What's the difference between Sandbox and Production? =

**Sandbox** is PayPal's testing environment — no real money changes hands. Use it to test your buttons before going live. **Production** processes real payments. You can switch between environments in the block editor sidebar.

= Will my existing PayPal buttons still work after updating? =

Yes. Existing buttons created with the paste-code method continue to work exactly as before. There is no forced migration — old buttons render unchanged on both the editor and frontend.

= What currencies are supported? =

USD, EUR, GBP, CAD, AUD, JPY, CHF, SEK, NOK, DKK, NZD, SGD, HKD, MXN, BRL, PLN, CZK, HUF, ILS, MYR, PHP, TWD, THB, INR, CNY, and RUB. Each currency displays its proper symbol (e.g., $, €, £, ¥) on both the editor preview and published page.

= Where are my PayPal credentials stored? =

Credentials are encrypted using libsodium's `sodium_crypto_secretbox` (XSalsa20-Poly1305 authenticated encryption) before being stored in the WordPress database (`wp_options`). The encryption key is derived from your site's `AUTH_KEY` constant in `wp-config.php` using BLAKE2b.

= What happens if I disconnect PayPal? =

Disconnecting removes your stored credentials and cached token. Existing published buttons with payment links continue to work on the frontend — the links are static URLs hosted by PayPal. However, you won't be able to create new buttons or edit existing ones until you reconnect.

= I'm seeing "not authorized for Payment Links & Buttons" — what do I do? =

This means your PayPal app may not have the required permissions. In the PayPal Developer Dashboard, ensure your app has the **Payment Links & Buttons** feature enabled. If you're using a sandbox account, create a new sandbox business account with full permissions.

= Can I use this with WooCommerce? =

This plugin is designed for standalone PayPal payment buttons on posts and pages. It's separate from the WooCommerce PayPal payment gateway. Both can coexist on the same site.

== Changelog ==

= 0.8.0 =
* **New:** API-driven button creation via PayPal's Pay Links & Buttons API
* **New:** OAuth 2.0 connection flow with encrypted credential storage (XSalsa20-Poly1305)
* **New:** Live button preview in the block editor with PayPal-branded styling
* **New:** Frontend rendering matches block editor preview exactly — currency symbols, PayPal logo, product info card, stacked/inline layouts
* **New:** Product description field with truncation on the published page
* **New:** Client-side and server-side input validation
* **New:** Automatic token refresh on expiry with retry logic
* **New:** Exponential backoff for transient API errors (500/502/503)
* **New:** PayPal URL domain whitelist for payment link validation
* **New:** 26 supported currencies with proper symbol formatting
* **New:** Delete button action in the sidebar
* **Fixed:** Extract payment_link from HATEOAS links array instead of non-existent top-level field
* **Fixed:** Align block.json attribute names between editor (JS) and server-side (PHP) registration
* **Fixed:** Frontend style.css build path (was incorrectly pointing to editor.css)
* **Improved:** User-friendly error messages for all PayPal API errors
* **Improved:** Backward compatibility with v0.4.0-alpha paste-code blocks via deprecated.js

= 0.4.0 - 2026-04-11 =
* Fixed escaping issue for stacked payments buttons.
* Restore border on header component.
* Update minimum WordPress version to 6.8.
* Update package dependencies.

= 0.3.2 - 2025-11-20 =
* Tested up to WordPress 6.9.
* Update package dependencies.
* Jetpack: Remove getIconColor functions for block icons.

= 0.3.1 - 2025-10-09 =
* Update package dependencies.
* Update short description for plugin.

= 0.3.0 - 2025-09-16 =
* Improve robustness of PayPal Payment Buttons parsing.
* Remove admin page for PayPal Payment Buttons plugin.
* Update readme.txt and adds assets for distribution.

= 0.2.0 - 2025-07-25 =
* Initial release setup and plugin structure.
* Integration with paypal-payments package for core functionality.
* Working PayPal Payment Button block with availability data.

== Upgrade Notice ==

= 0.8.0 =
Major update: API-driven PayPal button creation replaces the paste-code workflow. Existing buttons are fully backward compatible — no action required.

== Screenshots ==

1. Connect PayPal — Enter API credentials from the PayPal Developer Dashboard.
2. Create New — Fill in product name, price, and currency in the block editor.
3. Live Preview — See the PayPal-branded button preview before publishing.
4. Frontend — Published PayPal button with product info and payment link.
5. Stacked Layout — PayPal button with Debit/Credit Card secondary button.

automattic / paypal-payment-buttons

Package info

Security

Statistics

README