... {toc:maxLevel=3}
h2. Заключите договор с ЮKassa и настройте ссылку на callback биллинга в их личном кабинете.
Заключите договор с платежной системой [ЮKassa|https://yookassa.ru].
Выполните настройки подключения, которые производятся через *главную страницу веб-интерфейса администратора* \-> *Платежные системы*\-> *Настройка ЮKassa*
{code}
Настройки по адресу: http://<billing_ip>:8081/settings/asr_fiscal/yookassa/
{code}
На странице https://yookassa.ru/my/merchant/integration/http-notifications разместите ссылку на callback в поле "URL для уведомлений".
!callbackyookassa.png|border=0,width=800!
{code}
https://<billing_ip>:8443/yookassa.php
{code}
или
{code}
https://<billing_ip>:443/yookassa.php
{code}
Запросите ip адреса с которых платежная система будет обращаться к биллингу.
h5. Отключите "Режим проверки чеков"
Отключите "Режим проверки чеков" на [странице|https://yookassa.ru/my/fiscalization-settings], если отправка чеков не настроена. Иначе при попытке платежа будет ошибка:
{code}
Произошла ошибка связи с ЮKassa.
{code}
А в логе модулей ЛК сообщение:
{code:title=/app/asr_cabinet/var/log/cabinet_modules.log}
2024-03-21 12:55:50.000000 - ERROR - yookassa create payment error code: 400
2024-03-21 12:55:50.000000 - ERROR - yookassa create payment error description: Receipt is missing or illegal
{code}
h2. Настройте биллинг
h3. Добавьте адреса ЮKassa в список разрешенных
- Для приема платежей со стороны платежной системы необходимо добавить IP-адреса, с которых осуществляется запрос в список разрешенных по статье "[CarbonBilling:Настройка сети для платежных систем]"
h3. Добавьте правила фаервола
Добавьте правила фаервола по статье "[CarbonBilling:Дополнительные настройки. hooks. Хуки. Свои правила в firewall]", так как ЮKassa может обращаться только на порт 8443 или 443.
В приведенных правилах ip 194.54.15.41 относится к тестовой среде ЮKassa. Перед добавлением правил уточните актуальные адреса платежной системы у её представителей.
Файл */app/asr_cabinet/cfg/hooks*
{code}
if [ "$1" == "/etc/init.d/firewall" -a "$2" == "start" ]; then
source /cfg/config
set -x
iptables -t nat -I asr_cabinet_prerouting -p tcp -s 194.54.15.41 --dport 8443 -j DNAT --to-destination 169.254.14.43:2443
iptables -t nat -I asr_cabinet_prerouting -p tcp -s 194.54.15.41 --dport 443 -j DNAT --to-destination 169.254.14.43:2443
set +x
fi
{code}
Файл */app/asr_fiscal/cfg/hooks*
{code}
if [ "$1" == "/etc/init.d/firewall" -a "$2" == "start" ]; then
source /cfg/config
echo "========================================="
set -x
iptables -t nat -I asr_fiscal_prerouting -p tcp -s 194.54.15.41 --dport 8443 -j DNAT --to-destination 169.254.14.43:${app[apache.sslport2]}
iptables -t nat -I asr_fiscal_prerouting -p tcp -s 194.54.15.41 --dport 443 -j DNAT --to-destination 169.254.14.43:${app[apache.sslport2]}
set +x
fi
{code}
h3. Укажите параметры интеграции с ЮKassa
!settingwebyookassa.png|border=0,width=800!
h4. Общие опции
*Настройки*: http://<billing_ip>:8081/settings/asr_fiscal/yookassa/
|
### Отправлять данные фискального чека: использовать ЮKassa. Необходима дополнительная настройка в ЮKassa
|
### Код системы налогообложения:: Коды ставок НДС:: Система налогообложения магазина. Необязательный. Возможные значения --- число от 1 до 6:
|
###* 1 --- без НДС;
###* 2 --- НДС по ставке 0%;
|
... ###* 3 --- НДС чека по ставке 10%;
###* 4 --- НДС чека по ставке 20%;
|
###* 5 --- НДС чека по расчетной ставке 10/110;
###* 6 --- НДС чека по расчетной ставке 20/120.
|
### Коды ставок НДС:: Система налогообложения магазина. Необязательный. Код системы налогообложения:: Возможные значения --- число от 1 до 6:
|
###* 1 --- общая СН;
###* 2 --- упрощенная СН (доходы);
|
... ###* 3 --- упрощенная СН (доходы минус расходы);
###* 4 --- единый налог на вмененный доход;
###* 5 --- единый сельскохозяйственный налог;
###* 6 --- патентная СН.
### ПРИЗНАК СПОСОБА РАСЧЁТА: Заполняется ключевым словом в соответствии с документацией [Яндекс|https://tech.yandex.ru/money/doc/payment-solution/payment-form/payment-form-receipt-docpage/], по умолчанию заполняется "full_payment" (полный расчет).
### ПРИЗНАК ПРЕДМЕТА РАСЧЁТА: Заполняется ключевым словом в соответствии с документацией [Яндекс|https://tech.yandex.ru/money/doc/payment-solution/payment-form/payment-form-receipt-docpage/], по умолчанию заполняется "service" (услуга).
### Секретный ключ API: необходимо скопировать ключ из настроек https://yookassa.ru/my/merchant/integration/api-keys поле "Секретный ключ"
!lkyookassa.png|border=0,width=800!
### Идентификатор магазина: необходимо скопировать из настроек https://yookassa.ru/my/shop-settings поле "shopId"
h2. Настройте оплату через личный кабинет.
Добавить на страницу оплаты шорткод для _ЮKassa_ [CarbonBilling:Отображение платежных систем в личном кабинете абонента]
*Шорткод для ЛК:*
{code}
[cabinet_payment operator=yookassa]
{code}
h2. Дополнительно
Лог при появлении ошибок в ЛК: /app/asr_cabinet/var/log/cabinet_modules.log
При появлении других ошибок необходимо воспользоваться документацией по отладке: [CarbonBilling:Платежные системы. Не проходят платежи.]
|
