الأسئلة الشائعة

الحساب والتسجيل

كم يستغرق فتح حساب؟

يستغرق التسجيل بضع دقائق. تُبلَّغ بنتيجة مراجعة KYC عند اكتمال ملفك (وثائق تسجيل الشركة، وثيقة هوية المدير، بيانات الحساب المصرفي). راجع الدمج في سيراليون (بالإنجليزية).

ما الوثائق المطلوبة في KYC؟

ثلاثة مستويات تحقق متدرجة تحدد العمليات التي يمكنك تنفيذها:

المستوى	الوثائق
1	رقم هاتف مُتحقَّق منه
2	المستوى 1 + وثيقة هوية + صورة ذاتية
3	المستوى 2 + بيانات الحساب المصرفي + إثبات عنوان

تظهر حدود كل مستوى في لوحة التحكم بعد تفعيل الحساب.

رُفض ملف KYC الخاص بي، ماذا أفعل؟

تعرض لوحة التحكم سبب الرفض. ارفع الوثائق المصححة في قسم KYC. لا توجد عقوبة ولا فترة انتظار.

الرسوم

كم تكلّف SOAMTAR؟

الرسوم والشروط التجارية مذكورة في اتفاقية التاجر الخاصة بك، ويمكن الاطلاع عليها في إعدادات لوحة التحكم.

متى أستلم أموالي؟

يعتمد موعد التسوية على قناة الدفع. يظهر الموعد الفعلي في لوحة التحكم، حيث يمكنك أيضًا ضبط حد أدنى للتسوية. تُحوَّل التسويات إلى حسابك المصرفي في سيراليون (برقم الحساب، إذ لا تستخدم سيراليون أرقام IBAN).

الجانب التقني

لماذا ينبغي أن أرسل Idempotency-Key؟

لتجنّب خصم المبلغ من العميل مرتين بعد انتهاء مهلة الشبكة. إذا لم ترسل مفتاحًا صريحًا، تشتق SOAMTAR مفتاحًا من merchant_ref الخاص بك؛ وإرسال مفتاحك الخاص يمنحك تحكمًا دقيقًا. راجع التكرار الآمن (بالإنجليزية).

بماذا يجب أن ترد نقطة استقبال الـ webhook؟

بأي رمز 2xx خلال بضع ثوانٍ. يُتجاهل جسم الاستجابة. أي رمز آخر أو انتهاء المهلة يؤدي إلى إعادة المحاولة.

كم مرة تُعاد محاولة الـ webhook؟

حتى 5 محاولات: الإرسال الأول ثم إعادة المحاولة بعد 60 ثانية و5 دقائق و30 دقيقة وساعتين. بعد عدد من الإخفاقات المتتالية، تُعلَّق نقطة الاستقبال وتصلك رسالة بريد.

كيف أعيد إرسال webhook يدويًا؟

لوحة التحكم ← Webhooks ← السجلات ← انقر على Resend في السطر.

هل يمكنني امتلاك عدة نقاط استقبال webhook؟

نعم. لكل نقطة استقبال سرّها الخاص ومرشّح أحداثها الخاص.

ماذا لو فقدت سرّ الـ webhook؟

دوّره من لوحة التحكم؛ يُعرض السرّ الجديد مرة واحدة. يمكنك أيضًا استرجاعه عبر GET/v1/webhooks/{endpoint_id}/secret باستخدام مفتاحك السرّي (محمي برمز OTP في وضع live من لوحة التحكم).

هل ترى مفاتيح الاختبار ومفاتيح live البيانات نفسها؟

لا. كل مفتاح يرى فقط كائنات وضعه: لا يمكن لمفتاح الاختبار قراءة كائن live والعكس صحيح.

هل يمكنني إعادة تشغيل معاملة من بيئة الاختبار في الإنتاج؟

لا. يمكن أن يوجد merchant_ref نفسه في البيئتين (التفرد مرتبط بالوضع)، لكن المعرّفات مختلفة.

ما تنسيق رقم الهاتف؟

E.164: ‏+232 متبوعًا بالرقم الوطني المكوّن من 8 أرقام، مثل +23276000001. بلا مسافات أو شرطات. تتطلب الدفعات الصادرة علامة + في البداية.

حالات الأعمال

كيف أستخدم صفحة دفع مستضافة بدون خادم خلفي؟

أنشئ رابط دفع من لوحة التحكم. يمكنك مشاركة الرابط مباشرة (واتساب، رسائل SMS، البريد الإلكتروني).

هل يمكن لعميل في سيراليون الدفع بالدولار أو اليورو؟

تقبل الواجهة البرمجية SLE وUSD وEUR. يحصّل Orange Money سيراليون بالليون؛ وعندما تختلف العملة المطلوبة، يُثبَّت سعر الصرف عند بدء الدفع.

كم عدد التقسيمات لكل معاملة؟

يُدعم عدة مستفيدين. لعدد كبير من المستفيدين، تواصل مع الدعم.

هل يمكنني استرداد دفعة تمت عبر Orange Money؟

نعم. استدعِ POST/v1/refunds مع transaction_id الخاص بالدفع (وamount اختياري للاسترداد الجزئي؛ بدونه يُسترد كامل المبلغ المتبقي). يُعاد المبلغ إلى رقم Orange Money الخاص بالدافع ويُخصم من رصيدك، وتصلك النتيجة عبر الـ webhooks refund.success / refund.failed. راجع الاسترداد (بالإنجليزية).

هل يمكنني تشغيل اشتراك يُدفع عبر Orange Money؟

ليس بالخصم التلقائي حاليًا: ترميز المال عبر الهاتف المحمول غير متاح. يمكن تشغيل الاشتراكات بإرسال طلب دفع إلى العميل في كل دورة فوترة.

كيف ألغي اشتراكًا؟

DELETE/v1/subscriptions/{id} (فوري) أو ?at_period_end=true (في نهاية الدورة الجارية).

الامتثال

هل SOAMTAR خاضعة للتنظيم؟

تعمل SOAMTAR في سيراليون مع Orange Money سيراليون قناةً للدفع، وتطبّق ضوابط مكافحة غسل الأموال (مراقبة المعاملات، الإبلاغ عن النشاط المشبوه). تتوفر المعلومات التنظيمية عند الطلب للتجار المؤسسيين.

هل أموال التجار محمية؟

تُتتبَّع الأموال المنتظرة للتسوية في حسابات مخصصة، منفصلة عن أموال تشغيل الشركة.

هل تخزّن SOAMTAR كلمات مرور Orange Money؟

لا. تستخدم SOAMTAR واجهة التاجر البرمجية من Orange Money ببيانات اعتماد مخصصة، ولا تستخدم أبدًا رموز PIN أو بيانات اعتماد الدافعين.

المساعدة

كيف أتواصل مع الدعم؟

• البريد الإلكتروني: support@so-amtar.com
• الدردشة في لوحة التحكم: متاحة خلال ساعات العمل (توقيت فريتاون، GMT)