mpesa php api

Willkommen bei M-Pesa PHP API

Dieses Projekt zielt darauf ab, einen benutzerfreundlichen und aktuellen PHP-Wrapper für die M-Pesa Mosambik-API zu liefern.

Zielversion von M-Pesa API: v1x

Installation

Installieren Sie mit Composer:

 composer require abdulmueid/mpesa

Verwendung

1. Laden Sie die Konfiguration aus der Datei.

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

   Siehe Beispielkonfigurationsdatei im Beispiel -Ordner Beispiele.

2. Erstellen Sie eine Transaktion mit der Konfiguration.

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

3. API -Operationen ausführen und entsprechende Parameter übergeben.

   1. Initiieren Sie eine C2B -Zahlungsansammlung.

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

   2. Initiieren Sie eine B2C -Zahlung.

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

   3. Initiieren Sie eine B2B -Zahlung.

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

   4. Eine Umkehrung einleiten.

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

   5. Eine Transaktion abfragen.

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

4. Antwort überprüfen

   Alle Transaktionen geben das TransactionResponse -Objekt zurück. Das Objekt hat die folgenden öffentlichen Methoden:

   1. getCode() - Gibt den Antwortcode IE INS-0 zurück

   2. getDescription() - Gibt die Beschreibung zurück.

   3. getTransactionID() - Gibt die Transaktions -ID zurück.

   4. getConversationID() - Gibt die Konversations -ID zurück.

   5. getTransactionStatus() - Gibt den Transaktionsstatus zurück. Nur beim Aufrufen der Transaktion query() besiedelt.

   6. getResponse() - Gibt das vollständige Antwort -JSON -Objekt zurück, das von M -PESA -Servern empfangen wird. Gut für Probleme oder undokumentierte Verhaltensweisen der M-Pesa-API.

In einem typischen Szenario sollte der Code für erfolgreiche Transaktionen wie folgt sein:

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

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

Testen

Dieses Repo bietet Unit-Tests, um die Objekte und ihre Interaktion mit M-PESA zu validieren.

Tests ausführen,,

1. Öffnen Sie die Datei phpunit.xml und fügen Sie die von M-Pesa gelieferten Anmeldeinformationen/Parameter hinzu.
2. phpunit ausführen
3. Überprüfen Sie das Mobilteil für USSD -Eingabeaufforderungen, um Testtransaktionen zu genehmigen.

Alle Tests verwenden 1MT als Testbetrag.

Lizenz

Diese Bibliothek wird unter der MIT -Lizenz veröffentlicht. Weitere Informationen finden Sie unter Lizenzdatei.