https://github.com/appwilio/yakassa
Платежи через Яндекс.Кассу с поддержкой 54-ФЗ
https://github.com/appwilio/yakassa
laravel-5-package payment-gateway payment-service payments yandex-kassa
Last synced: 3 days ago
JSON representation
Платежи через Яндекс.Кассу с поддержкой 54-ФЗ
- Host: GitHub
- URL: https://github.com/appwilio/yakassa
- Owner: appwilio
- License: mit
- Created: 2017-05-28T16:23:29.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-05-18T13:14:38.000Z (over 3 years ago)
- Last Synced: 2025-10-04T14:49:34.848Z (3 days ago)
- Topics: laravel-5-package, payment-gateway, payment-service, payments, yandex-kassa
- Language: PHP
- Homepage:
- Size: 33.2 KB
- Stars: 36
- Watchers: 10
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Пакет для работы с Юмани.Кассой (бывшая Яндекс.Касса)
> **Ранняя альфа, использовать осторожно!**
Возможности:
* создание платёжной формы;
* передача данных согласно 54-ФЗ;
* обработка уведомлений `checkOrder` и `paymentAviso`.
Требования:
* php >= 7.1
* Laravel >= 5.3
# Установка
```bash
composer require appwilio/yakassa
```
Подключение сервис-провайдера:
```php
// config/app.php
'providers' => [
...
Appwilio\YaKassa\YaKassaServiceProvider::class,
],
```
Настройки:
> [Описание параметров](https://tech.yandex.ru/money/doc/payment-solution/shop-config/parameters-docpage/).
```php
// config/services.php
...
'yakassa' => [
'test_mode' => env('YAKASSA_TEST_MODE', true),
'shop_id' => env('YAKASSA_SHOP_ID', ''),
'showcase_id' => env('YAKASSA_SHOWCASE_ID', ''),
'shop_password' => env('YAKASSA_SHOP_PASSWORD', ''),
],
...
```
## Подготовка основных данных для платёжной формы
Заказ должен имплементировать интерфейс `\Appwilio\YaKassa\Contracts\YaKassaOrder`:
```php
use Appwilio\YaKassa\Contracts\YaKassaOrder;
class Order implements YaKassaOrder
{
public function getOrderSum(): float
{
return $this->total;
}
public function getCustomerNumber(): string
{
return $this->customer->id;
}
public function getOrderNumber(): ?string
{
return $this->id;
}
public function getPaymentType(): ?string
{
return 'PC';
}
public function getCustomerEmail(): ?string
{
return $this->customer->email;
}
public function getCustomerPhone(): ?string
{
return $this->customer->phone;
}
}
```
### Дополнительные данные согласно требованиям 54-ФЗ
> Внимание! Протокол дополняется, текущая версия 2.1. [Общая информация](https://kassa.yandex.ru/blog/fz54-developers), [описание изменений](https://kassa.yandex.ru/docs/API_Yandex.Kassa_54FZ_changes.pdf).
Заказ должен имплементировать интерфейс `\Appwilio\YaKassa\Contracts\YaKassaOrder54FZ`:
```php
use Appwilio\YaKassa\Contracts\YaKassaOrder54FZ;
class Order implements YaKassaOrder54FZ
{
public function getOrderSum(): float
{
return $this->total;
}
public function getCustomerNumber(): string
{
return $this->customer->id;
}
public function getItems(): iterable
{
return $this->items; // товары/услуги в заказе
}
public function getTaxSystem(): ?int
{
return YaKassaOrder54FZ::TAX_OSN;
}
public function getCustomerContact(): string
{
return $this->customer->phone;
}
public function getOrderNumber(): ?string
{
return $this->id;
}
public function getPaymentType(): ?string
{
return 'PC';
}
public function getCustomerEmail(): ?string
{
return $this->customer->email;
}
public function getCustomerPhone(): ?string
{
return $this->customer->phone;
}
}
```
Каждая позиция заказа должна имплементировать интерфейс `\Appwilio\YaKassa\Contracts\YaKassaOrderItem54FZ`:
```php
use Appwilio\YaKassa\Contracts\YaKassaOrderItem54FZ;
class OrderItem implements YaKassaOrderItem54FZ
{
public function getAmount(): float
{
return $this->amount;
}
public function getQuantity(): float
{
return $this->quantity;
}
public function getTaxRate(): int
{
return YaKassaOrderItem54FZ::VAT_18;
}
public function getCurrency(): ?string
{
return null; // равнозначно RUB
}
public function getTitle(): string
{
return $this->product->title;
}
}
```
## Создание платёжной формы
В контролллере:
```php
use Appwilio\YaKassa\YaKassa;
class OrdersController
{
public function showPaymentForm(YaKassa $kassa, $orderId)
{
$order = Order::find($orderId);
$paymentForm = $kassa->buildPaymentForm($order);
return view('payment', ['form' => $paymentForm]);
}
}
```
В шаблоне:
```blade
@foreach ($form->toArray() as $k => $v)
@endforeach
...
```
## Обработка уведомлений
> [Общее описание механизма уведомлений](https://github.com/yandex-money/yandex-money-joinup/blob/master/demo/010%20интеграция%20для%20самописных%20сайтов.md#Шаг-2-Скрипты-checkurl-и-avisourl-колбеки)
```php
use Appwilio\YaKassa\YaKassa;
class YaHookController extends Controller
{
public function checkOrder(YaKassa $kassa)
{
$order = Order::find($kassa->getRequest()->getOrderNumber());
if (! $order) {
return $kassa->responseDeclined();
}
// используем реальное значение суммы заказа, а не присланное Я.Кассой
$kassa->setGenuineOrderSumAmount($order->total);
if (! $kassa->verify()) {
return $kassa->responseUnauthorized();
}
return $kassa->responseAccepted();
}
}