fintech-fab/bank-emulator

Bank Emulator for e-shop and payment services

Bank Emulator

Service gateway emulates the banking system for card payments. Simple and debug web interface inside. Install and use path /bank/emulator/demo in your web project., _(*1)

• PHP SDK: http://fintech-fab.ru/bank/emulator/demo/sdk
• Public demo: http://fintech-fab.ru/bank/emulator/demo
• 3DS-auth (analogue): included
• Full debug web-form: included

Requirements

• php >=5.4.0
• Laravel Framework >=4.1
• MySQL Database
• Laravel queue driver configuration
• User auth identifier in your web project

Uses

• bootstrap cdn
• jquery cdn

Installation

Composer

Package only:, _(*2)

{
    "require": {
        "fintech-fab/bank-emulator": "dev-master"
    },
}

Package dependency:, _(*3)

{
    "require": {
        "php": ">=5.4.0",
        "laravel/framework": ">=4.1",
        "iron-io/iron_mq": "dev-master"
        "fintech-fab/bank-emulator": "dev-master"
    },
    "require-dev": {
        "phpunit/phpunit": "4.3.*@dev",
        "mockery/mockery": "dev-master"
    },
}

Run it:, _(*4)

composer update
php artisan dump-autoload

Local configuration

Add service provider to config/app.php:, _(*5)

'providers' => array(
    'FintechFab\BankEmulator\BankEmulatorServiceProvider'
)

Queue connection named 'ff-bank-em', e.g. iron:

Add to config/#env#/queue.php:, _(*6)

'connections' => array(
    'ff-bank-em' => array(
        'driver'  => 'iron',
        'project' => 'your-iron-project-id',
        'token'   => 'your-iron-token',
        'queue'   => 'your-iron-queue',
    ),
),

Run the queue worker:, _(*7)

php artisan queue:listen --queue="ff-bank-em" ff-bank-em

Database connection named 'ff-bank-em'

Add to config/#env#/database.php:, _(*8)

'connections' => array(
    'ff-bank-em'  => array(
        'driver'    => 'mysql',
        'host'      => 'your-mysql-host',
        'database'  => 'your-mysql-database',
        'username'  => 'root',
        'password'  => 'your-mysql-password',
        'charset'   => 'utf8',
        'collation' => 'utf8_unicode_ci',
        'prefix'    => 'your-table-prefix',
    ),
),

Migrations

php artisan migrate --package="fintech-fab/bank-emulator" --database="ff-bank-em"

Custom user auth identifier:

Default, user auth id detect by Auth::user()->getAuthIdentifier(). Your can set integer value (e.g. 'user_id' => 1), or use some your function with identifier return;, _(*9)

For this, publish configuration from package:, _(*10)

php artisan config:publish fintech-fab/bank-emulator

And change user auth identifier for your web project app/config/packages/fintech-fab/bank-emulator/config.php:, _(*11)

'user_id' => 'user-auth-identifier',

Optionally, external logs by loggly.com:

Add to config/#env#/app.php:, _(*12)

'logglykey' => 'your-loggly-key',
'logglytag' => 'your-loggly-tag',

Change start/global.php (Application Error Logger section):, _(*13)

Log::useFiles(storage_path() . '/logs/laravel.log');

if (Config::get('app.logglykey') && Config::get('app.logglytag')) {
    $handler = new \Monolog\Handler\LogglyHandler(Config::get('app.logglykey'), \Monolog\Logger::DEBUG);
    $handler->setTag(Config::get('app.logglytag'));
    $logger = Log::getMonolog();
    $logger->pushHandler($handler);
}

Development How to

Workbench migrations

php artisan migrate:reset --database="ff-bank-em"
php artisan migrate --bench="fintech-fab/bank-emulator" --database="ff-bank-em"

php artisan migrate:reset --database="ff-bank-em" --env="testing"
php artisan migrate --bench="fintech-fab/bank-emulator" --database="ff-bank-em" --env="testing"

Package migrations

php artisan migrate:reset --database="ff-bank-em"
php artisan migrate --package="fintech-fab/bank-emulator" --database="ff-bank-em"

php artisan migrate:reset --database="ff-bank-em" --env="testing"
php artisan migrate --package="fintech-fab/bank-emulator" --database="ff-bank-em" --env="testing"

Workbench publish

php artisan config:publish --path=workbench/fintech-fab/bank-emulator/src/config fintech-fab/bank-emulator