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 Store ID, Secret Key, and Webhook Secret
  • Admin access to install plugins
1 Download the Plugin

Download the YallaPay WooCommerce plugin from the link below:

Download Plugin

2 Install the Plugin

To install the plugin in your WordPress site:

  1. Log in to your WordPress admin dashboard
  2. Navigate to Plugins > Add New
  3. Click on the "Upload Plugin" button at the top of the page
  4. Click "Choose File" and select the downloaded zip file
  5. Click "Install Now"
  6. After installation is complete, click "Activate Plugin"
3 Configure the Plugin

After activating the plugin, you need to configure it with your YallaPay credentials:

  1. Go to WooCommerce > Settings
  2. Click on the "Payments" tab
  3. Find "YallaPay" in the list of payment methods and ensure it is enabled
  4. 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:

Settings Reference
Enable/DisableCheck this to enable YallaPay Payment
TitleThe payment method title that customers will see during checkout
Store IDEnter your YallaPay Store ID
Secret KeyEnter your YallaPay Secret Key
Webhook SecretEnter your YallaPay Webhook Secret
Return URLThe URL where customers will be redirected after payment
Webhook URLCopy this URL to your YallaPay dashboard for payment notifications

After filling in all the required information, click "Save changes" at the bottom of the page.

Important Note — Compatibility

The YallaPay plugin only supports the classic WooCommerce checkout page. It is not compatible with custom checkout solutions or block-based checkout pages.

5 Testing Your Integration

After setting up the plugin, we recommend making a test purchase to ensure everything is working correctly:

  1. Add a product to your cart
  2. Proceed to checkout
  3. Select YallaPay as your payment method
  4. Complete the checkout process

If you encounter any issues, please double-check your configuration settings and ensure all credentials are entered correctly.

You're live

Once your test purchase succeeds, your store is ready to accept real payments through YallaPay.