فنك
LYDمعاملات · ادفع لي · موبي كاش

استقبل المدفوعات بالبطاقات والمحافظ عبر ربط واحد

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

وسائل الدفع المتاحة

معاملات

بطاقات مصرفية

ادفع لي

محفظة إلكترونية

موبي كاش

محفظة إلكترونية

آلية العمل

من الطلب إلى الدفع في ثلاث خطوات

كل الطلبات تصدر من خادمك، ولا تمر بيانات البطاقة ولا رموز التحقق عبر موقعك.

  1. 01

    أنشئ عملية دفع

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

    curl https://pay.fanak.ly/api/v1/payment-intents \
      -H "X-API-Key: $FANAK_API_KEY" \
      -H "Authorization: Bearer $FANAK_ACCESS_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"merchant_reference": "order-1042",
           "amount": 5000, "currency": "LYD"}'
  2. 02

    وجّه العميل إلى صفحة الدفع

    حوّل العميل إلى الرابط checkout_url، فيختار وسيلة الدفع ويُتمّ العملية على صفحة فنك.

    HTTP/1.1 303 See Other
    Location: https://pay.fanak.ly/payment-intents/
              4d893346-bd5e-482f-8347-3f509a877f1a/checkout
  3. 03

    استلم الإشعار وتحقّق من الحالة

    يصلك إشعار payment_intent.succeeded موقّعًا بمفتاح التوقيع الخاص بك. تحقّق من حالة العملية عبر الـ API، ثم سلّم الطلب.

    POST /webhooks/fanak
    Fanak-Signature: a1f2685462b2f6db115d4ff6…
    
    GET /api/v1/payment-intents/4d893346-…
    → "status": "succeeded"

البدء السريعمرجع الـ API

المزايا

كل ما تحتاجه لاستقبال المدفوعات

وسائل الدفع، وصفحة دفع جاهزة، ولوحة تحكم لفريقك، في ربط واحد. ونتولى نحن التعامل مع مزوّدي الدفع.

صفحة دفع جاهزة

صفحة لكل عملية دفع، بالعربية والإنجليزية، تعرض الوسائل التي فعّلتها. ولا يمكن تضمينها داخل مواقع أخرى، حمايةً لعملائك من الصفحات المزيّفة.

حالات واضحة يُعتمد عليها

رفض محاولة لا يُلغي الطلب، فبإمكان العميل أن يحاول مجددًا، ولا تكتمل العملية الواحدة إلا مرة واحدة.

إشعارات موقّعة ومحفوظة

كل إشعار موقّع بـ HMAC-SHA256، ويُعاد إرساله تلقائيًا لمدة يوم تقريبًا إن تعذّر وصوله، ويُحفظ مع رد خادمك لتعيد إرساله متى شئت.

لوحة تحكم لفريقك

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

  • المدفوعات
  • الإشعارات وإعادة الإرسال
  • التطبيقات والمفاتيح
  • رموز الوصول
  • حسابات الدفع
  • التحقق بخطوتين

حسابك الخاص أو حساب إيثاق

اربط حسابك لدى مزوّد الدفع لتصلك الأموال مباشرة، أو استخدم حساب إيثاق بعد موافقتها. تُشفَّر بيانات حسابك فور إدخالها، فلا يمكن حتى للوحة التحكم قراءتها.

الأمان

لا تُعتمد أي دفعة إلا بتأكيد المزوّد

قبل أن نعتبر أي دفعة ناجحة، نسأل مزوّد الدفع مباشرةً ونطابق المبلغ والمرجع.

  • الإشعار وحده لا يكفي

    إشعار المزوّد، حتى لو كان موقّعًا، لا يُثبت الدفع. نستعلم من المزوّد عن حالة العملية ونعتمد على رده فقط.

  • لا تخمين عند الغموض

    إذا لم يكن رد المزوّد واضحًا فلا نعيد المحاولة ولا نخمّن، بل نتحقق مجددًا، ثم يراجع فريق إيثاق العملية.

  • بيانات البطاقة لا تمر بنا

    يُدخل العميل بيانات بطاقته في نافذة مزوّد الدفع مباشرة، فلا تصل إلى فنك ولا إلى موقعك.

  • مفاتيح محمية

    بيانات حسابات الدفع مشفّرة بمفتاح مستقل، ومفاتيح الـ API ورموز الوصول تُحفظ بصيغة لا يمكن استرجاعها.

  • تحقق بخطوتين للجميع

    لا يدخل أحد لوحة التحكم إلا بدعوة وبالتحقق بخطوتين.

  • سجل كامل لكل عملية

    نسجّل كل خطوة في عملية الدفع: من قام بها، ومتى، ومن أين، لتسهيل حل أي خلاف. وننبّه إلى أي نشاط غير معتاد لمراجعته.

ابدأ

جرّب أولًا، ثم انطلق

  1. 01

    تواصل معنا

    نُنشئ حساب مؤسستك ونرسل لفريقك دعوات الدخول إلى لوحة التحكم.

  2. 02

    جرّب على بيئة الاختبار

    بيئة اختبار مستقلة متصلة ببيئات الاختبار لدى مزوّدي الدفع، دون أموال حقيقية.

  3. 03

    انطلق

    عندما تكون جاهزًا، انتقل إلى البيئة الفعلية بمفاتيح جديدة.

فنك

جاهز لاستقبال مدفوعاتك؟