Moyasar Payment Integration v1.0

Accept payments on GoHighLevel using Moyasar — Saudi Arabia's leading payment gateway. Supports mada, Visa, Mastercard, Apple Pay, STC Pay, and more.

Overview

This integration connects your GoHighLevel sub-accounts to Moyasar, letting you accept online payments directly inside GHL — for one-time charges, subscriptions, free trials, and saved-card flows.

Once installed, every GHL location can configure its own Moyasar test and live API keys. Customers see a branded checkout in your funnels, order forms, calendar bookings, and invoices.

What's included

Installation

Configuration

Test vs Live mode

Each location supports both modes simultaneously. Test mode uses Moyasar's sandbox — no real money moves. Switch to live by entering live keys (sk_live_) and toggling Live mode in the app.

Multi-currency

Supported currencies — your Moyasar account must be enabled for each currency you charge in. Live-mode currency support is granted per account by Moyasar.

Payment methods

By default, customers see card payment (mada, Visa, Mastercard). Optional wallets are configured per location in the app's Settings tab.

Apple Pay & STC Pay

Apple Pay

1. In your Moyasar dashboard → Apple Pay → Add a domain. Register the domain your checkout runs on.
2. In the Moyasar GHL app → Settings → Apple Pay → toggle on, set a label (e.g. "Acme Co.").
3. Customers on Safari (iOS / macOS) will see the Apple Pay button at checkout.

STC Pay

Toggle on in Settings → STC Pay. Customer enters their STC Pay number and approves via SMS.

Subscriptions

Create recurring subscriptions in GHL — daily, weekly, monthly, yearly, or custom intervals. The customer's card is securely saved on the first charge and reused for renewals automatically.

• Renewals run automatically on the scheduled date.
• Failed renewals are retried per GHL's dunning settings.
• Customers and admins can cancel anytime from the GHL UI.

Free trials

Supported. When GHL activates a 0 SAR trial subscription, the integration records the trial without charging. When the trial period ends, GHL automatically triggers the first real charge against the saved card.

The customer must enter a valid card during trial signup so renewals can succeed. Cards added during trial are validated when the first real charge runs.

Saved cards (card-on-file)

Once a customer pays, their card is tokenized by Moyasar and saved to their GHL contact. Future charges (subscription renewals, one-click checkouts) use the stored token — no card re-entry needed.

Cards can be listed and managed per contact via GHL's payment methods UI.

Refunds

Issue refunds from GHL → Payments → Transactions. Both full and partial refunds are supported. The refund is processed instantly against Moyasar; the customer's bank usually returns funds within 5–10 business days.

Test cards

Use these in test mode to simulate scenarios. All test cards work with any future expiry date and any 3-digit CVV.

For 3D Secure flows, Moyasar's test environment will prompt with a sandbox OTP page — confirm to simulate authentication.

Webhooks Developer

The integration listens for Moyasar webhook events and forwards relevant updates to GHL:

• payment.paid — payment captured
• payment.failed — payment failed
• payment.refunded — refund completed

Webhook endpoint:

POST https://your-api-domain/webhooks/moyasar

Signature verification uses HMAC-SHA256 with your Moyasar webhook secret. Configure the webhook in your Moyasar dashboard under Developers → Webhooks.

Troubleshooting

Apple Pay button doesn't show

• Confirm you registered the domain in your Moyasar dashboard.
• Apple Pay only renders in Safari on devices with Apple Pay set up.
• Check that the domain verification file is reachable at https://your-domain/.well-known/apple-developer-merchantid-domain-association.

Payment fails with "amount must be at least 1 SAR"

Moyasar's minimum charge is 1 SAR. Free trials (0 SAR) are handled separately — the integration won't reject them.

Live currency charge fails

Test mode supports all currencies, but live mode requires Moyasar to enable each currency on your account. Contact Moyasar support to enable USD/AED/etc for live charges.

Subscription renewal fails

• Verify the customer's saved card hasn't expired.
• Check GHL's dunning settings — failed renewals retry on a schedule.
• If the card is declined, GHL notifies the customer to update payment info.

FAQ

Does this work for non-Saudi customers?

Yes. Cards from anywhere in the world work for card payments. mada cards are Saudi-only. Wallets like Apple Pay work globally; STC Pay is Saudi-only.

What fees does Moyasar charge?

Pricing is set by Moyasar — see moyasar.com/pricing. Standard mada rates differ from international cards.

Can I use one Moyasar account for multiple GHL locations?

Yes — but each location should configure its own keys. The integration scopes credentials per location.

Are payments PCI compliant?

Yes. Card details are entered in Moyasar's PCI-DSS Level 1 iframe and never reach your servers. The integration only handles tokens, never raw card data.

Does it support 3D Secure?

Yes, automatically. Moyasar handles 3DS authentication via redirect; the integration handles the return-flow and finalizes the payment.

Support

• 📧 Email: [email protected]
• 📚 Moyasar docs: docs.moyasar.com
• 🆘 GHL marketplace: open a support ticket from the app listing