bookin/yii2-wallet-one

Component for WalletOne service

Yii2 component for WalletOne

, _(*1)

Installation

The preferred way to install this extension is through composer., _(*2)

To install, either run, _(*3)

$ php composer.phar require bookin/yii2-wallet-one "@dev"

or add, _(*4)

"bookin/yii2-wallet-one": "@dev"

to the require section of your composer.json file., _(*5)

Usage

Configure component:

'walletone'=>[
    'class'=>'bookin\walletone\WalletOne',
    'secretKey'=>'....',
    'signatureMethod'=>'sha1',
    'buttonLabel'=>'....',
    'walletOptions'=>[
        'WMI_MERCHANT_ID'=>'...',
        'WMI_CURRENCY_ID'=>'...',
        'WMI_SUCCESS_URL'=>['site/payment-success'],
        'WMI_FAIL_URL'=>['site/payment-fail'],
    ]
]

secretKey - it your secret key, you can find it on setting integration page your account, _(*6)

walletOptions - it parameters for generating a payment form, you can set permanent data, _(*7)

signatureMethod - EDS creation method, this parameter must be the same as your selected method on the setting integration page your account (default - sha1), _(*8)

buttonLabel - label for WalletOneButton, _(*9)

If you don't use encryption method, you need set signatureMethod and secretKey to NULL, _(*10)

Example show form

You can get fields (add some options), and create form:, _(*11)

$action = Yii::$app->walletone->apiUrl;
$formData = Yii::$app->walletone->getFields([
    'WMI_PAYMENT_AMOUNT'=>'1.00',
    'WMI_CURRENCY_ID'=>WalletOne::CurrencyID('UAH'),
    'WMI_DESCRIPTION'=>'Top up the account - '.Yii::$app->user->identity->username,
    'WMI_PAYMENT_NO'=>Yii::$app->user->id
]);
echo Html::beginForm($action);
foreach($formData as $key => $value){
    echo Html::hiddenInput($key, $value);
}
echo Html::submitButton('Pay', ['class'=>'btn btn-info']);
echo Html::endForm();

Or use simple form (button), _(*12)

echo WalletOneButton::widget([
    'walletOptions'=>[
        'WMI_PAYMENT_AMOUNT'=>'1.00',
        'WMI_CURRENCY_ID'=>WalletOne::CurrencyID('UAH'),
        'WMI_DESCRIPTION'=>'Top up the account - '.Yii::$app->user->identity->username,
        'WMI_PAYMENT_NO'=>Yii::$app->user->id
    ]
]);

Example success action

$post = Yii::$app->request->post();

/** @var WalletOne $walletone */
$walletone = Yii::$app->walletone;

try{
    if($walletone->checkPayment($post)){
        //... save info about payment
    }
}catch (ErrorException $c){
    return 'WMI_RESULT=RETRY&WMI_DESCRIPTION='.$c->getMessage();
}
return 'WMI_RESULT=OK';

Problems

If you enabled enableCsrfValidation for your application you should disable it manually (Yii::app()->request->enableCsrfValidation = false;) before initializing form to have the correct token., _(*13)