Description
HandyPay lets you accept card payments on your WordPress site without WooCommerce or a complicated checkout setup. Create a payment button, then drop it on a page, share it as a URL, or paste it in an email.
Why HandyPay?
- One button, three ways to use it — embed on a page, share a URL, paste raw HTML on any site.
- Unlimited buttons — one for every service, product, or tier. Manage them all from one screen.
- Sharable payment links —
/handypay/pay/your-slugURLs you can drop in DMs, emails, social bios. - Reusable or one-time — pay-me-anytime tip jar, or single-use ticket link that expires after one purchase.
- Custom design — colors, padding, corner radius, font (built-in Matter, Google Fonts, or upload your own).
- Live preview — see the button update as you configure it.
- Built-in dashboard — revenue stats, recent payments, status breakdown, sparkline chart.
- Powered by HandyPay — a complete merchant platform, including a mobile app, payouts, and dispute management.
HandyPay Pro
HandyPay Pro is an optional paid upgrade ($20/month):
- Reduced transaction fees on every payment.
- Custom payment-page branding — your logo, colors, and a footer message — added by the separate HandyPay Pro add-on, installed from handypay.me.
The “Secure checkout powered by HandyPay” credit on the payment page is off by default and only appears if you turn it on under HandyPay Settings.
What you need
- A HandyPay merchant account — sign up at merchant.handypay.me (free).
- An API key from the HandyPay portal.
- Two minutes for setup.
Features
- Drop-in
[handypay_pay]shortcode with attributes for amount, currency, description, button text, colors, font, padding, and size. - Payment Buttons admin: create unlimited buttons, each with its own price and styling.
- Sharable payment links at clean URLs.
- Webhook reconciliation with HMAC-SHA256 signature verification.
- Built-in dashboard mirroring the HandyPay merchant portal.
- Custom font uploads (.woff2, .woff, .ttf, .otf).
- Curated Google Fonts: Inter, Roboto, Poppins, Manrope, DM Sans, Plus Jakarta, Work Sans, Space Grotesk.
- Onboarding wizard for first-time merchants.
- Test mode toggle.
External services
This plugin connects to the HandyPay payments API (https://api.handypay.me) to create payment sessions, render signed buttons, and reconcile payments through HandyPay’s payment processor (Stripe). This connection is required for the plugin to accept payments.
- When: when a button or payment link is rendered, when a customer starts a payment, when HandyPay sends a webhook to your site, and when the store owner views the dashboard or manages payments.
- Data sent: payment amount and currency, button/link descriptions, the customer’s email (if provided at checkout), and your HandyPay API key for authentication. Raw card details are collected by HandyPay/Stripe directly and are never sent to or stored on your site.
- HandyPay: Terms — https://handypay.me/terms · Privacy — https://handypay.me/privacy
- Stripe (payment processor): Terms — https://stripe.com/legal · Privacy — https://stripe.com/privacy
Blocks
This plugin provides 1 block.
- HandyPay Button
Installation
- Upload the
handypay-paymentsfolder to/wp-content/plugins/or install via the Plugins screen. - Activate HandyPay Payments under Plugins.
- Go to HandyPay Settings, paste your API key and webhook signing secret.
- Add the displayed webhook URL to your HandyPay merchant portal.
- Go to HandyPay Payment Buttons and create your first button.
FAQ
-
Do I need WooCommerce?
-
No. HandyPay is standalone and works on any WordPress site, including page-builder themes like Elementor, Divi, Bricks, Beaver Builder, and the default block editor.
-
Where does the payment actually happen?
-
On a HandyPay-hosted Stripe Checkout page. Customers leave your site, complete payment, and return to your configured success page. PCI compliance is handled by HandyPay + Stripe — your WordPress site never touches card data.
-
Can prices be tampered with?
-
No. Amounts are signed server-side when the button renders, and re-verified on the way to checkout. Customers can’t modify prices via DevTools.
-
How are webhooks verified?
-
HandyPay signs every webhook with HMAC-SHA256. The plugin verifies in constant time using PHP’s
hash_equalsbefore processing. -
Can I use my own fonts?
-
Yes. Upload
.woff2,.woff,.ttf, or.otffiles via HandyPay Fonts, then pick them in Settings Appearance Font. Each button can also override the font via thefont="..."shortcode attribute. -
Does it work on multisite?
-
Yes. Activate per-site; each site has its own API key and settings.
-
What countries are supported?
-
Wherever HandyPay supports onboarding merchants. See handypay.me for the current list.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“HandyPay Payments” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “HandyPay Payments” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- First stable release.
- Refund management from the Payments screen.
- Dispute management with evidence submission.
- Redesigned create-button form and admin tables (shadcn-style), toast and confirm dialogs, and a full-screen admin app shell.
- External-services disclosure added (HandyPay API + Stripe).
0.4.0
- Custom font uploads (.woff2/.woff/.ttf/.otf) + curated Google Fonts.
- Payment Buttons (renamed from Payment Links) with per-row Copy URL and Copy Shortcode.
- Plan & Branding admin: free vs Pro, upgrade flow, branded payment page (logo, colors, footer text, hide HP branding).
- Subscription webhook handlers update the cached plan automatically.
- Dashboard nudge for free merchants to upgrade.
0.3.0
- Payment Links (now “Payment Buttons”): create reusable / one-time / capped / expiring buttons with their own URLs.
- Public landing page at
/handypay/pay/<slug>. [handypay_pay link="slug"]shortcode mode.- Webhooks increment use count for one-time and capped links.
0.2.0
- Live preview on the settings page.
- Button color, hover color, padding, font size, font weight, corner radius controls.
- Size presets (Small / Medium / Large).
- Matter typeface (same as the HandyPay merchant portal).
- Built-in dashboard mirroring the HandyPay merchant portal.
0.1.0
- Initial release.
