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() - Возвращает код ответа, т.е. INS-0

   2. getDescription() - возвращает описание.

   3. getTransactionID() - Возвращает идентификатор транзакции.

   4. getConversationID() - Возвращает идентификатор разговора.

   5. getTransactionStatus() - Возвращает статус транзакции. Заполняется только при вызове транзакции query() .

   6. getResponse() - Возвращает полный ответ JSON объект, полученный с серверов M -PESA. Хорошо для отладки любых проблем или незарегистрированного поведения API 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 в качестве суммы теста.

Лицензия

Эта библиотека выпускается по лицензии MIT. См. Файл лицензии для получения подробной информации.