ЮKassa Payment Gateway (API v3)
Официальная интеграция эквайринга ЮKassa для SaviorBill по актуальному протоколу API v3.
Позволяет принимать платежи через банковские карты (МИР, Visa, Mastercard), СБП (Система быстрых платежей), SberPay, T-Pay и электронные кошельки ЮMoney.
Поддерживаемые действия:
create— создание платежа в ЮKassa со сценариемredirect. Поддерживает детерминированные ключи идемпотентности (sb_yk_pay_<id>) и опциональную фискализацию чеков по 54-ФЗ.callback— обработка входящего вебхука ЮKassa (payment.succeeded,payment.canceled). В целях безопасности статус всегда перепроверяется прямым server-to-server запросом к API.check— фоновая проверка статуса зависших или незавершенных платежей по расписанию биллинга.refund— оформление полного возврата средств через API возвратов ЮKassa с детерминированнымIdempotence-Key.
Настройки подключения:
shop_id— идентификатор магазина из личного кабинета ЮKassa.secret_key— секретный ключ API (форматаlive_...илиtest_...).return_url— ссылка для возврата плательщика в личный кабинет после оплаты.send_receipt— отправка данных для формирования электронного чека в ФНС (54-ФЗ).vat_code— ставка НДС (по умолчанию 1 — Без НДС).payment_subject— признак предмета расчета (по умолчаниюservice— услуга).payment_mode— признак способа расчета (по умолчаниюfull_payment— полный расчет).
Настройка вебхуков в личном кабинете ЮKassa:
- Откройте Личный кабинет ЮKassa → Интеграция → HTTP-уведомления.
- Укажите URL обработчика:
https://billing.example.com/api/v1/payments/callback/yookassa-payment - Отметьте события:
payment.succeededpayment.canceledrefund.succeeded