mpesa php api

مرحبًا بك في M-PESA PHP API

يهدف هذا المشروع إلى توفير غلاف PHP سهل الاستخدام وحديث لـ M-Pesa Mozambique API.

الإصدار المستهدف من M-PESA API: V1X

تثبيت

التثبيت باستخدام الملحن:

 composer require abdulmueid/mpesa

الاستخدام

1. قم بتحميل التكوين من الملف.

    $ config =  abdulmueid  mpesa Config:: loadFromFile ( ' /path/to/config.php ' );

   راجع عينة ملف التكوين في مجلد أمثلة.

2. إنشاء معاملة باستخدام التكوين.

    $ transaction = new  abdulmueid  mpesa  Transaction ( $ config );

3. تنفيذ عمليات API وتمرير المعلمات المناسبة.

   1. بدء جمع الدفع C2B.

       $ c2b = $ transaction -> c2b (
          float $ amount ,
          string $ msisdn ,
          string $ reference ,
          string $ third_party_reference
      );

   2. بدء الدفع B2C.

       $ b2c = $ transaction -> b2c (
          float $ amount ,
          string $ msisdn ,
          string $ reference ,
          string $ third_party_reference
      );

   3. بدء الدفع B2B.

       $ b2b = $ transaction -> b2b (
           float $ amount ,
           string $ receiver_party_code ,
           string $ reference ,
           string $ third_party_reference
      );

   4. بدء انعكاس.

       $ reversal = $ transaction -> reversal (
          float $ amount ,  
          string $ transaction_id ,
          string $ third_party_reference
      );

   5. الاستعلام عن معاملة.

       $ query = $ transaction -> query (
          string $ query_reference ,
          string $ third_party_reference
      );

4. تحقق من الاستجابة

   جميع المعاملات إرجاع كائن TransactionResponse . الكائن لديه الأساليب العامة التالية:

   1. getCode() - إرجاع رمز الاستجابة IE INS-0

   2. getDescription() - إرجاع الوصف.

   3. getTransactionID() - إرجاع معرف المعاملة.

   4. getConversationID() - إرجاع معرف المحادثة.

   5. getTransactionStatus() - إرجاع حالة المعاملة. السكان فقط عند استدعاء المعاملة query() .

   6. getResponse() - إرجاع كائن JSON الكامل استجابة كما تم استلامه من خوادم M -PESA. جيد لتصحيح أي قضايا أو سلوكيات غير موثقة في واجهة برمجة تطبيقات M-PESA.

في سيناريو نموذجي ، يجب أن يكون الكود للتحقق من المعاملات الناجحة كما يلي:

 $ c2b = $ transaction -> c2b (...);

if ( $ c2b -> getCode () === ' INS-0 ' ) {
    // Transaction Successful, Do something here
}

الاختبار

يوفر هذا الريبو اختبارات الوحدة للتحقق من صحة الكائنات وتفاعلها مع M-PESA.

لتشغيل الاختبارات ،

1. افتح ملف phpunit.xml وأضف بيانات الاعتماد/المعلمات المتطلبات كما تم توفيرها بواسطة M-PESA.
2. تشغيل phpunit
3. تحقق من الهاتف لمطالبات USSD للموافقة على معاملات الاختبار.

جميع الاختبارات تستخدم 1mt كمبلغ الاختبار.

رخصة

يتم إصدار هذه المكتبة تحت رخصة معهد ماساتشوستس للتكنولوجيا. انظر ملف الترخيص للحصول على التفاصيل.