README

通过Composer安装

composer require pantera-digital/yii2-alfabank-pay "@dev"

运行迁移

php yii migrate --migrationPath=@pantera/yii2/pay/alfabank/migrations

配置，添加到config/main.php

'modules' => [
    'alfabank' => [
        'class' => pantera\yii2\pay\alfabank\Module::class,
        'components' => [
            'alfabank' => [
                'class' => pantera\yii2\pay\alfabank\components\Alfabank::class,
                
                // время жизни инвойса в секундах (по умолчанию 20 минут - см. документацию Альфабанка)
                // в этом примере мы ставим время 1 неделю, т.е. в течение этого времени покупатель может
                // произвести оплату по выданной ему ссылке
                'sessionTimeoutSecs' => 60 * 60 * 24 * 7,
                
                // логин api мерчанта
                'login' => 'ваш логин',
                
                // пароль api мерчанта
                'password' => 'ваш пароль',
            ],
        ],
        
        // страница вашего сайта с информацией об успешной оплате
        'successUrl' => '/paySuccess',
        
        // страница вашего сайта с информацией о НЕуспешной оплате
        'failUrl' => '/payFail',
        
        // обработчик, вызываемый по факту успешной оплаты
        'successCallback' => function($invoice){
            // какая-то ваша логика, например
            $order = \your\models\Order::findOne($invoice->order_id);
            $client = $order->getClient();
            $client->sendEmail('Зачислена оплата по вашему заказу №' . $order->id);
            // .. и т.д.
        },

        // необязательный callback для генерации uniqid инвойса, необходим
        // в том случае, если по каким-то причинам используемый по умолчанию
        // формат `#invoice_id#-#timestamp#` вам не подходит
        'idGenerator' => function(Invoice $invoice, int $id) {
            // $id - это uniqid, сгенерированный по умолчанию
            // вместо него используем собственный алгоритм, например такой
            return '000-AAA-' . $invoice->id;
        },
    ],
]

创建订单

在您的控制器中保存订单后，或者在该订单创建的事件中，您需要创建一个发票，并将订单号和金额传递给它。

// ...здесь какая-то ваша логика по сохранению заказа, например это объект $order

// создаем и сохраняем инвойс, передаем в него номер и сумму вашего заказа
$invoice = \pantera\yii2\pay\alfabank\models\Invoice::addAlfabank($order->id, $order->price);

然后，为了将用户重定向到阿尔法银行的支付网关，您需要向用户提供一个链接（或者自动将其重定向）到url。

\yii\helpers\Html::a('Оплатить заказ', ['/alfabank/default/create', 'id' => $invoice->id /* id инвойса */])

当用户点击此链接（或自动重定向）时，将调用阿尔法银行的API以在其系统中创建发票，并重定向到阿尔法银行的支付表单。

成功支付后，用户将被重定向到yoursite.com/paySuccess。如果支付失败，用户将被重定向到yoursite.com/payFail。 paySuccess和payFail在模块设置中定义，请参阅配置示例。

发票状态

I - initial, инвойс создан
S - success, успешно оплачен

pantera-digital / yii2-alfabank-pay

维护者