Description
JeelPay is a Study Now Pay Later (SNPL) payment gateway that allows your customers to split their tuition fee into interest-free installments. Integrated seamlessly with WooCommerce, JeelPay provides a modern payment solution for educational organizations.
Key Features
- Study Now Pay Later – Let customers pay interest-free installments up to 12 installments
- Seamless Integration – Works with both WooCommerce Classic and Block-based checkout
- Multiple API Support – Supports both Items API and Schooling API for educational institutions
- Real-time Status – Automatic order status updates via webhooks
- Secure Payments – HMAC-SHA256 webhook signature verification
- Sandbox Mode – Test integration before going live
- Arabic Support – Fully translated interface for Arabic-speaking customers
- Order Management – Automatic cancellation of unpaid orders after timeout
Requirements
- WordPress 5.8 or higher
- WooCommerce 5.0 or higher
- PHP 7.4 or higher
- JeelPay account (Sign up here)
- SSL certificate (HTTPS required)
Supported Countries & Currencies
- Saudi Arabia (SAR)
How It Works
- Customer selects JeelPay at checkout
- Customer is redirected to JeelPay to complete approval
- Customer returns to your website after approval
- Order is automatically completed upon payment confirmation
- Webhooks keep order status synchronized
Developer Notes
Hooks & Filters
The plugin provides several hooks for developers:
jeelpay_get_order_reference_id - Filter the order reference ID sent to JeelPay
jeelpay_get_order_by_reference_id - Filter order retrieval by reference ID
Action Scheduler
The plugin uses WooCommerce Action Scheduler for recurring tasks. View scheduled actions at:
WooCommerce > Status > Scheduled Actions > Filter by “jeelpay” group
Translation
The plugin is translation-ready. Translation files are located in /languages/.
Privacy Policy
What data is collected?
When a customer makes a payment using JeelPay, the following information is sent to JeelPay’s servers:
- Order total and items
- Customer billing information (name, email, phone)
- National ID (as entered by customer)
- Student information (if using Schooling API)
Data Retention
JeelPay transaction IDs and checkout session IDs are stored in order metadata for reconciliation purposes.
Third Party Services
This plugin connects to JeelPay’s API servers:
* Production: https://api.jeel.co
* Sandbox: https://api.sandbox.jeel.co
By using this plugin, you agree to JeelPay’s Terms of Service and Privacy Policy.
Installation
Automatic Installation
- Log in to your WordPress dashboard
- Navigate to Plugins > Add New
- Search for “JeelPay”
- Click “Install Now” and then “Activate”
Manual Installation
- Download the plugin zip file
- Log in to your WordPress dashboard
- Navigate to Plugins > Add New > Upload Plugin
- Choose the zip file and click “Install Now”
- Activate the plugin
Configuration
- Go to WooCommerce > Settings > Payments
- Click on “JeelPay”
- Enter your API credentials:
- Client ID – Provided by JeelPay
- Client Secret – Provided by JeelPay
- Entity ID – Your entity ID
- Configure other settings as needed
- Save changes
For detailed setup instructions, visit our documentation.
FAQ
-
Do I need a JeelPay account?
-
Yes, you need to sign up for a JeelPay account at jeel.co to obtain your API credentials.
-
Does this work with WooCommerce Blocks?
-
Yes! The plugin fully supports both WooCommerce Classic checkout and the modern Block-based checkout.
-
What currencies are supported?
-
Currently, only Saudi Riyal (SAR) is supported.
-
Is there a test mode?
-
Yes, the plugin includes a sandbox mode that allows you to test the integration before going live. Simply enable “Sandbox Mode” in the settings and use your sandbox credentials.
-
What happens if a customer doesn’t complete payment?
-
Orders that remain unpaid will be automatically cancelled after 4 hours. This timeout is configurable.
-
Does this support Arabic?
-
Yes, the plugin is fully translated into Arabic and includes RTL (right-to-left) support.
-
What about the Schooling API?
-
The plugin supports JeelPay’s Schooling API for educational institutions. Enable “Use Schooling API” in settings and provide the Educational Year ID.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“JeelPay for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “JeelPay for WooCommerce” 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.4 – 2026-04-01
- Added promotional banner on cart page showing JeelPay installment options
- Banner displays above “Proceed to Checkout” button when cart total qualifies
- Supports both classic and block-based WooCommerce cart
- Fixed security escaping in cart banner JavaScript
1.0.3 – 2026-03-30
- Added idempotency key support for checkout creation to prevent duplicate orders during network timeouts
- Implemented automatic retry logic with up to 10 attempts and exponential backoff
- Store transaction ID (tx_id) from API response headers for debugging
- Enhanced reliability for payment processing
1.0.2 – 2026-02-16
- Fixed HPOS compatibility issue with order meta data saving
- National ID and student fields now properly save on checkout
- Works with both official WooCommerce checkout and Elementor custom pages
- Cleaned up debug code
- Added proper nonce verification handling
1.0.1 – 2026-02-10
- Security: Added proper sanitization and validation for webhook data
- Security: Fixed escaping in inline admin scripts
- Security: Added UUID format validation for checkout IDs in webhooks
- Security: Added status validation for webhook callbacks
- Fixed order note escaping for webhook status updates
1.0.0 – 2026-01-18
- Initial release
- Items API support
- Schooling API support for educational payments
- WooCommerce Blocks integration
- Arabic translation support
- Automatic webhook verification
- Scheduled order cancellation for unpaid orders
- Sandbox mode for testing
- National ID validation
- Mobile number validation
- HPOS (High-Performance Order Storage) compatibility