Title: PayWhirl Widget Blocks Author: paywhirl Published: August 8, 2014 Last modified: October 2, 2025 --- Search plugins ![](https://ps.w.org/paywhirl-recurring-payments/assets/banner-772x250.png?rev=3371976) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/paywhirl-recurring-payments/assets/icon-256x256.png?rev=3371976) # PayWhirl Widget Blocks By [paywhirl](https://profiles.wordpress.org/paywhirl/) [Download](https://downloads.wordpress.org/plugin/paywhirl-recurring-payments.2.0.0.zip) * [Details](https://wordpress.org/plugins/paywhirl-recurring-payments/#description) * [Reviews](https://wordpress.org/plugins/paywhirl-recurring-payments/#reviews) * [Installation](https://wordpress.org/plugins/paywhirl-recurring-payments/#installation) * [Development](https://wordpress.org/plugins/paywhirl-recurring-payments/#developers) [Support](https://wordpress.org/support/plugin/paywhirl-recurring-payments/) ## Description PayWhirl Widget Blocks connects your WordPress site to your PayWhirl account so you can embed subscription widgets and buy buttons anywhere the block editor is available. Store owners can manage their PayWhirl API credentials from an admin settings page, test the connection, and drop the **PayWhirl Widget** block into posts, pages, templates, or patterns without touching code. **Watch a quick setup walkthrough** **Give it a whirl [View demo](https://paywhirl.com/demo)** ### How to Use PayWhirl Widget Blocks ### Configure API access * Go to **PayWhirl API Connection**. * Paste your PayWhirl API key and secret. Leave fields blank to keep existing encrypted credentials. * Use **Test Connection** to confirm access and view rate-limit headers. ### Add a widget to content * Open any block editor (post, page, template, reusable block). * Search for “PayWhirl Widget”. * Click **Fetch PayWhirl widgets** and select the desired widget or buy button. * Choose the embed type (widget or buy button) in the inspector panel. * Publish or update the content. The live site will load the PayWhirl embed script and render the widget. ### Customer portal link * Enable the **Customer Portal Link** section on the settings page to sync a menu item or create an embedded portal page. * Disable the toggle to remove the synced menu item and clear stored menu/page references. ### Shortcode Use the shortcode `[paywhirl_customer_portal]` to embed the PayWhirl customer portal inside classic editors or theme builder widgets. ### Blocks * **paywhirl/widget** – Embed PayWhirl widgets or buy buttons anywhere in block- based content. ## Screenshots [⌊Quick-start overview guiding you through connecting PayWhirl to WordPress.⌉⌊Quick- start overview guiding you through connecting PayWhirl to WordPress.⌉[ Quick-start overview guiding you through connecting PayWhirl to WordPress. [⌊PayWhirl onboarding tips with highlighted block examples and help links.⌉⌊PayWhirl onboarding tips with highlighted block examples and help links.⌉[ PayWhirl onboarding tips with highlighted block examples and help links. [⌊PayWhirl settings screen showing credential status and portal link options.⌉⌊PayWhirl settings screen showing credential status and portal link options.⌉[ PayWhirl settings screen showing credential status and portal link options. [⌊PayWhirl Widget block in the editor with widget selector and embed options.⌉⌊PayWhirl Widget block in the editor with widget selector and embed options.⌉[ PayWhirl Widget block in the editor with widget selector and embed options. [⌊Customer portal menu sync settings with navigation link placement options.⌉⌊Customer portal menu sync settings with navigation link placement options.⌉[ Customer portal menu sync settings with navigation link placement options. [⌊Embedded customer portal example using the shortcode.⌉⌊Embedded customer portal example using the shortcode.⌉[ Embedded customer portal example using the shortcode. [⌊Widget selection panel highlighting snippet previews and preview toggle controls.⌉⌊ Widget selection panel highlighting snippet previews and preview toggle controls .⌉[ Widget selection panel highlighting snippet previews and preview toggle controls. ## Blocks This plugin provides 1 block. * PayWhirl Widget ## Installation 1. Upload the `paywhirl-widget-blocks` directory to `/wp-content/plugins/` or install via the **Plugins Add New** screen. 2. Activate the plugin through **Plugins Installed Plugins**. 3. Visit **PayWhirl API Connection** in the WordPress admin menu. 4. Enter your PayWhirl API key and secret (or define them in `wp-config.php` using` PAYWHIRL_WB_API_KEY` and `PAYWHIRL_WB_API_SECRET`). 5. Click **Save Changes**, then **Test Connection** to verify credentials. 6. Add the **PayWhirl Widget** block to any editor canvas to choose a widget or buy button and publish. ## FAQ ### Do I need a PayWhirl account to use the plugin? Yes. Connect your PayWhirl account in a couple of clicks, then drop blocks into any page without writing code. ### Can I add subscription purchase options to WordPress? Yes. Use the PayWhirl Widget block to place subscription plans, payment plans, memberships, or donations anywhere the block editor is available. ### Can customers purchase using widgets (not just buttons)? Yes. PayWhirl’s embeddable widgets provide an in-page, secure checkout for subscriptions and more, so visitors can buy right where they are. ### Does it support one-time payments as well as subscriptions? Yes. You can sell subscriptions, payment plans, and one-time purchases, and you can even mix them in the same flow. ### Can I add quick “Buy Now” calls-to-action? Yes. The Buy Button block lets you place focused purchase CTAs in hero areas, pricing tables, or posts wherever you want to convert. ### Can customers manage their subscriptions on my site? Yes. Add the Customer Portal block or shortcode so customers can update cards, pause/ cancel/modify subscriptions, and view billing history, reducing support load. ### Does this work with the modern WordPress editor (Gutenberg)? Yes. The plugin ships native blocks that respect global styles and work across posts, pages, and templates. ### I still use classic editors/theme builders-can I embed the portal? Yes. Use the shortcode `[paywhirl_customer_portal]` anywhere shortcodes are accepted. ### Is PayWhirl secure? Yes. PayWhirl adheres to modern security standards (TLS/SSL), and the platform maintains PCI DSS compliance (v4.0). ### What payment gateways can I use? PayWhirl supports multiple gateways so you can choose what fits your business (e. g., Stripe, Square, Authorize.net, Braintree; PayPal via Braintree on eligible plans). ### Can I accept ACH / bank payments? Yes. ACH/eCheck is supported through certain gateways (e.g., Stripe and Authorize. net eCheck). ### Does it cost money? We offer a Free plan with no monthly fee (great for getting started). You can upgrade for lower transaction rates and advanced features as you grow. ### Will this replace my existing one-time cart? No. You can keep your existing one-time checkout and add PayWhirl for recurring options, giving you the best of both worlds. ### Can I customize the look and feel to match my brand? Yes. You can style the checkout and customer portal to fit your site’s design system. ### How fast can I go live? Most users connect their account, drop a block, and publish in minutes. The plugin includes a quick, animated setup guide right in the settings. ### Do I need a developer? No. Blocks are point-and-click, but developers still have flexibility through PayWhirl’s broader platform features and docs if they want to go deeper. ### Can I create “build-a-box” or multi-step subscription flows? Yes. PayWhirl widgets can be chained to create custom funnels, including recurring and one-time add-ons for highly flexible offers. ### The widget isn’t rendering on my page. What should I check? Ensure the PayWhirl Widget block is saved with a selected widget. Hard-refresh the page (or clear caching layers) so the PayWhirl loader script and snippet are both present in the markup. Browser extensions that block third-party scripts may also prevent rendering. ## Reviews ![](https://secure.gravatar.com/avatar/d07a3b683075167c986c76bf1f008c72f9a4032660011ab76fe02487d3220574? s=60&d=retro&r=g) ### 󠀁[Plugin does not work currently](https://wordpress.org/support/topic/plugin-does-not-work-currently/)󠁿 [czeller](https://profiles.wordpress.org/czeller/) September 3, 2016 Settings window not working, cannot get logged in, etc ![](https://secure.gravatar.com/avatar/b9ce936bf795a08a5aa6a9b696721816f724602db824c4cfacd77609ef768ac8? s=60&d=retro&r=g) ### 󠀁[Non responsive to new customer queries](https://wordpress.org/support/topic/non-responsive-to-new-customer-queries/)󠁿 [vpetrichenko](https://profiles.wordpress.org/vpetrichenko/) September 3, 2016 Completely non responsive to new customer support queries. No response in 2-3 days since ticket was raised. Not even one note to say they are looking at it! Unprofessional. I deleted my account permanently. Concerned their support is unreliable for longer term customers… [ Read all 5 reviews ](https://wordpress.org/support/plugin/paywhirl-recurring-payments/reviews/) ## Contributors & Developers “PayWhirl Widget Blocks” is open source software. The following people have contributed to this plugin. Contributors * [ paywhirl ](https://profiles.wordpress.org/paywhirl/) [Translate “PayWhirl Widget Blocks” into your language.](https://translate.wordpress.org/projects/wp-plugins/paywhirl-recurring-payments) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/paywhirl-recurring-payments/), check out the [SVN repository](https://plugins.svn.wordpress.org/paywhirl-recurring-payments/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/paywhirl-recurring-payments/) by [RSS](https://plugins.trac.wordpress.org/log/paywhirl-recurring-payments/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.0.0 Our biggest PayWhirl for WordPress release ever – rebuilt from the ground up to play perfectly with the modern block editor so you can embed subscription widgets, buy buttons, and the Customer Portal anywhere without touching code. **Highlights** * Widget Block – Drop in any PayWhirl widget (subscriptions, payment plans, memberships, donations) and it just works. * Buy Button Block – Add focused purchase calls-to-action anywhere, from hero sections to pricing tables or blog posts. * Customer Portal Block – Give customers a secure area to manage subscriptions, update cards, and view billing history right on your site. * Guided setup with an animated walkthrough to get you from install to first subscription in a single coffee break. * Copy-exact embeds from PayWhirl for pixel-perfect widgets with no styling surprises. * Built for the modern editor with responsive, accessible blocks that respect global styles. * Faster from idea to live offer so you can launch “Subscribe& Save”, memberships, payment plans, or recurring donations in minutes. **Why PayWhirl on WordPress?** * Sell subscriptions the easy way by placing recurring options next to your content. * Delight customers with self-service tools that reduce support tickets. * Grow recurring revenue by testing pricing and iterating quickly.* Keep every experience on-brand and on-domain. **What’s new in 2.0.0 (at a glance)** * Brand-new Widget, Buy Button, and Customer Portal blocks. * Visual setup guide on the settings page with an animated walkthrough.* Improved admin UX and refreshed docs to reduce guesswork. * Compatibility updates for the latest WordPress releases and editor improvements. **Getting started** 1. Install or update the plugin and connect your PayWhirl account. 2. Add a PayWhirl Widget, Buy Button, or Customer Portal block to any page. 3. Publish and start selling subscriptions. #### 0.1.0 * Added secure API credential storage with encryption and diagnostic testing. * Introduced REST proxy for PayWhirl widgets and dynamic block rendering for widgets and buy buttons. * Added customer portal menu sync, embedded portal shortcode, and WordPress admin UI. ## Meta * Version **2.0.0** * Last updated **11 months ago** * Active installations **10+** * WordPress version ** 6.0 or higher ** * Tested up to **6.6.7** * PHP version ** 7.4 or higher ** * Tags * [blocks](https://wordpress.org/plugins/tags/blocks/)[ecommerce](https://wordpress.org/plugins/tags/ecommerce/) [Embeds](https://wordpress.org/plugins/tags/embeds/)[subscriptions](https://wordpress.org/plugins/tags/subscriptions/) * [Advanced View](https://wordpress.org/plugins/paywhirl-recurring-payments/advanced/) ## Ratings 2.6 out of 5 stars. * [ 2 5-star reviews ](https://wordpress.org/support/plugin/paywhirl-recurring-payments/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/paywhirl-recurring-payments/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/paywhirl-recurring-payments/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/paywhirl-recurring-payments/reviews/?filter=2) * [ 3 1-star reviews ](https://wordpress.org/support/plugin/paywhirl-recurring-payments/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/paywhirl-recurring-payments/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/paywhirl-recurring-payments/reviews/) ## Contributors * [ paywhirl ](https://profiles.wordpress.org/paywhirl/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/paywhirl-recurring-payments/)