واجهة برمجة تطبيقات PayPal هي واجهة تعمل كوسيط بين الخادم وبرنامج العميل. في حالتنا ، برنامج الخادم الذي يوفر واجهة برمجة التطبيقات لمطوري الطرف الثالث هو PayPal. العميل هو برنامج ينشئه المطورون استنادًا إلى PayPal API لإجراء مدفوعات على موقع ويب ، واسترداد المبيعات ، والبحث عن تفاصيل المعاملات ، وإعداد خطة فوترة ، وتخزين سجل بطاقة الائتمان بشكل آمن ، وما إلى ذلك. PayPal هي واجهة برمجة تطبيقات REST ، يستخدم طرق HTTP ليتم دمجها بسهولة في تطبيقات الويب والجوال.
كيفية الحصول على مفتاح PayPal API وبيانات الاعتماد والتوقيع
ضع في اعتبارك أن العمل مع PayPal API متاح فقط إذا كان لديك حساب PayPal Premier أو Business أو Website Payments Pro. بادئ ذي بدء ، في هذا البرنامج التعليمي ، سيتعين عليك إنشاء حساب تجاري.
قم بإنشاء حساب تجاري على PayPal
الخطوة 1. قم بالتسجيل في PayPal .
الخطوة 2. سيتعين عليك تقديم معلومات عن نفسك أولاً: اسمك الأول واسم العائلة والبريد الإلكتروني الخاص بالعمل وكلمة المرور.
الخطوة الثالثة. بعد ذلك ، يجب أن تقدم تفاصيل عن الشركة: الاسم القانوني ورقم الهاتف والعنوان.
انتبه بشكل خاص إلى حقيقة أن PayPal متاح في مقاطعات وبلدان معينة حول العالم.
هم: ألبرتا ، كولومبيا البريطانية ، مانيتوبا ، نيو برونزويك ، نيوفاوندلاند ولابرادور ، الأقاليم الشمالية الغربية ، نوفا سكوشا ، نونافوت ، أونتاريو ، جزيرة الأمير إدوارد ، كيبيك ، ساسكاتشوان ، يوكون.
إذا كان عملك لا ينتمي إلى أي من هذه المقاطعات ، فيجب عليك قراءة الأسئلة الشائعة حول PayPal للمطورين الدوليين. باختصار ، إذا كنت مطورًا غير أمريكي أو غير بريطاني ، فيمكنك استخدام واجهات برمجة تطبيقات NVP / SOAP.
الخطوة 4. علاوة على ذلك ، يجب عليك تحديد نوع عملك من الخيارات التالية: فرد ، مؤسسة فردية ، شراكة ، مؤسسة ، شركة خاصة ، شركة عامة ، منظمة غير ربحية ، كيان حكومي.
بعد ذلك ، صِف عملك بمزيد من التفصيل وأجب عن عدة أسئلة:
انقر فوق ‘إرسال”. ثم تحدث عن نفسك.
الخطوة 5. بعد ذلك ، سيتعين عليك اختيار الغرض من حساب PayPal الخاص بك. يمكنك استخدامه لطلب الأموال أو إرسالها ، أو إرسال فاتورة للعملاء أو تقديم الدفع عبر PayPal على موقع الويب. اختر إعداد المدفوعات عبر الإنترنت. أنت الآن في منتصف الطريق قبل الحصول على مفتاح PayPal الخاص بك.
احصل على بيانات اعتماد PayPal API
الخطوة 1. عندما تقوم بإنشاء حساب تجاري ، انتقل إلى صفحة مطور PayPal وقم بتسجيل الدخول إلى لوحة التحكم.
الخطوة 2. بعد تسجيل الدخول ، ستتمكن من الحصول على مفتاح PayPal API شخصي. لهذا ، انتقل إلى قسم “تطبيقاتي وبيانات الاعتماد” وانقر على “إنشاء تطبيق”
الخطوة 3. أدخل اسم التطبيق وانقر على “إنشاء” مرة أخرى. ستحصل على معرّف العميل واسم حساب Sandbox و “سر”.
احصل على توقيع أو شهادة PayPal API
خطوتنا التالية هي إنشاء بيانات اعتماد PayPal API Signature أو بيانات اعتماد شهادة API. إذا كنت مترددًا في اختيار أيهما ، فإليك شرحنا لاختلافهما:
- يتضمن PayPal API Signature اسم مستخدم API وكلمة مرور API وتوقيع لا تنتهي صلاحيته.
- تتضمن بيانات اعتماد شهادة API اسم مستخدم API في PayPal وكلمة مرور API وشهادة تنتهي صلاحيتها تلقائيًا بعد ثلاث سنوات.
ضع في اعتبارك أنه للحصول على بيانات اعتماد API في PayPal ، يجب أن يكون لديك عنوان بريد إلكتروني تم التحقق منه.
هذه هي الطريقة التي يجب أن تحصل بها على توقيع API أو بيانات اعتماد الشهادة لحساب PayPal الخاص بك:
- سجّل الدخول إلى حساب PayPal Sandbox الخاص بك ، واستخدم بيانات ملف تعريف عملك.
- انقر فوق رمز “الإعدادات”.
- انقر فوق الوصول إلى الحساب ضمن “الحساب والأمان” على يسار الصفحة.
- في قسم “الوصول إلى واجهة برمجة التطبيقات” ، انقر على “تحديث”.
- انقر فوق “إدارة بيانات اعتماد API” ضمن “تكامل NVP / SOAP API”.
- حدد أحد الخيارات التالية. طلب توقيع API – حدد لمصادقة توقيع API. طلب شهادة API – حدد مصادقة شهادة API.
- انقر فوق “موافق” و “إرسال”.
- هذا هو! بعد ذلك ، سيقوم PayPal بإنشاء بيانات اعتماد API الخاصة بك.
أمثلة على PayPal API
يقدم PayPal العديد من واجهات برمجة تطبيقات REST ويقسمها إلى ثلاث فئات:
- مباشر – تم إصدارها مؤخرًا ، وهي مدعومة بالكامل ومتاحة للمشتركين الجدد.
- إصدار محدود – واجهة برمجة تطبيقات مدعومة بالكامل ، ومتاحة في أسواق محددة.
- مهمل – واجهات برمجة تطبيقات مؤرشفة ولكنها مدعومة بالكامل.
قد تجد الأمثلة الأكثر شيوعًا أدناه.
يقدم PayPal منفذ API يسمح للمطورين باختبار المنتجات ودمجها قبل الإطلاق. استخدمه للتحقق من عمل أي منتج اخترته.
تكامل PayPal على موقع ويب
للحصول على زر PayPal على موقع ويب ، سيتعين عليك تشغيل مهام سير عمل الهندسة والأعمال في نفس الوقت.
أولاً ، قم ببناء حل API الخاص بك كما هو موضح في هذه المقالة من قبل. ثانيًا ، قم بإعداد Sandbox لاختبار المنتج (كمطور) والتقدم بطلب للحصول على حساب حقيقي. سيدمج الحساب الحقيقي جميع وظائف PayPal. ادمج واختبر المنتج الذي قمت بإنشائه. بعد كل شيء على ما يرام ، قم بتوقيع عقد للحصول على حساب حقيقي. قم بإعداد كل شيء لبدء البث المباشر ، والتحقق بشكل صحيح ، وأخيراً ، قم بتشغيل الحل المستند إلى واجهة برمجة تطبيقات PayPal!
يعد PayPal Express Checkout أحد أشهر أمثلة واجهة برمجة التطبيقات (API) والذي يستخدم طريقة تكامل NVP و SOAP. تم إهماله ، وعلى الرغم من أن PayPal لا يزال يدعمه ، فإن واجهة برمجة تطبيقات Checkout الأحدث تستخدم ميزات جديدة ومحسّنة.
حدود PayPal API والتسعير
إذا حصلت على أموال من حساب PayPal ، فيجب عليك دفع رسوم بنسبة معينة بالإضافة إلى رسوم ثابتة على أساس العملة. إذا كنت تستخدم PayPal ، فلن تضطر إلى دفع أي رسوم شهرية أو رسوم إنهاء في عام 2020. أدناه ، سترى تكلفة استخدام PayPal في العديد من البلدان: