dicr/yii2-sberpay-rest

Sberbank REST API для Yii2

4.0.0 2022-01-08 18:29 UTC

Requires

• php: ~8.0
• dicr/yii2-helper: ~6.0
• dicr/yii2-json: ~3.0
• dicr/yii2-validate: ~3.0
• yiisoft/yii2: ~2.0
• yiisoft/yii2-httpclient: ~2.0

Requires (Dev)

• phpunit/phpunit: ~9.5
• roave/security-advisories: dev-latest

MIT

• Igor Tarasov

• rest
• payment
• yii2
• sberbank
• dicr
• sberpay

README

Настройка

$config = [
    'modules' => [
        'sberpay' => [
            'class' => dicr\sberpay\SberPayModule::class,
            'userName' => 'user-api',
            'password' => 'my-password',
            
            // опционально обработчик статуса платежей
            'handler' => static function(dicr\sberpay\CallbackRequest $request) {
                // сохранение статуса
            }
        ]
    ]       
];

Использование

Создание платежа

/** @var dicr\sberpay\SberPayModule $module */
$module = Yii::$app->getModule('sberpay');

/** @var dicr\sberpay\RegisterPaymentRequest $request создаем запрос */
$request = $module->registerPaymentRequest([
    'orderNumber' => '<номер заказа магазина>',
    //'amount' => 3982, // авто-вычисление
    'returnUrl' => 'https://test.ru',
    'orderBundle' => [
        'cartItems' => [
            'items' => [
                [
                    'positionId' => 1,
                    'name' => 'Русская водка',
                    'code' => 'VODKA-777',
                    'price' => 1203,
                    'quantity' => ['value' => 1.255, 'measure' => 'л'] // чекушка 1.25 литров
                    //'amount' => 1509.765 ( 1510 копеек ) авто-вычисление с округлением
                ],
                [
                    'positionId' => 2,
                    'name' => 'Пряная селедка',
                    'code' => 'СЕЛ-Д',
                    'price' => 1236, // 12.34 руб
                    'quantity' => ['value' => 2, 'measure' => 'шт'],
                    'amount' => 2472
                ],
            ]
        ]
    ]
]);

/** @var dicr\sberpay\RegisterPaymentResponse $response отправляем запрос */
$response = $request->send();

/** @var string $orderId номер заказа в системе банка */
$orderId = $response->orderId;

// переадресуем посетителя на страницу оплаты
$response->redirect();

Получение статуса платежа

/** @var dicr\sberpay\SberPayModule $module */
$module = Yii::$app->getModule('sberpay');

/** @var dicr\sberpay\OrderStatusRequest $req создаем запрос */
$req = $module->orderStatusRequest([
    'orderId' => '<номер заказа магазина>'
]);

/** @var dicr\sberpay\OrderStatusResponse $res отправляем запрос */
$res = $req->send();

/** @var int $orderStatus статус заказа */
$orderStatus = $res->orderStatus;