mpesa php api

Selamat datang di M-Pesa PHP API

Proyek ini bertujuan untuk memberikan pembungkus PHP yang mudah digunakan dan terkini untuk API M-Pesa Mozambik.

Versi target M-PESA API: V1X

Instalasi

Instal Menggunakan Komposer:

 composer require abdulmueid/mpesa

Penggunaan

1. Muat konfigurasi dari file.

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

   Lihat File Konfigurasi Sampel di Folder Contoh.

2. Buat transaksi menggunakan konfigurasi.

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

3. Jalankan operasi API dan lulus parameter yang sesuai.

   1. Memulai pengumpulan pembayaran C2B.

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

   2. Memulai pembayaran B2C.

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

   3. Memulai pembayaran B2B.

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

   4. Memulai pembalikan.

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

   5. Meminta transaksi.

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

4. Periksa respons

   Semua transaksi mengembalikan objek TransactionResponse . Objek memiliki metode publik berikut:

   1. getCode() - Mengembalikan kode respons yaitu INS-0

   2. getDescription() - Mengembalikan deskripsi.

   3. getTransactionID() - Mengembalikan ID transaksi.

   4. getConversationID() - Mengembalikan ID percakapan.

   5. getTransactionStatus() - Mengembalikan status transaksi. Hanya dihuni saat memanggil transaksi query() .

   6. getResponse() - Mengembalikan objek JSON respons penuh seperti yang diterima dari server M -PESA. Baik untuk men-debug masalah atau perilaku tidak berdokumen dari M-PESA API.

Dalam skenario khas, kode untuk memeriksa transaksi yang berhasil harus sebagai berikut:

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

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

Pengujian

Repo ini menyediakan tes unit untuk memvalidasi objek dan interaksinya dengan M-PESA.

Untuk menjalankan tes,

1. Buka file phpunit.xml dan tambahkan kredensial/parameter yang diperlukan seperti yang disediakan oleh M-PESA.
2. Jalankan phpunit
3. Periksa handset untuk petunjuk USSD untuk menyetujui transaksi pengujian.

Semua tes menggunakan 1MT sebagai jumlah pengujian.

Lisensi

Perpustakaan ini dirilis di bawah lisensi MIT. Lihat file lisensi untuk detailnya.