oneafricamedia/omnipay-pesapal

Pesapal gateway for Omnipay payment processing library

Omnipay: Pesapal

Pesapal driver for the Omnipay PHP payment processing library, _(*1)

, _(*2)

Omnipay is a framework agnostic, multi-gateway payment processing library for PHP. This package implements Pesapal support for Omnipay. https://www.pesapal.com/ refer to the API docs here: http://developer.pesapal.com/, _(*3)

Install

Via Composer, _(*4)

``` bash $ composer require oneafricamedia/omnipay-pesapal, <sub>(*5)</sub>

## Basic Usage

### Get the pesapal iframe/redirect URL

``` php
use Omnipay\Omnipay;


$url = Omnipay::create('Pesapal')
    ->setCredentials(
        'your_key', 
        'your_secret'
    )
    ->setCallbackUrl('https://example.com/callback')
    ->getUrl(
        'test@example.com',
        'my_reference',
        'description',
        100
    );

Check transaction status (from the pesapal ipn)

1) configure & setup an endpoint to receive the ipn message from pesapal 2) listen for the message and use getTransactionStatus (please handle the http GET vars accordingly), <sub>(*6)</sub>

``` php use Omnipay\Omnipay;, <sub>(*7)</sub>

$status = Omnipay::create('Pesapal') ->setCredentials( 'your_key', 'your_secret' ) ->getTransactionStatus( $_GET['pesapal_notification_type'], $_GET['pesapal_transaction_tracking_id'], $_GET['pesapal_merchant_reference'] );, <sub>(*8)</sub>

``` 3) $status will be either PENDING, COMPLETED, FAILED or INVALID. Handle these statuses in your application workflow accordingly., <sub>(*9)</sub>

TODO

1) Test coverage 2) add QueryPaymentStatusByMerchantRef support 3) add QueryPaymentDetails support, <sub>(*10)</sub>