Want visitors to pay through PayPal right after they submit a WPForms form — without a complex payment stack? Thenameda Form Payments with PayPal for WPForms adds PayPal checkout to any form. Configure credentials per form in the WPForms builder; on submit, buyers are redirected to PayPal, then return to your site after payment is captured.
This complete beginner-friendly guide covers features, installation, PayPal API credentials, step-by-step configuration, how payments are captured, managing transactions and refunds, WPForms compatibility, use cases, troubleshooting, and FAQs.
Focus keyword: WPForms PayPal payments
Plugin: Thenameda Form Payments with PayPal for WPForms (free on WordPress.org)
Compatible with: WPForms Lite and WPForms Pro
Introduction and Overview
Thenameda Form Payments with PayPal for WPForms connects your WPForms forms to PayPal Checkout using the PayPal REST v2 Orders API (create order → approve → capture). You enable PayPal inside each form’s settings, map the amount (or use WPForms payment total), and store completed transactions in WordPress for review, CSV export, and one-click refunds.
It works with WPForms Lite and WPForms Pro, so you can collect payments even if you are not on WPForms Pro’s built-in payment addons.
Key Features
- Per-form PayPal settings inside WPForms (Settings → PayPal)
- Redirect checkout via PayPal REST v2 Orders API
- Sandbox and Live modes with separate credentials
- 25 supported currencies
- Flexible amount mapping — map any field as the payment amount, or use the WPForms payment total
- Optional quantity multiplier and customer email pre-fill
- Configurable success and cancel return URLs
- Transaction listing with payer, total, and status
- Transaction detail view with the full PayPal response
- One-click refunds from the transaction detail screen
- CSV export of payment data (up to 10 recent records in the free version)
Installation and Activation
Before you start
Install and activate WPForms Lite or WPForms Pro first. This plugin extends WPForms; it does not replace the form builder.
Install from WordPress.org
- Go to Plugins → Add New.
- Search for Thenameda Form Payments with PayPal for WPForms.
- Click Install Now, then Activate.
Or upload the ZIP
- Download from the WordPress.org plugin page.
- Go to Plugins → Add New → Upload Plugin.
- Upload the ZIP, install, and activate.
Getting PayPal API Credentials
Payments require a PayPal REST app (Client ID + Client Secret).
- Open the PayPal Developer Dashboard → Applications.
- Create (or select) an app for Sandbox testing and/or Live production.
- Copy the Client ID and Client Secret for each mode.
- Keep Sandbox credentials for testing; switch to Live only when you are ready for real payments.
Tip: Always complete at least one Sandbox payment end-to-end before enabling Live mode on a public form.
Step-by-Step Configuration
- Open WPForms → All Forms and edit a form.
- Go to Settings → PayPal.
- Enable PayPal for that form.
- Choose Sandbox or Live mode.
- Enter the matching Client ID and Client Secret.
- Set the payment amount:
- Select an Amount field, or
- Leave the default to use the WPForms payment total
- (Optional) Map a quantity field to multiply the amount.
- (Optional) Map a customer email field for PayPal pre-fill.
- Set success and cancel return URLs (thank-you page and cancel/back page).
- Save the form, then submit a test payment in Sandbox.
How PayPal Payments Are Captured
Here is the checkout flow when PayPal is enabled on a form:
- The visitor completes and submits the WPForms form.
- The plugin creates a PayPal order (amount, currency, description, return/cancel URLs, optional email).
- The visitor is redirected to PayPal to approve payment securely.
- After approval, PayPal returns the buyer to your success URL.
- The plugin captures the approved order via PayPal’s API.
- The transaction is stored in WordPress under PayPal Transactions for review.
Card and wallet handling happens on PayPal’s side. The plugin creates orders, redirects for approval, captures payments, and can issue refunds through PayPal’s REST APIs.
How to View and Manage Transactions
Open PayPal Transactions in the WordPress admin menu to manage payments.
What you can do
- Browse transactions with payer, total, and status columns
- Open a transaction to see the full PayPal response
- Issue a one-click refund from the detail screen
- Export CSV payment data (free version includes up to 10 recent records)
Use the listing for day-to-day reconciliation, and the detail screen when you need capture IDs or raw PayPal payload data for support.
How the Plugin Works with WPForms
- Settings live inside the familiar WPForms form builder
- Works with WPForms Lite and Pro
- Enable PayPal only on forms that should collect money
- Amount can come from a mapped field or WPForms payment total
- Return URLs keep buyers on your thank-you / cancel pages after PayPal
This is ideal when you want simple PayPal redirect checkout on contact, booking, donation, invoice, or order request forms without rebuilding your stack.
Use Cases and Examples
1. Service deposits and booking fees
Collect a fixed deposit after a booking inquiry form submit.
2. Donations
Map a donation amount field (and optional quantity) and send donors to PayPal Checkout.
3. Invoice / quote acceptance
Share a payment form where the amount comes from a total field your client confirmed.
4. Digital product or setup fees
Use WPForms for order details, then redirect to PayPal for secure payment capture.
5. Agency client sites
Offer PayPal-enabled WPForms as a standard deliverable for local businesses that already prefer PayPal.
Troubleshooting
No redirect to PayPal after submit
- Confirm PayPal is enabled under Settings → PayPal for that form.
- Verify Client ID / Secret match the selected Sandbox or Live mode.
- Check that the amount field (or payment total) resolves to a valid number greater than zero.
- Temporarily disable conflicting form redirect/confirmation plugins and retest.
Payment approved on PayPal but not stored
- Confirm the success return URL points to a reachable page on the same site.
- Avoid caching the return URL page aggressively.
- Open PayPal Transactions and check for a pending/failed capture status.
- Review hosting/error logs around the return request time.
Refund fails
- Ensure you are in the same mode (Sandbox/Live) used for the original capture.
- Confirm API credentials still have refund permissions for that app.
- Open the transaction detail and verify a valid PayPal capture/transaction ID exists.
Wrong amount charged
- Re-check Amount field mapping vs WPForms payment total.
- If using quantity, confirm the quantity field value is numeric.
- Retest in Sandbox after saving form settings.
Frequently Asked Questions (FAQ)
Where do I get PayPal API credentials?
Create an app in the PayPal Developer Dashboard and copy the Client ID and Client Secret for Sandbox and/or Live.
How is the payment amount determined?
Select an Amount field in the PayPal settings, or leave the default to use the WPForms payment total. An optional quantity field can multiply the amount.
Where can I see payments?
Under PayPal Transactions in the WordPress admin menu.
Does it work with WPForms Lite?
Yes. It works with WPForms Lite and WPForms Pro.
What data is sent to PayPal?
Only what checkout needs: amount, currency, description, optional payer email, return/cancel URLs, plus API authentication. Full form answers are not sent to PayPal beyond those checkout fields. See the plugin’s External Services notes on WordPress.org for details.
Can I refund from WordPress?
Yes. Open a transaction’s detail screen and use one-click refund (processed through PayPal’s API).
Conclusion
If you need simple, reliable WPForms PayPal payments, Thenameda Form Payments with PayPal for WPForms gives you per-form PayPal settings, Sandbox/Live modes, redirect checkout, admin transactions, refunds, and CSV export — without forcing WPForms Pro payment addons.
Enable PayPal on one form, test in Sandbox, then go Live when your return URLs and amounts look correct.
Download free: Thenameda Form Payments with PayPal for WPForms on WordPress.org
