واجهة API حملة جمع التبرعات - الأسئلة المتكررة

التوّفر

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

ج: واجهة API حملة جمع التبرعات متوفرة في البلدان التي يمكن للمنظمات غير الهادفة للربح التقدم فيها للحصول على أدوات جمع التبرعات. يمكن العثور على قائمة البلدان المدعومة هنا: https://facebook.com/help/1251484118194936.

يمكنك الاطلاع على هذه الصفحة للحصول على إرشادات حول الوصول إلى واجهة API.

الاختبار

ج: جميع حملات جمع التبرعات على فيسبوك عامة، ولكن من الممكن إنشاء حملة جمع تبرعات اختبارية لا تظهر إلا لمطوري تطبيقك. للقيام بذلك، يمكنك ببساطة إنشاء حملة جمع تبرعات باستخدام وضع تطبيق "قيد التطوير". ستعرض حملات جمع التبرعات التي تم إنشاؤها بهذه الطريقة بانر في الأعلى يوضح أن حملة جمع التبرعات مرئية لمطوري التطبيقات فقط. عند تبديل تطبيقك من وضع "قيد التطوير" إلى "النشر"، ستظل حملات جمع التبرعات الاختبارية مخفية عن العامة. ستظل حملات جمع التبرعات التي يتم إنشاؤها بواسطة التطبيق في وضع "النشر" عامة حتى إذا تمت إعادة التطبيق إلى وضع "قيد التطوير".

ج: يجب أن يكون رمز وصول المستخدم في الطلب تابعًا لمستخدم فعلي على فيسبوك. يمكنك استخدام تطبيق في وضع "قيد التطوير" لإنشاء حملات جمع تبرعات اختبارية مخفية عن العامة.

ج: حملات جمع التبرعات التي يتم إنشاؤها باستخدام تطبيق منشور ستكون منشورة ومرئية للعامة بينما لا تظهر حملات جمع التبرعات المنشأة باستخدام تطبيق مطور إلا لمطوري التطبيق ومسؤوليه. يمكن لحملات جمع التبرعات في وضع النشر والتطوير تلقي التبرعات، لكن يتم إرسال Webhooks فقط عندما يكون التطبيق منشورًا.

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

ج: التطبيقات في وضع التطوير لا تتلقى حدث Webhook عند القيام بالتبرع، مما يجعل إنشاء اختبار شامل أمرًا صعبًا. لذلك، لديك خياران لاختبار Webhook: يمكنك تشغيل حدث Webhook يدويًا من لوحة معلومات المطورين لديك؛ أو يمكنك إنشاء حملة جمع تبرعات باستخدام تطبيق في وضع "قيد التطوير" (حتى لا تكون حملة جمع التبرعات عامة) ثم قم بتبديل التطبيق إلى وضع "النشر" ليتم استلام Webhook عندما تقوم بالتبرع.

إجراءات المشاركين

ج: رغم أن ذلك غير شائع، يمكن للأشخاص حذف حملتهم لجمع التبرعات على فيسبوك. عندما يحدث هذا، فإن أي استدعاء لواجهة Graph API يشير إلى حملة جمع تبرعات، سيؤدي إلى ظهور خطأ. نظرًا لأنه لا يوجد Webhook لإخبارك أنه قد تم حذف حملة جمع تبرعات في الوقت الفعلي، يمكنك التعامل مع الحذف عندما تحصل على خطأ عند محاولة قراءة حملة جمع التبرعات أو نشر تبرع خارجي جديد. لا يمكن التراجع عن حذف حملة جمع تبرعات، لذا يجب عليك التعامل مع الحذف بوصفه دائمًا. في هذه المرحلة، قد ترغب في عرض طريقة للشخص لإعادة الاتصال بفيسبوك على مركز المشاركين لإنشاء حملة جمع تبرعات جديدة على فيسبوك.

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

ج: يمكنك تحديد ما إذا كنت تريد إنهاء حملة جمع التبرعات على فيسبوك في هذه الحالات. بالنسبة لتحويلات المشاركين، يمكنك تحديث تاريخ الانتهاء من خلال API للتأكد من انتهاء حملة جمع التبرعات على فيسبوك وفقًا لتاريخ الحدث الجديد.

تبرعات فيسبوك

ج: ندعم التبرعات من قائمة محددة من الدول. يمكن العثور على قائمة كاملة بالبلدان هنا: https://facebook.com/help/837523116348786. سيرى الأشخاص الذين لا يستطيعون التبرع زر التبرع رماديًا.

ج: قد تكون هناك مشكلة في البطاقة التي يحاول المتبرع استخدامها. حاول إزالة البطاقة وإعادة إضافتها من إعدادات الدفع: https://secure.facebook.com/settings?tab=payments&section=settings.

ج: يمكنك تنزيل تقارير المعاملات من صفحة المنظمة. يمكنك العثور على مزيد من المعلومات هنا: https://facebook.com/help/1787615158233986.

ج: لا تحتوي Webhook على معلومات المتبرع، لكنها تحتوي على معرف عملية دفع يمكنك مطابقته مع بطاقات الهوية الموجودة في تقارير المعاملات.

استرداد أموال التبرع

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

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