البدء السريع

يتيح لك هذا الدليل قبول أولى مدفوعاتك عبر Orange Money سيراليون في نحو 10 دقائق، حتى لو لم تدمج وسيلة دفع من قبل.

متاح في: سيراليون (Orange Money، الليون — SLE). اقرأ الدمج في سيراليون (بالإنجليزية) لتفاصيل العملة وأرقام الهواتف وتجربة الدافع.

---

كيف يعمل

هكذا تنتقل الأموال من محفظة Orange Money لدى عميلك إلى حسابك:

graph LR
    A[Your website] -- 1. Customer clicks Pay --> B(SOAMTAR)
    B -- 2. Payment request on the customer's phone --> C{Orange Money}
    C -- 3. Customer confirms with their PIN --> B
    B -- 4. Signed webhook --> A

---

الخطوة 1: إنشاء حسابك (دقيقتان)

1. سجّل مجانًا في SOAMTAR Business.
2. في لوحة التحكم، انتقل إلى المطوّرون > مفاتيح API.
3. انسخ مفتاحك العام (يبدأ بـ pk_test_...). إنه يعرّف حسابك في المتصفح.

---

الخطوة 2: إضافة الزر إلى موقعك (5 دقائق)

لا حاجة إلى البرمجة: انسخ هذه الشيفرة والصقها حيث تريد أن يظهر الزر.

طريقة «النسخ واللصق» (دون كتابة JavaScript)

<!-- 1. Load the SOAMTAR library -->
<script src="https://app.so-amtar.com/sdk/soamtar.js"></script>

<!-- 2. Add the payment button -->
<button
  data-soamtar
  data-soamtar-public-key="pk_test_YOUR_KEY_HERE"
  data-soamtar-amount="50.00"
  data-soamtar-currency="SLE"
  data-soamtar-description="Purchase of my product"
  style="background: #2ecc71; color: white; padding: 15px 30px; border: none; border-radius: 5px; cursor: pointer; font-size: 18px;">
  Pay Le 50.00
</button>

نصيحة: استبدل pk_test_YOUR_KEY_HERE بالمفتاح الذي نسخته في الخطوة 1.

عندما يدفع العميل، يرسل Orange Money طلب دفع إلى هاتفه؛ ويؤكده العميل برمز PIN الخاص بـ Orange Money.

---

الخطوة 3: التحقق من أنه يعمل (3 دقائق)

بعد النقر على الزر ومحاكاة دفعة ناجحة:

1. عُد إلى لوحة تحكم SOAMTAR.
2. افتح علامة التبويب المدفوعات.
3. تظهر معاملتك بالحالة ناجحة.

---

الانتقال إلى الإنتاج

عندما تنجح اختباراتك وتريد استلام أموال حقيقية:

1. في لوحة التحكم، بدّل المفتاح أعلى اليمين إلى وضع LIVE.
2. أكمل معلومات شركتك (KYC).
3. انسخ مفتاحك الجديد pk_live_....
4. استبدل مفتاح الاختبار بمفتاح live في شيفرتك. انتهى.

قبل التبديل، راجع قائمة التحقق قبل الإطلاق (بالإنجليزية).

---

أي طريقة دمج تختار؟

إذا كنت تستخدم...	فاستخدم هذه الطريقة...
WordPress / WooCommerce	ثبّت إضافة WordPress الخاصة بنا (بدون برمجة).
موقعًا مخصصًا (HTML)	استخدم زر الدفع أعلاه.
تطبيقًا متكاملًا	استخدم حزم SDK للمطوّرين وواجهة Payments البرمجية (بالإنجليزية).

هل تحتاج إلى مساعدة؟

يساعدك مهندسونا مجانًا على دمج SOAMTAR. راسلنا عبر الدعم!