FormPays Pro is a comprehensive payment form plugin designed to make online payments simple and secure. Whether you're running a small business or a large site, this plugin provides everything you need to collect payments through custom forms. From flexible payment forms to enterprise-grade security, FormPays Pro is designed to simplify online payments for businesses, nonprofits, and educators.<\/p>\n\n
[formpays_pro_payment_form id=\"123\"]<\/code><\/li>\n- Transaction Management<\/strong>: Complete payment tracking and management<\/li>\n
- Email Notifications<\/strong>: Automatic notifications for payments and failures<\/li>\n
- Email Templates<\/strong>: Customize notification emails for customers and admins<\/li>\n<\/ul>\n\n
Payment Gateways<\/h4>\n\n\n- Razorpay<\/strong>: Cards, UPI, NetBanking, Wallets<\/li>\n
- PayU<\/strong>: Cards, UPI, NetBanking, Wallets<\/li>\n
- Test Mode<\/strong>: Development and testing support<\/li>\n
- Webhook Integration<\/strong>: Automatic payment status updates<\/li>\n<\/ul>\n\n
Form Builder<\/h4>\n\n\n- Field Types<\/strong>: Text, Email, Phone, Number, Select, Radio, Checkbox, Textarea<\/li>\n
- Custom Fields<\/strong>: Add unlimited custom fields<\/li>\n
- Required Fields<\/strong>: Mark fields as required<\/li>\n
- Field Validation<\/strong>: Built-in validation for all field types<\/li>\n
- Drag & Drop<\/strong>: Easy field reordering<\/li>\n<\/ul>\n\n
Admin Features<\/h4>\n\n\n- Dashboard<\/strong>: Overview of forms, transactions, and revenue<\/li>\n
- Form Management<\/strong>: Create, edit, and delete payment forms<\/li>\n
- Transaction Tracking<\/strong>: View all payments with filters and export<\/li>\n
- Gateway Settings<\/strong>: Secure configuration for payment gateways<\/li>\n
- Email Templates<\/strong>: Customize notification emails<\/li>\n<\/ul>\n\n
Security Features<\/h4>\n\n\n- Nonce Verification<\/strong>: CSRF protection for all forms<\/li>\n
- Input Sanitization<\/strong>: All user inputs are sanitized<\/li>\n
- Encrypted Storage<\/strong>: Sensitive gateway credentials are encrypted<\/li>\n
- Webhook Verification<\/strong>: Secure webhook handling with signature verification<\/li>\n
- Permission Checks<\/strong>: Admin-only access to sensitive operations<\/li>\n<\/ul>\n\n
External Services<\/h3>\n\n
This plugin connects to third-party payment gateway services to process payments. Below is detailed information about each service:<\/p>\n\n
Razorpay<\/h4>\n\n\n- What it is<\/strong>: Payment gateway service for processing online payments in India<\/li>\n
- When data is sent<\/strong>: When a user submits a payment form using Razorpay gateway<\/li>\n
- Data sent<\/strong>: Customer name, email, mobile number, payment amount, currency, order details<\/li>\n
- Purpose<\/strong>: To create payment orders and process payments securely<\/li>\n
- Service URL<\/strong>: https:\/\/razorpay.com\/<\/li>\n
- Terms of Service<\/strong>: https:\/\/razorpay.com\/terms\/<\/li>\n
- Privacy Policy<\/strong>: https:\/\/razorpay.com\/privacy\/<\/li>\n
- Documentation<\/strong>: https:\/\/razorpay.com\/docs\/<\/li>\n<\/ul>\n\n
PayU<\/h4>\n\n\n- What it is<\/strong>: Payment gateway service for processing online payments<\/li>\n
- When data is sent<\/strong>: When a user submits a payment form using PayU gateway<\/li>\n
- Data sent<\/strong>: Customer name, email, mobile number, payment amount, currency, order details<\/li>\n
- Purpose<\/strong>: To create payment orders and process payments securely<\/li>\n
- Service URL<\/strong>: https:\/\/payu.in\/<\/li>\n
- Terms of Service<\/strong>: https:\/\/payu.in\/terms-of-use<\/li>\n
- Privacy Policy<\/strong>: https:\/\/payu.in\/privacy-policy<\/li>\n
- Documentation<\/strong>: https:\/\/docs.payu.com\/<\/li>\n<\/ul>\n\n
PayPal<\/h4>\n\n\n- What it is<\/strong>: Global payment gateway service for processing online payments<\/li>\n
- When data is sent<\/strong>: When a user submits a payment form using PayPal gateway<\/li>\n
- Data sent<\/strong>: Customer name, email, payment amount, currency, order details<\/li>\n
- Purpose<\/strong>: To create payment orders and process payments securely<\/li>\n
- Service URL<\/strong>: https:\/\/paypal.com\/<\/li>\n
- Terms of Service<\/strong>: https:\/\/www.paypal.com\/us\/legalhub\/useragreement-full<\/li>\n
- Privacy Policy<\/strong>: https:\/\/www.paypal.com\/us\/legalhub\/privacy-full<\/li>\n
- Documentation<\/strong>: https:\/\/developer.paypal.com\/<\/li>\n<\/ul>\n\n
PhonePe<\/h4>\n\n\n- What it is<\/strong>: Digital payment platform for processing UPI and other payments in India<\/li>\n
- When data is sent<\/strong>: When a user submits a payment form using PhonePe gateway<\/li>\n
- Data sent<\/strong>: Customer name, email, mobile number, payment amount, currency, order details<\/li>\n
- Purpose<\/strong>: To create payment orders and process payments securely<\/li>\n
- Service URL<\/strong>: https:\/\/phonepe.com\/<\/li>\n
- Terms of Service<\/strong>: https:\/\/www.phonepe.com\/terms-and-conditions\/<\/li>\n
- Privacy Policy<\/strong>: https:\/\/www.phonepe.com\/privacy-policy\/<\/li>\n
- Documentation<\/strong>: https:\/\/developer.phonepe.com\/<\/li>\n<\/ul>\n\n
Instamojo<\/h4>\n\n\n- What it is<\/strong>: Payment gateway service for processing online payments in India<\/li>\n
- When data is sent<\/strong>: When a user submits a payment form using Instamojo gateway<\/li>\n
- Data sent<\/strong>: Customer name, email, mobile number, payment amount, currency, order details<\/li>\n
- Purpose<\/strong>: To create payment orders and process payments securely<\/li>\n
- Service URL<\/strong>: https:\/\/instamojo.com\/<\/li>\n
- Terms of Service<\/strong>: https:\/\/instamojo.com\/terms\/<\/li>\n
- Privacy Policy<\/strong>: https:\/\/instamojo.com\/privacy\/<\/li>\n
- Documentation<\/strong>: https:\/\/docs.instamojo.com\/<\/li>\n<\/ul>\n\n
Data Security<\/strong>: All payment data is transmitted securely using HTTPS encryption. Customer payment details (card numbers, etc.) are handled directly by the payment gateways and never stored on your WordPress site.<\/p>\n\nUser Consent<\/strong>: By using payment forms created with this plugin, users consent to their payment data being processed by the selected payment gateway according to that gateway's terms and privacy policy.<\/p>\n\nRequirements<\/h3>\n\n\n- WordPress 5.0 or higher<\/li>\n
- PHP 7.4 or higher<\/li>\n
- MySQL 5.6 or higher<\/li>\n
- SSL certificate (recommended for production)<\/li>\n<\/ul>\n\n
Configuration<\/h3>\n\n1. Gateway Setup<\/h4>\n\n\n- Go to FormPays Pro \u2192 Settings<\/strong><\/li>\n
- Select your preferred payment gateway<\/li>\n
- Enter your gateway credentials:\n\n
\n- Razorpay<\/strong>: Key ID, Key Secret, Webhook Secret<\/li>\n
- PayU<\/strong>: Merchant Key, Salt Key, Authorization Header<\/li>\n<\/ul><\/li>\n<\/ol>\n\n
2. Create Your First Form<\/h4>\n\n\n- Go to FormPays Pro \u2192 Forms \u2192 Add New<\/strong><\/li>\n
- Fill in form details (title, description, gateway)<\/li>\n
- Add fields (Name, Email, Mobile, Amount, etc.)<\/li>\n
- Set up conditional logic if needed<\/li>\n
- Save the form<\/li>\n<\/ol>\n\n
3. Embed the Form<\/h4>\n\n
Use the generated shortcode in any post or page:\n [formpays_pro_payment_form id=\"1\"]<\/p>\n\n
Usage<\/h3>\n\nCreating Payment Forms<\/h4>\n\n
Basic form structure:\n php\n$form_data = array(\n 'title' => 'Product Payment',\n 'description' => 'Complete your purchase',\n 'gateway' => 'razorpay',\n 'amount_type' => 'fixed',\n 'fixed_amount' => 999.00,\n 'currency' => 'INR',\n 'fields' => array(\n array(\n 'id' => 'name',\n 'label' => 'Full Name',\n 'type' => 'text',\n 'required' => true\n ),\n array(\n 'id' => 'email',\n 'label' => 'Email Address',\n 'type' => 'email',\n 'required' => true\n ),\n array(\n 'id' => 'mobile',\n 'label' => 'Mobile Number',\n 'type' => 'tel',\n 'required' => true\n )\n )\n);<\/code><\/p>\n\nConditional Logic<\/h4>\n\n`php\n<\/code><\/pre>\n\n$conditional_logic = array(\n array(\n 'field' => 'payment_type',\n 'operator' => 'equals',\n 'value' => 'business',\n 'action' => 'show',\n 'target' => 'company_name'\n )\n);\n `<\/p>\n\n
Payment Processing<\/h4>\n\n
Form submission:\n `php\nadd_action('wp_ajax_formpays_pro_submit_form', 'handle_payment');\nadd_action('wp_ajax_nopriv_formpays_pro_submit_form', 'handle_payment');<\/p>\n\n
function handle_payment() {\n \/\/ Form data is automatically processed\n \/\/ Payment gateway is initialized\n \/\/ User is redirected to payment page\n}\n `<\/p>\n\n
Webhook handling:\n php\n\/\/ Webhook endpoints are automatically created\n\/\/ \/wp-json\/formpays-pro\/v1\/webhook\/razorpay\n\/\/ \/wp-json\/formpays-pro\/v1\/webhook\/payu<\/code><\/p>\n\nTransaction Management<\/h4>\n\n
Get transaction:\n php\nglobal $formpays_pro;\n$transaction = $formpays_pro->transactions->get_transaction('TXN_123');<\/code><\/p>\n\nUpdate status:\n php\n$result = $formpays_pro->transactions->update_transaction_status(\n 'TXN_123', \n 'success'\n);<\/code><\/p>\n\nCustomization<\/h3>\n\nStyling<\/h4>\n\n
The plugin includes CSS classes for easy customization:\n css\n.formpays-pro-form-wrapper { \/* Form container *\/ }\n.formpays-pro-field { \/* Individual field *\/ }\n.formpays-pro-field-label { \/* Field labels *\/ }\n.formpays-pro-field-input { \/* Field inputs *\/ }\n.formpays-pro-submit-btn { \/* Submit button *\/ }<\/code><\/p>\n\nJavaScript Events<\/h4>\n\n`javascript\n<\/code><\/pre>\n\n\/\/ Form submission events\njQuery(document).on('formpays_pro_form_submit', function(e, formData) {\n \/\/ Custom handling before submission\n});<\/p>\n\n
\/\/ Payment success events\njQuery(document).on('formpays_pro_payment_success', function(e, response) {\n \/\/ Custom handling after successful payment\n});\n `<\/p>\n\n
Hooks and Filters<\/h4>\n\n`php\n<\/code><\/pre>\n\n\/\/ Modify form data before processing\nadd_filter('formpays_pro_form_data', 'modify_form_data', 10, 2);<\/p>\n\n
\/\/ Custom payment validation\nadd_filter('formpays_pro_validate_payment', 'custom_validation', 10, 2);<\/p>\n\n
\/\/ Modify email content\nadd_filter('formpays_pro_email_content', 'customize_email', 10, 3);\n `<\/p>\n\n
Testing<\/h3>\n\nTest Mode<\/h4>\n\n
Both Razorpay and PayU support test mode:\n1. Enable test mode in gateway settings\n2. Use test credentials from your gateway dashboard\n3. Test complete payment flow without real charges<\/p>\n\n
Test Cards<\/h4>\n\n
Razorpay:<\/strong>\n* Success: 4111 1111 1111 1111\n* Failure: 4000 0000 0000 0002<\/p>\n\nPayU:<\/strong>\n* Success: 4012 0000 0000 0000\n* Failure: 4000 0000 0000 0002<\/p>\n\nEmail Notifications<\/h3>\n\nAvailable Notifications<\/h4>\n\n\n- Payment Success - Customer<\/strong>: Confirmation email to customer with transaction details<\/li>\n
- Payment Success - Admin<\/strong>: Notification to admin about successful payment<\/li>\n
- Payment Failed - Customer<\/strong>: Failure notification with retry information<\/li>\n
- Payment Failed - Admin<\/strong>: Alert to admin about failed payment<\/li>\n<\/ul>\n\n
Email Template Customization<\/h4>\n\n\n- Go to FormPays Pro \u2192 Email Notifications<\/strong><\/li>\n
- Customize email templates with dynamic placeholders:\n\n
\n{transaction_id}<\/code> - Transaction ID<\/li>\n{amount}<\/code> - Payment amount<\/li>\n{customer_name}<\/code> - Customer name<\/li>\n{customer_email}<\/code> - Customer email<\/li>\n{payment_date}<\/code> - Payment date and time<\/li>\n{payment_method}<\/code> - Selected payment method<\/li>\n{form_title}<\/code> - Form title<\/li>\n{site_name}<\/code> - Your site name<\/li>\n<\/ul><\/li>\n- Enable\/disable individual email notifications<\/li>\n
- Test email functionality to verify settings<\/li>\n<\/ol>\n\n
Customization<\/h4>\n\n`php\n<\/code><\/pre>\n\n\/\/ Modify email templates\nadd_filter('formpays_pro_email_template', 'custom_email_template', 10, 3);<\/p>\n\n
\/\/ Add custom notification recipients\nadd_filter('formpays_pro_admin_emails', 'add_custom_emails');\n `<\/p>\n\n
Troubleshooting<\/h3>\n\nCommon Issues<\/h4>\n\n
Payment Not Processing:<\/strong>\n1. Check gateway credentials\n2. Verify webhook URLs are set correctly\n3. Check server logs for errors\n4. Ensure SSL is enabled (for live mode)<\/p>\n\nForms Not Displaying:<\/strong>\n1. Check if form is published\n2. Verify shortcode syntax\n3. Check for JavaScript conflicts\n4. Review browser console for errors<\/p>\n\nWebhook Issues:<\/strong>\n1. Verify webhook secret is correct\n2. Check webhook URL accessibility\n3. Review server logs for webhook failures\n4. Test webhook endpoint manually<\/p>\n\nDebug Mode<\/h4>\n\n
Enable WordPress debug mode for detailed error logging:\n php\n\/\/ wp-config.php\ndefine('WP_DEBUG', true);\ndefine('WP_DEBUG_LOG', true);<\/code><\/p>\n\nAPI Reference<\/h3>\n\nREST API Endpoints<\/h4>\n\n`\n<\/code><\/pre>\n\nGET \/wp-json\/formpays-pro\/v1\/forms\/{id}\nGET \/wp-json\/formpays-pro\/v1\/transactions\/{id}\nPOST \/wp-json\/formpays-pro\/v1\/webhook\/{gateway}\n `<\/p>\n\n
AJAX Actions<\/h4>\n\n`php\n<\/code><\/pre>\n\n\/\/ Form submission\nwp_ajax_formpays_pro_submit_form\nwp_ajax_nopriv_formpays_pro_submit_form<\/p>\n\n
\/\/ Admin actions\nwp_ajax_formpays_pro_save_form\nwp_ajax_formpays_pro_delete_form\nwp_ajax_formpays_pro_save_gateway_settings\n `<\/p>\n\n
Contributing<\/h3>\n\n
We welcome contributions! Please follow these steps:<\/p>\n\n
\n- Fork the repository (https:\/\/github.com\/sanyogs\/formpays-pro)<\/li>\n
- Create a feature branch<\/li>\n
- Make your changes<\/li>\n
- Add tests if applicable<\/li>\n
- Submit a pull request<\/li>\n<\/ol>\n\n
License<\/h3>\n\n
This plugin is licensed under the GPL v2 or later.<\/p>\n\n
Acknowledgments<\/h3>\n\n