1. Merchant Portal Overview

The Medref Merchant Portal allows business partners to create and manage exclusive coupons and promotional offers for Medref employees. This drives traffic to your stores while providing value to the Medref employee community.

2. Merchant Registration

New merchants can self-register at /merchant/register. The registration requires admin approval before access is granted.

Registration Steps

1. Navigate to /merchant/registerOr click "Register as Merchant" on the login page.
2. Fill in Business InformationBusiness Name (English) — Required. Business Name (Arabic) — Optional. Business Email — Used for login and notifications. Password — Minimum 8 characters.
3. Confirm PasswordRe-enter your password to confirm.
4. Click "إرسال رمز التحقق"A 6-digit OTP is sent to your email address.
5. Enter the OTPCheck your inbox and enter the verification code (valid for 10 minutes). Click Resend if needed (60-second cooldown).
6. Registration CompleteYour account is created with Pending status. The Medref admin team will review your application.
7. Receive Activation EmailOnce approved by admin, you'll receive an activation email. You can then log in normally.

3. Login

1. Go to /merchant/login
2. Enter your registered email
3. Click "إرسال رمز التحقق"An OTP is sent to your email.
4. Enter the OTPYou're now logged in to your merchant dashboard.

4. Merchant Dashboard

Your dashboard shows an overview of your merchant activity on Medref.

Widget	Description
Active Coupons	Number of currently active coupons
Active Offers	Number of live promotional offers
Total Redemptions	Coupon uses by Medref employees
Stores	Number of registered store branches

5. Coupon Management

Create and manage discount coupons for Medref employees.

Creating a Coupon

1. Go to Coupons → "إنشاء كوبون"
2. Enter Coupon CodeUnique code employees use at checkout (e.g., MEDREF20).
3. Set Coupon NameArabic and English names for display.
4. Choose Discount TypePercentage — e.g., 20% off. Fixed Amount — e.g., SAR 50 off.
5. Set Validity DatesStart Date and End Date for the coupon.
6. Set Usage LimitsTotal usage limit and per-customer limit.
7. Additional SettingsMinimum order amount, maximum discount cap, free delivery, and more.
8. SaveCoupon becomes active and visible to Medref employees.

Coupon Fields Reference

Field	Description
Code	Unique discount code (alphanumeric)
Discount Type	Percentage or Fixed Amount
Discount Value	Amount or percentage of discount
Max Discount Cap	Maximum discount in SAR (for percentage coupons)
Min Order Amount	Minimum purchase to use the coupon
Usage Limit	Total number of times the coupon can be used (0 = unlimited)
Per Customer Limit	How many times one customer can use it
Free Delivery	Include free delivery with this coupon
Category	Service category (Food, Shopping, Transport, etc.)
Start / End Date	Validity window

Archiving a Coupon

To deactivate a coupon, click the Archive button. Archived coupons are no longer visible to employees but are retained for reporting. You can reactivate them at any time.

Bulk Import

Upload multiple coupons at once via Excel. Download the template, fill in the required columns, and upload. The system validates each row and reports any errors.

6. Offers Management

Offers are promotional announcements that don't require a code — they're browsable by employees.

Creating an Offer

1. Go to Offers → "إنشاء عرض"
2. Enter TitleArabic and English titles.
3. Write DescriptionDetails about the offer (Arabic and English).
4. Set Original Price vs. Discounted PriceThe system calculates the discount percentage automatically.
5. Assign StoreLink the offer to a specific store branch (optional).
6. Set Validity DatesStart and End date for the promotion.
7. SaveThe offer is live and visible to Medref employees immediately.

7. Store Management

Register your physical store locations so employees can find you.

Adding a Store

1. Go to Stores
2. Click "إضافة فرع"
3. Enter store detailsName, city, address, phone, Google Maps link, working hours.
4. SaveThe store appears in the employee-facing loyalty section.

8. Reports & Analytics

Track the performance of your coupons and offers.

Metric	Description
Coupon Redemptions	How many times each coupon was used
Offer Views	Number of times each offer was viewed
Offer Clicks	Number of engagement clicks on offers
Top Coupons	Most-used coupons this month

9. Portal Users

Invite team members to help manage your merchant account.

1. Go to Users
2. Click "دعوة مستخدم"Enter their email, name, and role.
3. They receive an invitation emailThey click the link and set up their account.

10. Settings

Update your merchant profile, logo, and contact information from the Settings page.

Setting	Description
Business Name	Arabic and English display names
Logo	Upload your brand logo (shown on coupons and offers)
Contact Email	Public contact for Medref employees
Phone	Business phone number