zgabievi/osmp

Georgian OSMP System Payment

laravel-osmp

Some great updates are comming soon..., _(*1)

, _(*2)

OSMP
	OSMP payment system integration for Laravel 5.*. Trying to make it perfect, easy to use and awesome package :tada: Pull requests are welcome.

Table of Contents

• Installation
  • Composer
  • Laravel
• Usage
• Protocol
• Codes
• Config
• License

Installation

Composer

Run composer command in your terminal., _(*3)

composer require zgabievi/osmp

Laravel

Open config/app.php and find the providers key. Add OSMPServiceProvider to the array., _(*4)

Gabievi\OSMP\OSMPServiceProvider::class

Find the aliases key and add Facade to the array., _(*5)

'OSMP' => Gabievi\OSMP\OSMPFacade::class

Usage

Attention! You need to disable short_open_tag in your php.ini file, to use xml response;, _(*6)

Follow this url for more information: ini.short-open-tag, _(*7)

Create route in your routes.php, _(*8)

Route::get('billing', function () {
    // LISTENERS

    return OSMP::init();
})->middleware('osmp.auth');

Middleware is required if you want to make Basic Authentication, _(*9)

In place of // LISTENERS you can write osmp listeners:, _(*10)

Event::listen('osmp.*', function (...$args) {
    if ($args[0] == 'check') {
        // flash session data for check operation
        session()->flash('osmp', [
            'result' => 0,
            'data' => [
                'fullname' => 'Zura Gabievi',
                'account' => '000000'
            ]
        ]);
    } else {
        // flash session data for pay operation
        session()->flash('osmp', [
            'result' => 0,
            'data' => [
                'fullname' => 'John Doe',
                'account' => '000001'
            ]
        ]);
    }
});

Flashed session data will be used in XML response as additional information, _(*11)

You can call Response early to show some kind of error. For example:, _(*12)

return OSMP::Response(5);

This will output:, _(*13)

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <result>5</result>
    <comment>User does not exist</comment>
</response>

Protocol

This is the protocol for provider:, _(*14)

• http(s)://yoursite.com/billing/?command=check&account=000000
• http(s)://yoursite.com/billing/?command=pay&txn_id=1234567&account=000000&sum=10.45

Command: check/pay are required, _(*15)

Codes

Config

Publish OSMP config file using command:, _(*16)

php artisan vendor:publish

Created file config\osmp.php. Inside you can change configuration as you wish., _(*17)

License

laravel-osmp is licensed under a MIT License., _(*18)

TODO

• [ ] Create tests for checking funtionality
• [ ] Create separated file for response codes
• [ ] Make artisan command that will create reponse codes php file
• [ ] Make artisan command that will register routes for user
• [ ] Make OSMP object more Model like