Need SagePay / Opayo on WPForms? Thenameda Form Payments with SagePay for WPForms redirects submitters to the secure Opayo hosted payment page, encrypts the Form protocol Crypt payload, then records the result in WordPress for review and CSV export.
This complete guide covers features, install, Opayo credentials, field mapping, how payments work, the [sagepay-details] shortcode, troubleshooting, and FAQs.
Focus keyword: WPForms SagePay payments
Plugin: Thenameda Form Payments with SagePay for WPForms
Compatible with: WPForms Lite and WPForms Pro
Introduction and Overview
Configure Opayo under each form’s Settings → SagePay. On submit, the plugin builds an AES-128-CBC encrypted Crypt request, sends the buyer to Sandbox or Live Opayo, decrypts the return response, and stores the transaction under SagePay Transactions. Card details stay on Opayo’s hosted page.
Key Features
- Per-form SagePay settings in the WPForms builder
- Opayo Form integration with AES-128-CBC Crypt encryption
- Sandbox and Live modes with separate vendor credentials
- Transaction types: Payment, Deferred, Authenticate
- Optional 3D Secure request
- Amount, quantity, email, billing, and shipping field mapping
- Automatic WPForms Name and Address field support
- Optional Shipping Same as Billing
- Success and failure return URLs
[sagepay-details]shortcode for payment results- Transaction list with status badges, detail view, CSV export
- Improved redirect interstitial and payment toast notifications
Installation and Activation
- Activate WPForms Lite or Pro.
- Install and activate Thenameda Form Payments with SagePay for WPForms.
- Edit a form → Settings → SagePay → enable SagePay.
- Enter Opayo Vendor Name and Encryption Password (Sandbox/Live).
- Map amount, addresses, and return URLs; save and publish.
Requirements: WordPress 6.2+, PHP 7.2+, WPForms, SagePay/Opayo merchant account (Vendor Name + Encryption Password).
Step-by-Step Configuration
- Get Vendor Name and Encryption Password from MySagePay / Opayo Form settings.
- In WPForms, enable SagePay and choose Sandbox or Live.
- Set transaction type (Payment / Deferred / Authenticate) and optional 3D Secure.
- Map amount (or payment total), quantity, email, billing, and shipping fields.
- Use ISO 3166-1 alpha-2 country codes (e.g. GB, IE, US). State is required for US.
- Set success and failure return URLs; add
[sagepay-details]on the success page.
How SagePay / Opayo Payments Work
- Visitor submits a SagePay-enabled form.
- Plugin encrypts payment + customer/address data into Crypt.
- Visitor completes payment on the Opayo hosted page.
- Opayo redirects back with an encrypted response.
- Plugin decrypts the response and records status in SagePay Transactions.
Manage Transactions
Review status badges and details under SagePay Transactions, export CSV for reconciliation, and show results on-page with [sagepay-details].
Use Cases
- UK/EU merchants standardized on Opayo / Elavon
- Booking deposits with billing address capture
- Deferred / authenticate flows where your process requires them
Troubleshooting
- Crypt errors: confirm Encryption Password matches the selected Sandbox/Live vendor.
- Country/state rejections: use alpha-2 codes; include State for US addresses.
- No return recording: verify success/failure URLs are reachable and not aggressively cached.
FAQ
Where are credentials? MySagePay / Opayo Form integration settings.
Amount source? Mapped field, WPForms total, quantity, or fixed fallback.
Where are payments? SagePay Transactions (+ optional shortcode).
WPForms Lite? Yes.
Conclusion
For solid WPForms SagePay payments, this plugin delivers Opayo hosted checkout, encrypted Crypt handling, address mapping, transaction logs, and CSV export — without storing card data on WordPress.
