المصادقة

المفاتيح والأوضاع#

لتطبيقك مجموعتا مفاتيح. تتكون كل منهما من معرّف عام (client_id) وسر (client_secret).

مفاتيح pk_… قابلة للنشر: والمكان الوحيد المناسب لها خارج خادمك هو الحقل key في صفحة الدفع المستضافة. أما الأسرار (sk_…) فتبقى على خادمك، ولا توضع أبدًا في تطبيق أو صفحة ويب أو مستودع شيفرة.

الحصول على رمز#

POST https://pesa-bridge.com/api/bridgepay/v1/oauth/token
Content-Type: application/json

{ "client_id": "pk_test_…", "client_secret": "sk_test_…" }

{ "access_token": "at_9f3…", "token_type": "Bearer", "expires_in": 3600, "mode": "test", "sandbox": true }

أرسله في كل استدعاء آخر بالصيغة Authorization: Bearer <access_token>. خزّن الرمز مؤقتًا وأعد استخدامه حتى قبيل انتهاء صلاحيته، ولا تطلب رمزًا لكل استدعاء.

تدوير الأسرار#

يصدر POST /partner/keys/rotate سرًا جديدًا لمجموعة الاختبار أو المجموعة الحية ويلغي كل الرموز القائمة لذلك الوضع. يظهر السر الجديد مرة واحدة. انشره على خوادمك فورًا، ثم اطلب رمزًا جديدًا.

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

عامل ثانٍ لخروج الأموال#

يكفي رمز Bearer لتحصيل الأموال. أما للمدفوعات الصادرة والعكوسات فيمكنك طلب عامل ثانٍ: Initiator مع SecurityCredential. وبعد ضبطهما تُرفض تلك الاستدعاءات دونهما. راجع إرسال الأموال.

أخطاء المصادقة#