yii-cms / yii2-robokassa
Robokassa payment extension.
Installs: 52 914
Dependents: 1
Suggesters: 0
Security: 0
Stars: 43
Watchers: 5
Forks: 30
Open Issues: 1
Type:yii2-extension
Requires
- yiisoft/yii2: ~2.0.14
Requires (Dev)
- phpunit/phpunit: 4.8.27|~5.7.21|^6.2
README
Установка с помощью Composer
composer require yii-cms/yii2-robokassa:dev-master*
Подключение компонента
[ 'components' => [ 'robokassa' => [ 'class' => '\robokassa\Merchant', 'baseUrl' => 'https://auth.robokassa.ru/Merchant/Index.aspx', 'storeId' => '', 'password1' => '', 'password2' => '', 'isTest' => !YII_ENV_PROD, ], // ... ], ];
Методы
/** * Перенаправление на страницу оплаты с заданными параметрами. * * @param \robokassa\PaymentOptions $options * @return \yii\web\Response */ \robokassa\Merchant::payment($options);
/** * Получение ссылки на оплату с заданными параметрами. * * @param \robokassa\PaymentOptions $options * @return string */ \robokassa\Merchant::getPaymentUrl($options);
/** * Отправляет SMS через ROBOKASSA * * @param string $phone строка, содержащая номер телефона в международном формате без символа «+» (79051234567) * @param string $message строка в кодировке UTF-8 длиной до 128 символов, содержащая текст отправляемого SMS. * @return \yii\httpclient\Response */ \robokassa\Merchant::sendSMS($phone, $message);
Примеры
Пример работы с компонентом
/** * @property integer $id * @property float $sum * @property integer $status */ class Invoice extends \yii\db\ActiveRecord { const STATUS_PENDING = 0; const STATUS_FAIL = 1; const STATUS_ACCEPTED = 9; const STATUS_SUCCESS = 10; } class PaymentController extends \yii\web\Controller { public function actionInvoice() { $model = new Invoice(); if ($model->load(Yii::$app->request->post()) && $model->save()) { /** @var \robokassa\Merchant $merchant */ $merchant = Yii::$app->get('robokassa'); return $merchant->payment(new \robokassa\PaymentOptions([ 'outSum' => 100, 'description' => 'Пополнение счета', // 'incCurrLabel' => '', 'invId' => $model->id, 'culture' => 'ru', 'encoding' => Yii::$app->charset, 'email' => Yii::$app->user->identity->email, // 'expirationDate' => '', // ISO 8601 (YYYY-MM-DDThh:mm:ss.fffffffZZZZZ) // 'outSumCurrency' => 'USD', 'userIP' => Yii::$app->request->userIP, // Дополнительные пользовательские параметры (shp_) 'params' => [ 'user_id' => 1, 'login' => 'user1', ], ])); } else { return $this->render('invoice', [ 'model' => $model, ]); } } /** * @inheritdoc */ public function actions() { return [ 'result' => [ 'class' => '\robokassa\ResultAction', 'callback' => [$this, 'resultCallback'], ], 'success' => [ 'class' => '\robokassa\SuccessAction', 'callback' => [$this, 'successCallback'], ], 'fail' => [ 'class' => '\robokassa\FailAction', 'callback' => [$this, 'failCallback'], ], ]; } /** * Переадресация пользователя при успешной оплате на SuccessURL. * Переход пользователя по данному адресу означает, что оплата Вашего заказа успешно выполнена. * Однако для дополнительной защиты желательно, чтобы факт оплаты проверялся скриптом, исполняемым при переходе на ResultURL * @param \robokassa\Merchant $merchant merchant. * @param \robokassa\actions\SuccessOptions $options * @return mixed */ public function successCallback($merchant, $options) { $model = $this->loadModel($options->invId); if (in_array($model->status, [Invoice::STATUS_ACCEPTED, Invoice::STATUS_SUCCESS])) { return $this->goBack(); } $model->updateAttributes(['status' => Invoice::STATUS_ACCEPTED]); // ... } /** * Оповещение об оплате на ResultURL * ResultURL предназначен для получения Вашим сайтом оповещения об успешном платеже в автоматическом режиме. * В случае успешного проведения оплаты ROBOKASSA делает запрос на ResultURL * Ваш скрипт работает правильно и повторное уведомление с нашей стороны не требуется. * Результат должен содержать текст OK и параметр InvId. * Например, для номера счёта 5 должен быть возвращён вот такой ответ: OK5. * @param \robokassa\Merchant $merchant merchant. * @param \robokassa\actions\ResultOptions $options * @return mixed */ public function resultCallback($merchant, $options) { $model = $this->loadModel($options->invId); $model->updateAttributes(['status' => Invoice::STATUS_SUCCESS]); return 'OK' . $options->invId; } /** * Переадресация пользователя при отказе от оплаты на FailURL * В случае отказа от исполнения платежа Покупатель перенаправляется по данному адресу. * Необходимо для того, чтобы Продавец мог, например, разблокировать заказанный товар на складе. * Переход пользователя по данному адресу, строго говоря, не означает окончательного отказа * Покупателя от оплаты, нажав кнопку «Back» в браузере он может вернуться на страницы ROBOKASSA. * @param \robokassa\Merchant $merchant merchant. * @param \robokassa\actions\FailAction $options * @return mixed */ public function failCallback($merchant, $nInvId, $nOutSum, $shp) { $model = $this->loadModel($nInvId); if ($model->status == Invoice::STATUS_PENDING) { $model->updateAttributes(['status' => Invoice::STATUS_FAIL]); } // ... } /** * @param integer $id * @return Invoice * @throws \yii\web\BadRequestHttpException */ protected function loadModel($id) { $model = Invoice::findOne($id); if ($model === null) { throw new \yii\web\BadRequestHttpException(); } return $model; } }
Пример работы для фискализации
Для фискализации receipt
лучше передавать POST запросом,
в GET запрос данные могут не поместиться
PaymentIFrame::widget() - виджет для передачи формы через IFrame ROBOKASSA
class PaymentController extends \yii\web\Controller { public function actionInvoice() { $model = new Invoice(); $model->status = Invoice::STATUS_PENDING; if ($model->load(Yii::$app->request->post()) && $model->save()) { /** @var \robokassa\Merchant $merchant */ $merchant = Yii::$app->get('merchant'); return $this->renderContent(PaymentIFrame::widget([ 'merchant' => $merchant, 'paymentOptions' => new PaymentOptions([ 'outSum' => $model->sum, 'invId' => $model->id, 'description' => 'Description', 'culture' => 'en', 'receipt' => [ 'sno' => 'osn', 'items' => [ [ 'name' => 'Название товара 1', 'quantity' => 1, 'sum' => 100, 'payment_method' => 'full_payment', 'payment_object' => 'commodity', 'tax' => 'vat10' ], [ 'name' => 'Название товара 2', 'quantity' => 3, 'sum' => 450, 'payment_method' => 'full_prepayment', 'payment_object' => 'excise', 'tax' => 'vat120', 'nomenclature_code' => '04620034587217' ], ], ], ]), ])); } return $this->render('invoice', [ 'merchant' => Yii::$app->get('merchant'), 'model' => $model, ]); } }
Представление invoice.php
<?php /* @var $this yii\web\View */ /* @var $merchant \robokassa\Merchant */ /* @var $model \app\models\Invoice */ ?> <?php $form = ActiveForm::begin(); ?> <?= $form->field($model, 'sum')->textInput() ?> <?= Html::submitButton('Pay', ['class' => 'btn btn-success']) ?> <?php ActiveForm::end(); ?>