База знаний BILLmanager
Режим фокусировки

Ошибка 309 "Неверные параметры" при оплате

Проблема

При пополнении баланса или продлении услуги в личном кабинете возникает ошибка. В веб-интерфейсе отображается сообщение "Произошла ошибка", при этом транзакция не проходит.

Причина

Платёжная система ожидает передачу фискального чека, подтверждающего покупку, но платформа не отправляет его. Это происходит, когда в личном кабинете платёжной системы включена обработка чеков, а в настройках метода оплаты в платформе отправка чеков отключена.

Диагностика

Чтобы подтвердить причину, найдите в логах запись с ответом от платёжной системы:

  1. Подключитесь к серверу с платформой по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
  2. Откройте лог-файл:
    tail -f /usr/local/mgr5/var/billmgr.log
  3. В веб-интерфейсе платформы воспроизведите проблему: пополните баланс или продлите услугу.
  4. В логе найдите строку с ответом от платёжной системы c кодом ошибки 309:
    Пример вывода
    {"Success":false,"ErrorCode":"309","Message":"Неверные параметры.","Details":"{request.validate.expected.receipt}"}
    Если в логах присутствует ошибка 309 с упоминанием expected.receipt, это подтверждает проблему: платёжная система требует чек, который не был передан.

 Если информации в основном логе недостаточно:

  • проверьте лог конкретного платёжного модуля. Логи платёжных модулей имеют формат pmxxx.log , где xxx — название модуля оплаты. Например, для модуля ЮMoney лог называется pmyoomoney.log. Точное имя лог-файла для конкретного метода оплаты см. в разделе Подключение методов оплаты;
  • увеличьте уровень логирования , чтобы получить более детальную информацию. Подробнее см. в статье Логирование в BILLmanager.

Решение

Чтобы решить проблему, включите отправку чеков в BILLmanager:

  1. Перейдите в раздел Провайдер → Методы оплаты. 
  2. Выберите метод оплаты.
  3. Нажмите Изменить.
  4. В блоке Отправка чеков онлайн включите опцию о тправка чеков платежной системой.

  5. В поле Наименование услуги укажите общее название услуги, которое будет отображаться в чеке (например,  Предоплата за услуги провайдера ). Максимальная длина — 64 символа.
  6. Нажмите Ок, чтобы сохранить настройки.