smodav/ipay

iPay Africa PHP package for transaction handling

iPay Africa Web Based Integration API

, _(*1)

This is a PHP package for iPay Africa Web based integration. The API allows a merchant to initiate C2B transaction and receive payments from the customers., _(*2)

Installation

Pull in the package through Composer., _(*3)

composer require smodav/ipay

Usage

To make a request is simple. Just initiate the Cashier and finalize the transaction:, _(*4)

use SmoDav\iPay\Cashier;

require "vendor/autoload.php";

$cashier = new Cashier();

$response = $cashier
    ->usingVendorId('your vendor id', 'your vendor secret')
    ->withCallback('http://yourcallback.com')
    ->withCustomer('0722000000', 'demo@example.com', false)
    ->transact(10, 'your order id', 'your order secret');

The $response variable will hold the html response from iPay. Just render it to the page and the process would be complete., _(*5)

Payment Channels

By default, you are able to transact with multiple channels. The package default are: - MPesa - Airtel Money - Equity - Credit Card - Debit Card, _(*6)

In order to use other channels, you can call the usingChannels() method with a channel array. The currently available channels are: - Cashier::CHANNEL_MPESA - Cashier::CHANNEL_AIRTEL - Cashier::CHANNEL_EQUITY - Cashier::CHANNEL_MOBILE_BANKING - Cashier::CHANNEL_DEBIT_CARD - Cashier::CHANNEL_CREDIT_CARD - Cashier::CHANNEL_MKOPO_RAHISI - Cashier::CHANNEL_SAIDA, _(*7)

For example:, _(*8)

use SmoDav\iPay\Cashier;

require "vendor/autoload.php";

$cashier = new Cashier();

$transactChannels = [
    Cashier::CHANNEL_MPESA,
    Cashier::CHANNEL_AIRTEL,
];

$response = $cashier
    ->usingChannels($transactChannels)
    ->usingVendorId('your vendor id', 'your vendor secret')
    ->withCallback('http://yourcallback.com')
    ->withCustomer('0722000000', 'demo@example.com', false)
    ->transact(10, 'your order id', 'your order secret');

Disclaimer

The iPay API has a bug of displaying channels that have not been enabled and vice versa., _(*9)

License

The M-Pesa Package is open-sourced software licensed under the MIT license., _(*10)