قبول المدفوعات

طلب الدفع#

يرسل POST /partner/stk طلب دفع إلى هاتف العميل. يوافق العميل برقمه السري على جهازه الخاص، وتصلك النتيجة عبر webhook.

دورة حياة الخصم#

استعلم عبر GET /partner/status?charge_ref=… إذا تأخر webhook، ولا تفترض النجاح أبدًا من الاستجابة pending.

منع التكرار#

قد تنتهي مهلة الشبكات. إذا لم تعرف هل أُنشئ الخصم أم لا، فأعد المحاولة بقيمة idem نفسها: ستحصل على الخصم الأصلي بدل طلب ثانٍ. استخدم مفتاحًا واحدًا لكل محاولة دفع، مثل order-9-attempt-1.

رمز QR الديناميكي (امسح لتدفع)#

يعيد POST /partner/qr صورة PNG بترميز base64 يمسحها العملاء في تطبيقهم. اعرضها على شاشة أو إيصال أو فاتورة.

{ "amount": 100, "kind": "buygoods", "recipient": "400200", "reference": "INV-1001" }

قيمة kind هي buygoods (صندوق) أو paybill أو send (إلى رقم هاتف). وتكون recipient افتراضيًا رقمك المختصر.

الصندوق والدفع برقم الفاتورة (C2B)#

يمكن للعملاء أيضًا الدفع إلى رقمك المختصر من تطبيقهم أو عبر USSD. حدد وجهة التأكيدات باستخدام POST /partner/c2b/register، وبعدها تصلك كل دفعة كحدث c2b.confirmation.

في بيئة الاختبار، حاكِ دفعة:

curl -s https://pesa-bridge.com/api/bridgepay/v1/partner/c2b/simulate \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"msisdn":"254708374149","amount":250,"bill_ref":"ACC-001"}'

الفواتير#

ينشئ Bill Manager فواتير ببنود وضرائب. اضبط "send": true لإرسال طلب دفع إلى العميل فورًا، أو أرسله لاحقًا باستخدام POST /partner/bills/send.

{
  "customer_name": "Jane Doe",
  "customer_msisdn": "254708374149",
  "tax_pct": 16,
  "send": true,
  "items": [{ "description": "Consulting", "quantity": 2, "unit_price": 5000 }]
}

طرق أخرى لتحصيل المدفوعات#