Skip to main content

​
Overview

A Moyasar connection in Tirdad stores encrypted credentials so Tirdad can sync invoices to Moyasar and generate payment links for them.

​
Steps required

1

Gather credentials

Get Secret Key (required), and Webhook Secret (required) from the Moyasar Dashboard.
2

Configure webhook

Add webhook URL in Moyasar, select payment_paid, and copy the Webhook Secret.
3

Create connection

In the Tirdad dashboard (Integrations → Moyasar → Add a connection), enter your Secret Key and Webhook Secret.

​
Gather Moyasar Credentials

​
Required Credentials

​
Finding Your Credentials

1

Get API Keys

Go to Moyasar Dashboard → Settings → API Keys. Copy your Secret Key (starts with sk_). Optionally copy your Publishable Key (starts with pk_).
2

Get Webhook Secret

Go to Moyasar Dashboard → Settings → Webhooks. Create or select your webhook endpoint and copy the webhook secret (used to verify that events are from Moyasar).

​
Required Webhook Events

Configure the following events so Tirdad can update invoice status when payments occur:

​
Webhook configuration endpoint URL

In the Moyasar Dashboard, use this Tirdad webhook URL when creating your webhook.
(If you use a different Tirdad region, use the base URL for your region instead of https://api.tirdad.ai.)
Moyasar Connection Setup

​
Setting Up the Webhook

1

Open Webhooks

Go to Moyasar Dashboard → Settings → Webhooks and click + Add New Webhook.
2

Enter URL and events

Enter the Tirdad webhook endpoint URL (see Webhook configuration endpoint URL above) and select payment_paid.
3

Create and copy secret

Click Create Webhook, then copy the Webhook Secret and save it for your Tirdad connection.

​
Create Moyasar Connection

​
Using Tirdad Dashboard

1

Navigate to Integrations

Go to Tirdad dashboard → Integrations → Moyasar → Add a connection.
2

Enter credentials

Enter your Secret Key (required) and Webhook Secret (required).
3

Save connection

Click to create the connection. Tirdad will store your credentials securely.
Moyasar Connection Setup

​
Connection Configuration

​
Default Currency (required in Moyasar)

The default currency for Moyasar is SAR (Saudi Riyal).
  • Supported Currencies: SAR, USD, EUR, KWD, etc.
  • Currency Precision: Moyasar requires amounts in the smallest currency unit (e.g., Halalah for SAR). Tirdad handles this conversion automatically.

​
Currency Precision Table

​
Security Best Practices

1

HTTPS Only

Webhooks must use HTTPS.
2

Signature Verification

Always configure the webhook_secret to enable HMAC-SHA256 signature verification.
3

Key Rotation

Rotate API keys periodically from the Moyasar dashboard.

​
Troubleshooting