شارك المقالة
الدفع بـ PayPal في Flutter باستخدام flutter_paypal_payment

الدفع بـ PayPal في Flutter باستخدام flutter_paypal_payment

الدفع بـ PayPal في Flutter: تحقق من نجاح العملية في الخادم عبر بيانات PayPal.

الدفع بـ PayPal في Flutter يحتاج فصل واجهة الموافقة عن إنشاء الطلب والتحقق من التحصيل. قد تعرض حزمة flutter_paypal_payment واجهة تقبل clientSecret داخل Flutter، لكن وضع سر حساب التاجر في تطبيق موزع يعرضه للاستخراج. يوضح هذا الدرس معمارية الدمج وحدود الحزمة بدل نسخ إعداد غير مناسب للإنتاج.

دور Flutter ودور الخادم

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

فتح الموافقة والعودة

يفتح العميل الرابط ضمن تدفق تدعمه وثائق المزود للمنصة. يتحقق المثال من نطاق PayPal المتوقع وHTTPS قبل تسليم الرابط إلى دالة الفتح التي توفرها أنت. قائمة النطاقات هنا محدودة بالمثال وتحتاج مطابقة تدفق التكامل الحقيقي؛ العودة من المتصفح لا تعني أن الدفع اكتمل.

التحقق من التحصيل

بعد العودة يسأل التطبيق خادمك عن حالة السلة. ينفذ الخادم capture أو قراءة الحالة وفق تكامله، ويطابق المبلغ والعملة والطلب وملكية المستخدم. استخدم سياسة منع تكرار لإنشاء الطلب والتحصيل، وتعامل مع إشعارات المزود مع التحقق من صحتها وفق وثائقه. لا تمنح منتجًا أو اشتراكًا بناءً على callback من العميل فقط.

ما الذي يقدمه الكود؟

CheckoutBackend عقد تكامل وليس خادم دفع مكتملًا ولا استبدالًا جاهزًا لكل واجهات PayPal. تحتاج تنفيذ API وتوثيق الجلسة ومعالجة الأخطاء وانتهاء الطلب والإلغاء. اختُبر رفض نطاق شبيه وأن نتيجة النجاح تأتي من الخادم الوهمي، ولم تنفذ الاختبارات معاملة مالية حقيقية.

Sandbox والنشر

استخدم بيئة اختبار منفصلة وحساباتها التجريبية، واختبر رفض العملية وتكرار العودة وانقطاع الشبكة بعد الموافقة. لا تعطل Sandbox قبل تجهيز الخادم ومراجعة الأذونات. إذا كانت حزمة عميل لا تدعم تكاملًا يحفظ أسرار التاجر في الخادم، فاختر مسارًا تدعمه وثائق PayPal للمنصة بدل شحن السر داخل APK أو IPA.

مثال تطبيقي

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

abstract interface class CheckoutBackend {
  // Backend prices the cart, creates the provider order and checks ownership.
  Future<Uri> createApprovalUrl(String cartId);
  // Backend captures/checks the order with PayPal and returns trusted status.
  Future<bool> confirmPaid(String cartId);
}
class CheckoutFlow {
  CheckoutFlow(this.backend);
  final CheckoutBackend backend;
  Future<bool> start(String cartId, Future<void> Function(Uri) openApproval) async {
    final approval = await backend.createApprovalUrl(cartId);
    if (approval.scheme != 'https' || approval.userInfo.isNotEmpty ||
        !(approval.host == 'www.paypal.com' || approval.host == 'www.sandbox.paypal.com')) {
      throw const FormatException('Unexpected approval URL');
    }
    await openApproval(approval);
    return backend.confirmPaid(cartId);
  }
}
// Abstract integration contract, not a complete payment server or SDK.

تطبيق الدفع بـ PayPal في Flutter في مشروعك

تحقق من نجاح العملية في الخادم عبر بيانات PayPal؛ رد الواجهة وحده لا يثبت التحصيل، ولا يوضع سر الحساب داخل التطبيق.

مراجع الموضوع: pub.dev — flutter_paypal_payment، developer.paypal.com — rest

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع