# Set up Moyasar

Every field of the Moyasar provider in the order of its form, from the state and the keys to the payment methods, the currencies, the payment journal, the messages and the button that offers it to clients.

Moyasar takes card payments, mada, Visa, Mastercard, American Express and UnionPay in a single card form, and STC Pay. This page goes through the provider's form from top to bottom; [Your first online payment](first-online-payment) shows the same provider at work.

## Before you start {#before-you-start}

- You need the **Administrator** access right on **Accounting** and the **Administrator** role on your user.
- Keep the Moyasar dashboard open: the keys and the webhook are made there.

## State and keys {#state-and-keys}

1. Open **Accounting/Configuration/Online Payments/Payment Providers** and click the **Moyasar** card.
2. Choose the **State**: **Test Mode** while you try, **Enabled** for real payments, **Disabled** to stop offering it.

![The state of the provider, Test Mode while you try it.](https://jaah.app/web/image/11468-590f7d59/online-payments-first-payment-provider_state-en.png)

3. In the **Credentials** tab, paste the **Publishable Key** (pk_), the **Secret Key** (sk_) and the **Webhook Secret Token**. Test keys go with **Test Mode** and live keys with **Enabled**; any other pairing is refused when you save, and so is a secret key pasted in the publishable field.

![The three credentials of the Moyasar account.](https://jaah.app/web/image/11548-c9239d87/online-payments-moyasar-moyasar_keys-en.png)

4. In the Moyasar dashboard, add a webhook pointing to your site's address followed by /payment/moyasar/webhook, with the same secret token. Moyasar then reports each payment even when the client closes the page before coming back.

## Payment form {#payment-form}

**Payment Methods** lists what the client can choose: **Card**, and **STCPay** once it is switched on. **Enable Payment Methods**, shown once the provider is no longer **Disabled**, opens the list of methods where you turn one on or off.

![The payment methods offered to the client, and the link that turns more on.](https://jaah.app/web/image/11552-6f990844/online-payments-moyasar-moyasar_methods-en.png)

**Allow Saving Payment Methods** (on by default) lets the client keep the card for a later payment. **Capture Amount Manually** (off by default, ticked on the demo database) decides whether a payment is taken at once or only held on the card until you capture it from the invoice; Moyasar can also capture or refund part of the amount.

![Saved cards and manual capture, two choices of the payment form.](https://jaah.app/web/image/11556-c4e4d95f/online-payments-moyasar-moyasar_capture-en.png)

## The Moyasar group {#moyasar-group}

- **Payment Form Version**: the version of Moyasar's card form, 1.7.3. Change it only when Moyasar asks.
- **Enable Multi-Currency**: Moyasar accepts Saudi riyals only, unless this is ticked; tick it only if multi-currency is active on your Moyasar account.
- **Dunning Policy**: how a failed automatic charge on a saved card is retried. Empty, the default policy applies; see [Online payment automations](online-payments-automations).

![The Moyasar group, with the form version, multi-currency and the dunning policy.](https://jaah.app/web/image/11560-8b70c950/online-payments-moyasar-moyasar_group-en.png)

## Availability {#availability}

**Maximum Amount** hides the provider above an amount (0 for no limit). **Currencies** follows **Enable Multi-Currency**. **Countries**, empty, offers the provider to clients of every country; filled, only to clients of the listed ones.

![Availability limits the provider by amount, currency and country.](https://jaah.app/web/image/11564-67e09f00/online-payments-moyasar-moyasar_availability-en.png)

## Payment journal {#payment-journal}

**Payment Journal** is the bank journal in which successful payments are recorded. It must be filled before the provider leaves **Disabled**. Journals themselves are explained in [Accounting: start here](/docs/accounting-start-here).

![The bank journal that records the payments.](https://jaah.app/web/image/11480-253e5b78/online-payments-first-payment-provider_journal-en.png)

## Messages {#messages}

The **Messages** tab holds the texts the client reads: the **Help Message** under the payment method, then the message of each outcome (pending, authorized, done, cancelled). Write them in each language your clients use.

![The messages the client reads at each stage of the payment.](https://jaah.app/web/image/11568-2cc9cb64/online-payments-moyasar-moyasar_messages-en.png)

## Publish {#publish}

The **Unpublished** button at the top of the form decides whether clients see the provider. Choosing **Enabled** publishes it and choosing **Test Mode** unpublishes it; a disabled provider cannot be published. On a phone the button sits behind the lightning icon. Click the cloud icon **Save manually** when you are done.

![The publish button; clients outside the firm see only a published provider.](https://jaah.app/web/image/11572-cb1d3d73/online-payments-moyasar-moyasar_published-en.png)

## FAQ {#faq}

### Moyasar does not appear on a client's invoice. {#not-shown}

Check, in order: the state is not **Disabled** and the provider is published; the invoice's currency is accepted (riyals only without **Enable Multi-Currency**); the client's country is in **Countries** or the list is empty; the amount is under **Maximum Amount**; and **Invoice Online Payment** is on in [Online payment settings](online-payment-settings).

### Can I try it without charging a card? {#test}

Yes. In **Test Mode** with test keys, payments go through Moyasar's test environment and its test cards.

### What happens to saved cards when I change the state? {#saved-cards}

Disabling the provider, or switching between **Test Mode** and **Enabled**, archives the cards saved with it, after a warning that says how many. The cards stay at Moyasar; they are removed there only when the client deletes them.

---

- Source: https://jaah.app/docs/online-payments/set-up-moyasar
- Updated: 2026-10-23
- Version: Online payments 19.0.1.3.0
- Verified: 2026-10-23