PesaBridge
التوثيق/الأموال الصادرة/إرسال الأموال (المدفوعات الصادرة)

الأموال الصادرة

إرسال الأموال (المدفوعات الصادرة)

ادفع للعملاء والشركات والجهات الضريبية من حساب التسوية لديك، مع عامل ثانٍ اختياري ونتائج غير متزامنة.

6 دقائق قراءة

في هذه الصفحة
  1. موّل حساب التسوية
  2. أنواع المدفوعات الصادرة
  3. العامل الثاني: Initiator وSecurityCredential
  4. متزامن أو غير متزامن

موّل حساب التسوية

تخرج المدفوعات الصادرة من حساب التسوية لديك. موّله باستخدام POST /partner/topup ({"amount": 100000}) وتحقق منه باستخدام GET /partner/balance.

أنواع المدفوعات الصادرة

نقطة النهايةيدفع إلىالحقول الرئيسية
POST /partner/b2cمحفظة عميلto_msisdn, amount, remarks
POST /partner/bizpocketBiz Pocket لعميلto_msisdn, amount, remarks
POST /partner/b2bشركة أخرىto_shortcode, amount, account_reference
POST /partner/taxالضرائب أو جهة حكوميةto_shortcode, amount, prn

يقبل كل منها مفتاح idem. أعد المحاولة بالمفتاح نفسه بعد انتهاء المهلة وستحصل على الدفعة الأصلية، لا دفعة ثانية أبدًا.

Shell
curl -s https://pesa-bridge.com/api/bridgepay/v1/partner/b2c \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"to_msisdn":"254708374149","amount":2500,"remarks":"Refund #91","idem":"refund-91"}'

العامل الثاني: Initiator وSecurityCredential

احمِ استدعاءات خروج الأموال بعامل ثانٍ. عيّن كلمة مرور للمُبادِر مرة واحدة باستخدام POST /partner/initiator. ومن بعدها يجب أن تحمل المدفوعات الصادرة والعكوسات initiator وsecurity_credential: وهو كلمة المرور تلك مشفرة بـ RSA (PKCS#1 v1.5) بشهادتنا ومرمزة بـ base64.

  1. 1

    نزّل الشهادة

    يعيد GET /security/certificate شهادتنا العامة X.509 بصيغة PEM.

  2. 2

    شفّر من جهتك

    شفّر كلمة مرور المُبادِر بها. لا تنتقل كلمة المرور نصًا صريحًا أبدًا.

  3. 3

    أرسل الحقلين

    أضف initiator وsecurity_credential إلى كل دفعة صادرة أو عكس.

إنشاء SecurityCredential
curl -s https://pesa-bridge.com/api/bridgepay/v1/security/certificate -o pesabridge.pem
openssl x509 -in pesabridge.pem -pubkey -noout > pesabridge_pub.pem
printf '%s' "$INITIATOR_PASSWORD" \
  | openssl pkeyutl -encrypt -pubin -inkey pesabridge_pub.pem -pkeyopt rsa_padding_mode:pkcs1 \
  | base64 -w0
في بيئة الاختبار، يمكن لـ POST /security/credential تشفير كلمة مرور اختبارية لك. أما في الإنتاج فشفّر دائمًا على خادمك الخاص.

متزامن أو غير متزامن

بدون result_url، تجيب الدفعة عند اكتمالها. ومع result_url (واختياريًا timeout_url) تحصل على إشعار استلام فوري، ويُرسل Result النهائي إلى ذلك العنوان بطريقة POST، موقعًا مثل أي webhook، فتحقق منه بالطريقة نفسها.

السابقصفحة الدفع المستضافة وروابط الدفعالتالي Webhooks

يجيب مهندسونا عن أسئلة الربط. أرسل إلينا مرجع الطلب وسنجد الاستدعاء بالضبط.

تواصل مع الدعم