By /

Detailed Tutorial: How to Connect the Moyasar Payment Gateway with WooCommerce

Integrating the Moyasar payment gateway with WooCommerce can help you accept payments securely and efficiently on your WordPress e-commerce store. This step-by-step guide will walk you through the entire process in detail to ensure a smooth setup.

Step 1: Prerequisites

Before starting, make sure you have the following ready:

  1. WordPress Website: Ensure WordPress is installed and working properly.
  2. WooCommerce Plugin: WooCommerce must be installed and activated on your site. If not:
    • Go to Plugins > Add New in your WordPress dashboard.
    • Search for “WooCommerce” and install/activate it.
  3. Moyasar Account: Create an account on Moyasar if you don’t have one.
  4. API Keys from Moyasar:
    • Log into your Moyasar account.
    • Navigate to Settings > API Keys.
    • Copy both the Publishable Key and Secret Key — these are required for the integration.

Step 2: Installing the Moyasar Plugin

To connect Moyasar to WooCommerce, you need the Moyasar plugin:

Option 1: Install via WordPress Repository

  1. Log in to your WordPress Admin Dashboard.
  2. Go to Plugins > Add New.
  3. Search for Moyasar WooCommerce Payment Gateway.
  4. Click Install Now and then click Activate once the installation is complete.

Option 2: Install Manually

  1. Download the Moyasar plugin from their official website or GitHub repository, if available.
  2. Log in to your WordPress Admin Dashboard.
  3. Go to Plugins > Add New > Upload Plugin.
  4. Upload the plugin .zip file and click Install Now.
  5. Activate the plugin after installation.

Step 3: Configure Moyasar Payment Gateway

  1. Navigate to WooCommerce > Settings in the WordPress Admin Dashboard.
  2. Click on the Payments tab. This section lists all payment methods available for your store.
  3. Locate Moyasar Payment Gateway in the list and click Set up or Manage.

Step 4: Enter API Credentials

In the Moyasar settings page:

  1. Copy the Publishable Key and Secret Key from your Moyasar account (found under API Keys) and paste them into their respective fields.
  2. Configure additional settings:
    • Enable/Disable Test Mode: Use test mode to simulate transactions during setup without processing real payments.
    • Payment Title: Enter a title for how Moyasar appears at checkout (e.g., “Pay with Moyasar”).
    • Description: Add a short description explaining how customers can pay using Moyasar (e.g., “Secure payments via Mada and credit cards”).
  3. Click Save Changes.

Step 5: Set Up Test Mode

Before going live, it’s important to test the integration:

  1. In the Moyasar settings, enable Test Mode by ticking the checkbox.
  2. Place a dummy order on your WooCommerce store:
    • Add an item to your cart and proceed to checkout.
    • Select “Pay with Moyasar” as the payment method on the checkout page.
    • Complete the payment using test card details provided by Moyasar (refer to their documentation for sample card numbers).
  3. Verify that:
    • The order is created successfully in WooCommerce (check under Orders).
    • The transaction appears in the Moyasar dashboard under test transactions.

Step 6: Enable Live Mode

Once testing is successful:

  1. Go back to the Moyasar settings in WooCommerce.
  2. Disable Test Mode by unticking the checkbox.
  3. Save your changes.

Your store is now ready to accept live payments through Moyasar!

Step 7: Additional Customizations

Customize Checkout Experience

To improve user experience:

  • Edit the title and description of the payment method in WooCommerce settings.
  • Use translation plugins (like WPML or Loco Translate) if you need to display text in multiple languages.

Styling

If you want to customize how Moyasar appears visually, you can use custom CSS or plugins that manage WooCommerce checkout styling.

Step 8: Troubleshooting Common Issues

If you encounter any problems, here are some solutions:

  1. API Key Errors: Double-check that you’ve copied and pasted the correct Publishable Key and Secret Key from your Moyasar account.
  2. SSL Certificate Issues: Ensure your site has an active SSL certificate—payment gateways require secure connections.
  3. Plugin Compatibility: Keep both WooCommerce and the Moyasar plugin updated to avoid compatibility issues.
  4. Failed Transactions: If payments fail, check:
    • The credentials in the plugin settings.
    • Your Moyasar account dashboard for possible restrictions or errors.

FAQs

Can I Accept Mada Payments?

Yes! Moyasar supports Mada, which is widely used in Saudi Arabia. Customers can select Mada cards during checkout.

How Do I Monitor Transactions?

You can track all transactions directly from your Moyasar dashboard under “Payments.”

Is Multi-Currency Supported?

Moyasar primarily supports SAR (Saudi Riyal), but check their documentation for updates regarding multi-currency support.

Final Notes

Integrating Moyasar with WooCommerce is easy if you follow these steps carefully. After setup, regularly monitor orders and transactions to ensure everything is running smoothly.

For further assistance, refer to:

Let me know if you need help with any part of this setup!

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top