WordPress Plugin Integration
Learn how to integrate our payment gateway with your WordPress website using our dedicated plugin.
What you'll need
- A self-hosted WordPress site with WooCommerce installed
- Active YallaPay account with your Private Key (Profile page) plus Store ID and Webhook Secret (Webhooks page)
- Admin access to install plugins
1 Download the Plugin
Download the YallaPay WooCommerce plugin from the link below:
2 Install the Plugin
To install the plugin in your WordPress site:
- Log in to your WordPress admin dashboard
- Navigate to
Plugins > Add New - Click on the "Upload Plugin" button at the top of the page
- Click "Choose File" and select the downloaded zip file
- Click "Install Now"
- After installation is complete, click "Activate Plugin"
3 Configure the Plugin
After activating the plugin, you need to configure it with your YallaPay credentials:
- Go to
WooCommerce > Settings - Click on the "Payments" tab
- Find "YallaPay" in the list of payment methods and ensure it is enabled
- Click the "Manage" button next to YallaPay
4 Enter Your YallaPay Credentials
On the YallaPay settings page, you will need to fill in the following information:
| Enable/Disable | Check this to enable YallaPay |
| Title | The payment method title that customers will see during checkout |
| Private Key | Your YallaPay Private Key from the Profile page (50 characters) |
| Store ID | Your Store ID from the YallaPay Webhooks page |
| Webhook Secret | The Secret Key from your YallaPay Webhooks page |
| Webhook URL | Copy this URL into your YallaPay Webhooks page so payment notifications reach your store |
| Who pays the fee | Choose whether the merchant or the customer covers the processing fee |
| Return URL | Optional. Leave blank to use the standard order-received page |
After filling in all the required information, click "Save changes" at the bottom of the page.
5 Connect the Webhook (required)
The webhook is what confirms payments. Until it is connected, paid orders stay "Pending" in WooCommerce. Link it once:
- In the plugin settings, copy the read-only Webhook URL (it looks like
https://your-site.com/wp-json/yallapay/v1/webhook). - Open your YallaPay dashboard → Webhooks and add a store (or edit an existing one), pasting that Webhook URL.
- Copy the Store ID and Secret Key shown for that store into the plugin's Store ID and Webhook Secret fields, then save.
- Wait until the store shows Approved, then click Send Test Webhook — a successful test confirms the URL and secret are correct.
When a customer pays, they are redirected back to your order-received page and YallaPay sends a secure webhook to your store. The plugin verifies the transaction and marks the order Paid. The browser redirect alone never marks an order paid — this prevents spoofed confirmations.
The YallaPay plugin works with both the classic WooCommerce checkout and the block-based Cart/Checkout, and is compatible with High-Performance Order Storage (HPOS). Fully custom (non-WooCommerce) checkout solutions are not supported.
6 Testing Your Integration
After setting up the plugin, we recommend making a test purchase to ensure everything is working correctly:
- Add a product to your cart
- Proceed to checkout
- Select YallaPay as your payment method
- Complete the payment on the YallaPay checkout
- Confirm the order moves from "Pending" to "Processing" / "Completed" — this confirms the webhook is working
Not confirming? Open the Webhooks page in your dashboard and check the Webhook Logs for the delivery response. Also enable "Debug log" in the plugin settings and review WooCommerce → Status → Logs (source: yallapay).
Once your test purchase succeeds and the order is marked Paid, your store is ready to accept real payments through YallaPay.