Download the PHP package sdelfi/yii2-free-kassa without Composer
On this page you can find all versions of the php package sdelfi/yii2-free-kassa. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sdelfi/yii2-free-kassa
More information about sdelfi/yii2-free-kassa
Files in sdelfi/yii2-free-kassa
Package yii2-free-kassa
Short Description FreeKassa component for Yii2
License MIT
Homepage http://yiidreamteam.com/yii2/free-kassa
Informations about the package yii2-free-kassa
WARNING:
Only partial migration to the new API has been carried out
Free Kassa component for Yii2
Payment gateway and api client for Free Kassa service.
Installation
The preferred way to install this extension is through composer.
Either run
php composer.phar require --prefer-dist sdelfi/yii2-free-kassa "~1.0"
or add
"sdelfi/yii2-free-kassa": "~0.1"
to the require
section of your composer.json.
Usage
Component configuration
Configure freeKassa
component in the components
section of your application.
'freeKassa' => [
'class' => '\sdelfi\freekassa\Merchant',
'merchantId' => 'YOUR_MERCHANT_ID',
'merchantFormSecret' => 'SECRET_1',
'checkDataSecret' => 'SECRET_2',
'defaultCurrency' => 'RUB',
'defaultPayMethod' => 'DEFAULT_PAYMETHOD_ID',
'defaultLanguage' => 'ru' // or 'en'
],
Redirecting to the payment system
To redirect user to PerfectMoney site you need to create the page with RedirectForm widget. User will redirected right after page load.
<?= \sdelfi\freekassa\RedirectForm::widget([
'message' => 'Redirecting to payment gateway...',
'api' => Yii::$app->get('freeKassa'),
'invoiceId' => $invoice->id,
'amount' => $invoice->amount,
'description' => $invoice->description,
'email' => $invoice->owner->email
]); ?>
Gateway controller
You will need to create controller that will handle result requests from PerfectMoney service. Sample controller code:
<?php
namespace frontend\controllers;
use common\models\Invoice;
use yii\base\Event;
use yii\helpers\ArrayHelper;
use yii\helpers\VarDumper;
use yii\web\Controller;
use sdelfi\freekassa\actions\ResultAction;
use sdelfi\freekassa\events\GatewayEvent;
use sdelfi\freekassa\Merchant;
class PerfectMoneyController extends Controller
{
public $enableCsrfValidation = false;
protected $componentName = 'freeKassa';
public function init()
{
parent::init();
/** @var Api $pm */
$freeKassa = \Yii::$app->get($this->componentName);
$freeKassa->on(GatewayEvent::EVENT_PAYMENT_REQUEST, [$this, 'handlePaymentRequest']);
$freeKassa->on(GatewayEvent::EVENT_PAYMENT_SUCCESS, [$this, 'handlePaymentSuccess']);
}
public function actions()
{
return [
'result' => [
'class' => ResultAction::className(),
'componentName' => $this->componentName,
'redirectUrl' => ['/site/index'],
'sendConfirmationResponse' => true
],
'success' => [
'class' => ResultAction::className(),
'componentName' => $this->componentName,
'redirectUrl' => ['/site/index'],
'silent' => true,
'sendConfirmationResponse' => false
],
'failure' => [
'class' => ResultAction::className(),
'componentName' => $this->componentName,
'redirectUrl' => ['/site/index'],
'silent' => true,
'sendConfirmationResponse' => false
]
];
}
/**
* @param GatewayEvent $event
* @return bool
*/
public function handlePaymentRequest($event)
{
$invoice = Invoice::findOne(ArrayHelper::getValue($event->gatewayData, 'MERCHANT_ORDER_ID'));
if (!$invoice instanceof Invoice ||
$invoice->status != Invoice::STATUS_NEW ||
ArrayHelper::getValue($event->gatewayData, 'AMOUNT') != $invoice->amount ||
ArrayHelper::getValue($event->gatewayData, 'MERCHANT_ID') != \Yii::$app->get($this->componentName)->merchantId
)
return;
$invoice->debugData = VarDumper::dumpAsString($event->gatewayData);
$event->invoice = $invoice;
$event->handled = true;
}
/**
* @param GatewayEvent $event
* @return bool
*/
public function handlePaymentSuccess($event)
{
$invoice = $event->invoice;
// TODO: invoice processing goes here
}
}
Licence
MIT