لإضافة الدفع لتطبيقك: افتح حساب تاجر لدى بوابة دفع تدعم طرق الدفع المحلية مثل مدى وApple Pay وتابي وتمارا، واستخدم صفحة الدفع المستضافة أو الحقول الآمنة من البوابة بدل جمع بيانات البطاقة بنفسك، ثم أكّد نجاح الدفع من الخادم عبر الـ webhook قبل تأكيد الطلب، وأصدر إيصالاً أو فاتورة بالضريبة الصحيحة. في فنّان تصف ما تريد فيُبنى هذا كله وتربط حساب البوابة الخاص بك.
- كيف اربط بوابة دفع بتطبيقي
- اضافة الدفع الالكتروني للموقع
- بوابة الدفع مدى
- ربط تابي وتمارا
- كيف اضيف apple pay لتطبيقي
- بوابة دفع الكتروني بدون سجل تجاري
كيف تضيف الدفع لتطبيقك؟ الصورة الكاملة
ربط بوابة دفع بتطبيقك يمر بخمس خطوات: تختار بوابة دفع وتفتح حساب تاجر، ثم تبني صفحة دفع تعرض طرق الدفع المناسبة لعميلك، ثم تتأكد من نجاح العملية من الخادم، ثم تصدر إيصالاً أو فاتورة، ثم تجهز للاسترجاع والنزاعات. كل خطوة لها تفاصيل، لكن الفكرة بسيطة: البوابة تتعامل مع البطاقات والأموال، وتطبيقك يتعامل مع الطلب والعميل.
في الخليج تحديداً، الدفع ليس فيزا وماستركارد فقط. العميل السعودي يتوقع مدى وApple Pay، وكثيرون يقسّطون بتابي أو تمارا. في الكويت يتوقع KNET، وفي البحرين Benefit، وفي الإمارات بطاقات Visa وMastercard وApple Pay مع ظهور بطاقة جيوان المحلية. ولشرح كل طريقة بالتفصيل، اقرأ دليل الدفع المحلي.
في هذا الدليل نشرح كل خطوة بلغة بسيطة، مع الأخطاء الشائعة التي تكلّف أصحاب التطبيقات مالاً وثقة العملاء، وطلباً جاهزاً تلصقه في فنّان.
الخطوة 1: اختر بوابة الدفع وجهّز حساب التاجر
بوابة الدفع هي الشركة التي تستقبل بيانات البطاقة بأمان، وتتواصل مع البنك، وتحوّل لك الأموال. عند الاختيار، قيّم هذه النقاط:
| المعيار | لماذا يهم | سؤال تطرحه على البوابة |
|---|---|---|
| طرق الدفع المحلية | العميل يغادر إذا لم يجد طريقته | هل تدعمون مدى وApple Pay وSTC Pay وتابي وتمارا أو KNET؟ |
| متطلبات التسجيل | بعض البوابات تطلب سجلاً تجارياً | ما المستندات المطلوبة لنشاطي؟ |
| مدة التسوية | تؤثر على السيولة | متى تصل الأموال لحسابي البنكي؟ |
| الرسوم | تختلف حسب الطريقة والحجم | ما الرسوم لكل طريقة دفع، وهل توجد رسوم ثابتة؟ |
| التوثيق والدعم الفني | يحدد سهولة الربط | هل توجد بيئة اختبار ووثائق واضحة ودعم محلي؟ |
| الاسترجاع والنزاعات | تحمي علاقتك بالعميل | كيف يتم الاسترجاع الكامل والجزئي؟ |
في السعودية يكثر استخدام بوابات مثل Moyasar وTap وHyperPay وPayTabs وغيرها، وفي الإمارات Network International وTelr وCheckout.com. لمساعدتك في الاختيار، راجع أفضل بوابة دفع في السعودية وأفضل بوابة دفع في الإمارات.
الخطوة 2: صفحة الدفع، مستضافة أم مدمجة؟
هناك طريقتان شائعتان لعرض الدفع داخل تطبيقك، وكلتاهما تُبقي بيانات البطاقة بعيدة عن خادمك:
- العميل ينتقل لصفحة البوابة ثم يعود
- أسرع في الربط وأقل عبئاً أمنياً
- تحكم أقل في الشكل والتجربة
- مناسبة للبداية والنسخة الأولى
- الدفع يتم داخل صفحتك بحقول آمنة من البوابة
- تجربة أسلس وتحكم أكبر في التصميم
- يحتاج ربطاً أدق واختباراً أكثر
- مناسب عندما يكبر حجم الطلبات
وفي الحالتين، صمّم صفحة الدفع للعميل الخليجي:
- اعرض Apple Pay أولاً على أجهزة آيفون، ومدى بوضوح للبطاقات السعودية.
- اعرض خيار التقسيط بتابي أو تمارا بجانب السعر، لا مخفياً في آخر الصفحة.
- اعرض المبلغ الإجمالي شاملاً الضريبة ورسوم التوصيل قبل الضغط على زر الدفع.
- اجعل الصفحة بالعربي من اليمين لليسار، مع أرقام واضحة وعملة صحيحة.
- قلّل الحقول المطلوبة، واحفظ العنوان للطلبات القادمة.
الخطوة 3: تأكيد الدفع من الخادم بالـ webhook
هذه الخطوة هي التي يتجاهلها كثيرون، وهي سبب أغلب مشكلات الطلبات «المدفوعة» التي لم تُدفع فعلاً. عندما يعود العميل لشاشة «تم الدفع بنجاح»، فهذا لا يكفي لتأكيد الطلب، لأن العميل قد يغلق التطبيق قبل العودة، أو قد تُعدّل الشاشة. الطريقة الصحيحة أن ترسل البوابة إشعاراً مباشراً لخادمك يسمى webhook، فيتحقق الخادم منه ثم يؤكد الطلب.
- 1أنشئ الطلب بحالة «بانتظار الدفع»
قبل توجيه العميل للدفع، احفظ الطلب والمبلغ في قاعدة البيانات.
- 2أرسل العميل للدفع
عبر صفحة البوابة أو الحقول المدمجة، مع رقم الطلب كمرجع.
- 3استقبل الـ webhook
البوابة ترسل لخادمك نتيجة العملية: نجاح أو فشل أو إلغاء.
- 4تحقق من صحة الإشعار
تأكد أنه صادر فعلاً من البوابة وأن المبلغ والعملة يطابقان الطلب.
- 5حدّث حالة الطلب
حوّله إلى «مدفوع»، وأرسل التأكيد والإيصال للعميل.
- 6تعامل مع التكرار
قد يصل الإشعار نفسه أكثر من مرة؛ لا تؤكد الطلب أو ترسل الفاتورة مرتين.
الخطوة 4: الإيصالات والفواتير والضريبة
بعد نجاح الدفع، يتوقع العميل إيصالاً فورياً على البريد أو واتساب أو داخل التطبيق. وفي كثير من الحالات يلزمك إصدار فاتورة ضريبية صحيحة.
| البند | السعودية | الإمارات |
|---|---|---|
| ضريبة القيمة المضافة | 15% (هيئة الزكاة والضريبة والجمارك) | 5% (الهيئة الاتحادية للضرائب) |
| الفوترة الإلكترونية | فاتورة إلكترونية برمز QR، والربط بمنصة فاتورة على موجات | تطبيق تدريجي من 2027 عبر مزود خدمة معتمد، وB2C خارج النطاق حالياً |
| ما يحتاجه تطبيقك | حساب الضريبة وإصدار فاتورة برمز QR وأرقام متسلسلة | حساب الضريبة وإصدار فاتورة ضريبية بالبيانات المطلوبة |
فنّان يصدر فواتير إلكترونية برمز QR مع حساب الضريبة، لكن عليك التأكد من أن إعدادات منشأتك صحيحة وأنها تطابق التزاماتك.
الخطوة 5: الاسترجاع والإلغاء والنزاعات
التطبيق الذي يتعامل جيداً مع الاسترجاع يكسب ثقة العميل. جهّز هذه الأمور قبل الإطلاق:
- زر استرجاع في لوحة الإدارة يستدعي البوابة مباشرة، كاملاً أو جزئياً.
- صلاحية الاسترجاع لأدوار محددة فقط، مع سجل بمن نفّذ ومتى.
- تحديث حالة الطلب والمخزون تلقائياً بعد الاسترجاع.
- الطلبات المدفوعة بالتقسيط: تأكد من طريقة الاسترجاع مع تابي أو تمارا.
- سياسة استرجاع واضحة في التطبيق تطابق ما تطبقه فعلاً.
للتفاصيل الكاملة، اقرأ الاسترجاع والنزاعات في الخليج.
كيف يبني فنّان الدفع في تطبيقك؟
في فنّان لا تكتب كود الربط بنفسك. تصف طريقة الدفع التي تريدها، فيبني الوكيل صفحة الدفع، وحالات الطلب، واستقبال الـ webhook، والإيصالات، والفواتير، وزر الاسترجاع في لوحة الإدارة. ثم تربط حساب التاجر الخاص بك، فتصل الأموال لحسابك مباشرة.
أضف الدفع لتطبيق طلبات المطعم الذي بنيناه. أريد صفحة دفع عربية من اليمين لليسار تعرض Apple Pay أولاً على آيفون، ثم مدى وبطاقات Visa وMastercard، ثم التقسيط بتابي وتمارا للطلبات فوق حد أحدده، والدفع عند الاستلام كخيار أخير. احفظ الطلب بحالة «بانتظار الدفع» قبل التوجيه للبوابة، ولا تؤكده إلا بعد وصول webhook موثق يطابق المبلغ. لا تخزّن أي بيانات بطاقة. بعد النجاح أرسل إيصالاً على واتساب وأصدر فاتورة إلكترونية برمز QR بضريبة 15%. أضف في لوحة الإدارة زر استرجاع كامل أو جزئي للمدير فقط مع سجل للعمليات. فعّل وضع الاختبار أولاً.
جرّبه في فنّانقائمة الفحص قبل استقبال أول دفعة حقيقية
- جرّب كل طريقة دفع في وضع الاختبار، بما فيها الدفع المرفوض.
- تأكد أن الطلب لا يتأكد إلا بعد وصول الـ webhook.
- جرّب دفعة حقيقية صغيرة ثم استرجعها بالكامل.
- راجع الإيصال والفاتورة: الاسم، الضريبة، الرقم، رمز QR.
- تحقق من وصول الأموال لحسابك البنكي في المدة المتوقعة.
الخلاصة
- لا تخزّن بيانات البطاقات في تطبيقك؛ استخدم صفحة الدفع أو الحقول الآمنة التي توفرها البوابة.
- لا تؤكد الطلب من شاشة النجاح وحدها؛ أكّده بعد وصول إشعار الـ webhook من البوابة إلى الخادم.
- في الخليج، رتّب طرق الدفع حسب عميلك: مدى وApple Pay في السعودية، KNET في الكويت، Benefit في البحرين.
- الإيصال والفاتورة جزء من الدفع: ضريبة 15% في السعودية و5% في الإمارات، مع متطلبات الفوترة الإلكترونية.
- اختبر كل طريقة دفع في وضع الاختبار، ثم بمبلغ حقيقي صغير، وجرّب الاسترجاع قبل الإطلاق.
أسئلة شائعة
كيف أربط بوابة دفع بتطبيقي؟
هل أقدر أستقبل مدفوعات بدون سجل تجاري؟
كيف أضيف Apple Pay لتطبيقي أو موقعي؟
كيف أربط تابي وتمارا؟
هل يجب أن أخزن بيانات البطاقات في تطبيقي؟
اسأل مساعدك الذكي عن هذا الموضوع
انسخ هذا الطلب والصقه في مساعد الذكاء الاصطناعي الذي تستخدمه، ثم أضف تفاصيل حالتك.
أقرأ هذا الدليل: «كيف تربط بوابة دفع بتطبيقك: البوابة وصفحة الدفع والإيصالات» https://fanann.com/ar/blog/add-payments-to-your-app/ سؤالي: كيف اربط بوابة دفع بتطبيقي اعتمد على هذه الصفحة كمصدر واشرح لي الإجابة خطوة بخطوة بما يناسب حالتي، واذكر ما يجب أن أتحقق منه قبل أن أبدأ، واذكر رابط الصفحة كمرجع.