> For the complete documentation index, see [llms.txt](https://partners.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://partners.botpenguin.com/partner-platform-guidelines/integration/setup-moyasar-payment-gateway.md).

# Setup Moyasar Payment Gateway

#### What is Moyasar?

Moyasar is a payment gateway that enables businesses to accept online payments securely through cards, Apple Pay, Mada, STC Pay, and other supported payment methods. Integrating Moyasar with the Agency Panel allows seamless payment processing and subscription billing between your BotPenguin Agency and your Moyasar account.

***

#### Benefits of Moyasar Integration

* 💳 Accept payments securely through multiple payment methods.
* ⚙️ Automate customer subscription purchases and billing workflows.
* 🌐 Support regional payment methods such as Mada, Apple Pay, and STC Pay.
* 📊 Centralize payment collection and revenue management.
* 🧩 Enable scalable monetization through a trusted payment gateway.

***

#### How to Use Moyasar Integration

Follow the steps below to configure Moyasar as your payment gateway in the BotPenguin Agency Panel.

***

### A. Connecting Moyasar from Agency Panel

1. Go to your **Agency Panel** and click on **Integration** from the left menu.
2. Select **Integrations** and either search for **Moyasar** or locate it in the integrations list.

<figure><img src="/files/bF1Kc0g4TtQiL2qS8uDS" alt=""><figcaption></figcaption></figure>

3. Click on **Connect** to begin the setup process.
4. You will see input fields requesting your **Public Key** and **Secret Key**, which must be obtained from your Moyasar account.

<figure><img src="/files/5e9VvMarGh56qvxw0JqQ" alt=""><figcaption></figcaption></figure>

***

### B. Setting Up Moyasar

1. Visit the Moyasar website and sign in to your account.
2. If you do not already have a Moyasar account, complete the account registration and onboarding process.
3. From the Moyasar Dashboard, navigate to **Settings**.
4. Open the **API Keys** section.
5. Locate the following credentials:
   * **Publishable Key (Public Key)**
   * **Secret Key**
6. Copy both keys and store them securely.
7. Keep these credentials available for the BotPenguin integration setup.

{% hint style="warning" %}
Never share your Secret Key publicly. It should be treated like a password and used only in secure backend systems.
{% endhint %}

***

### C. Finalizing Integration in BotPenguin

1. Return to **Agency Panel → Integrations → Moyasar**.
2. Enter the following credentials:
   * **Public Key**
   * **Secret Key**
3. Click **Connect**.
4. Once the connection is successful, Moyasar will appear as an active integration.

***

### D. Configuring Customer Plans for Moyasar Payments

1. Go to **Customer Plans → Configurations**.
2. Expand the **Currency and Payments** section.
3. Select the currency supported by your Moyasar account.
4. Choose **Moyasar** as the **Payment Gateway**.
5. Save the configuration.

Your customers can now use Moyasar to complete payments during checkout.

***

### Troubleshooting

<details>

<summary><strong>Public Key not accepted in BotPenguin</strong></summary>

**Likely Cause:**\
The key was copied incorrectly or incompletely.

**Solution:**\
Copy the Publishable Key again from the Moyasar Dashboard and paste it carefully into BotPenguin.

</details>

<details>

<summary><strong>Secret Key not accepted</strong></summary>

**Likely Cause:**\
The Secret Key is invalid or incomplete.

**Solution:**\
Verify that the entire Secret Key has been copied correctly without any missing characters or spaces.

</details>

<details>

<summary><strong>Payments fail after integration</strong></summary>

**Likely Cause:**\
The Moyasar account has not been fully activated.

**Solution:**\
Complete any pending account verification or activation requirements within Moyasar.

</details>

<details>

<summary><strong>Unable to locate API Keys</strong></summary>

**Likely Cause:**\
The account does not have sufficient permissions.

**Solution:**\
Ensure you are logged in using an administrator account with access to API settings.

</details>

<details>

<summary><strong>Moyasar not appearing in Customer Plans</strong></summary>

**Likely Cause:**\
The integration setup was not completed successfully.

**Solution:**\
Reconnect Moyasar and verify that both the Public Key and Secret Key were entered correctly.

</details>

<details>

<summary><strong>Integration shows as disconnected</strong></summary>

**Likely Cause:**\
Invalid credentials or a session timeout occurred.

**Solution:**\
Re-enter the Public Key and Secret Key and reconnect the integration.

</details>

<details>

<summary><strong>Live payments are failing</strong></summary>

**Likely Cause:**\
Test credentials are being used instead of production credentials.

**Solution:**\
Ensure that you are using the correct live credentials from your Moyasar account.

</details>

{% hint style="info" %}
Before launching to customers, perform a test transaction to confirm that payments are being processed correctly.
{% endhint %}

***

### Moyasar FAQs

<details>

<summary><strong>Do I need a Moyasar account to use this integration?</strong></summary>

Yes. You must have an active Moyasar account to obtain the API credentials required for integration.

</details>

<details>

<summary><strong>Where can I find my Moyasar API keys?</strong></summary>

You can find your Publishable Key and Secret Key under the **API Keys** section within your Moyasar Dashboard.

</details>

<details>

<summary><strong>What is the difference between the Public Key and Secret Key?</strong></summary>

The Public Key is used for client-side payment operations, while the Secret Key is used for secure server-side communication and should never be shared publicly.

</details>

<details>

<summary><strong>Can I regenerate my API keys?</strong></summary>

Yes. Moyasar allows you to generate new API credentials. If you regenerate your keys, you must update them in BotPenguin to maintain the integration.

</details>

<details>

<summary><strong>Why are my payments failing even though the integration is connected?</strong></summary>

Ensure your Moyasar account is fully activated, your credentials are valid, and your payment methods have been configured correctly.

</details>

<details>

<summary><strong>Can I disconnect Moyasar later?</strong></summary>

Yes. You can disconnect Moyasar at any time from the Integrations section of your Agency Panel.

</details>

<details>

<summary><strong>Will disconnecting Moyasar affect existing customer data?</strong></summary>

No. Disconnecting the payment gateway will stop future payment processing through Moyasar, but existing customer records within BotPenguin will remain unaffected.

</details>

***

If you still have questions for our team, write to us at **<support@botpenguin.com>**. We'll get back to you within 48 hours.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://partners.botpenguin.com/partner-platform-guidelines/integration/setup-moyasar-payment-gateway.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.