Пройдите по ссылке к плагину на сайте OpenCart OpenCart - Платежный модуль Invoicebox
Авторизуйтесь или зарегистрируйте новый аккаунт. Это нужно для скачивания плагина.
Важно: название архива с модулем должно заканчиваться на .ocmod.zip.
Важно: сайт должен работать на версии php не менее 7.3.
- идентификатор магазина (v2 и v3)
- региональный код магазина (v2)
- имя пользователя API (v2)
- пароль API (v2)
- ключ API (v2 и v3)
- токен (v3)
В пункте 5 будут даны тестовые данные для 2й версии, а в пункте 6 - для 3й.
При оформлении заказа обязательно нужно добавить корректный номер телефона.
Возникшую при оплате ошибку можно узнать в истории заказа в админ-панели.
Настройка налогового режима
В налогах важны три пункта:
показываются они клиенту или нет
ставка НДС
формат цен
Формат цен задается в “Система - Локализация - Валюта”. Для каждой валюты проставьте в поле “количество знаков после запятой” значение 2.
Ставка НДС задаётся в меню “Система - Локализация - Налоги - Налоговые ставки”.
Допускаются ставки НДС 0%, 10%, 20%. В типе нужно выставить “процент”, а в “ставке” - нужное число.
Показ налогов настраивается в 3х местах: в модуле “Инвойсбокс”, в настройках, в модуле “Учитывать в заказе”.
Корректными являются такие варианты:
Модуль “Инвойсбокс”:
“Система - Настройки - Опции”:
Модули/расширения - Учитывать в заказе/Всего заказов-Отчеты - Налоги / Налоговый отчет:
Система - Настройки - Опции:
Модули/расширения - Учитывать в заказе - Налоги:
Специфические настройки
Тестовый режим - включите его для проведения тестовых платежей, при включении этого режима, вы пройдете все шаги в платежном терминале «Инвойсбокс», но деньги с вашей карты списаны не будут.
Статус заказа после оплаты - после успешной оплаты заказа, заказу будет установлен выбранный статус.
Статус заказа после подтверждения - при нажатии на кнопку "Подтвердить" на последнем этапе оформления заказа, заказу будет установлен выбранный статус.
Статус заказа после неудачной оплаты - Если «Инвойсбокс» вернёт покупателя после неудачного платежа, заказу будет установлен выбранный статус.
Статус заказа для отсроченной оплаты - после проверки заказа менеджер магазина выставит данный статус, покупатель будет уведомлен по электронной почте и сможет оплатить заказ. Также, ссылка на оплату появится в личном кабинете покупателя в разделе "Мои заказы".
БУДЬТЕ ВНИМАТЕЛЬНЫ! Если данный статус будет совпадать со "статус заказа после подтверждения" - режим отсроченной оплаты будет отключён и покупатели будут перенаправляться на сайт «Инвойсбокс» для оплаты сразу после нажатия на кнопку "Оформить заказ".
Режим отсроченной оплаты - при включённом режиме отсроченной (отложенной) оплаты покупатель сможет оплатить заказ только после проверки заказа менеджером магазина. Если вам необходимо, чтобы у покупателя была возможность произвести оплату сразу после оформления заказа без подтверждения менеджером - не включайте эту опцию.
Название - Название метода оплаты на странице оформления заказа.
Инструкция по оплате - выводится при подтверждении заказа. Если поле не заполнено - инструкция выводиться не будет.
В поле "Тип оплаты" выберите вариант full_prepayment (если он не выбран по умолчанию).
Поле "Тип товара по умолчанию"- выберите тип товара, который будет использоваться по умолчанию. Если на сайте присутствуют разные типы товаров, у каждого товара свой тип можно задать в атрибутах.
Поля “Страна-производитель товара по умолчанию” и “Код страны-производителя товара по умолчанию” : выберите страну-производителя, которая будет использоваться по умолчанию. Если на сайте присутствуют товары из нескольких стран, у каждого товара свою страну можно задать в атрибутах.
Если выбрана третья версия API, есть возможность передавать дополнительные данные (например, бронирование билетов или мест проживания). Для передачи этих данных понадобится помощь разработчика. Сохранять информацию нужно в таблицу oc_invoicebox_meta. Подробнее о формате передаваемых данных можете узнать по ссылке https://docs.invoicebox.ru/docs/order/metadata/.
Причины возникновения ошибок при загрузке:
Проверьте, оканчивается ли архив с модулем на “.ocmod.zip”
Проверьте версию php на сайте. Версия должна быть не менее 7.3.
Причины возникновения ошибок при оплате:
Если при оплате возникает ошибка, в первую очередь стоит зайти в административную панель, в раздел заказов и открыть новый заказ. Чаще всего причина будет указана там.
Проверьте, корректно ли указаны единицы измерения. Они должны быть указаны либо в каждом товаре, либо в настройках модуля (если в товаре нужных атрибутов нет, значения берутся из модуля). Частая ошибка - “шт.” вместо “шт”. Код для “шт” - 796.
Проверьте, корректно ли в товарах указан тип товара в самом товаре. Допустимые значения “commodity” и “service”. Либо оставьте поле пустым, чтобы значение бралось из настроек модуля.
Проверьте, правильно ли выставлены настройки налогов. См. раздел “настройка налогового режима”.
Проверьте, корректно ли заполнены доступы от API.
Проверьте, не включена ли опция “тестовое окружение”, если для магазина в Инвойсбокс не создавалось тестовое окружение. Если вы используете тестовые данные доступа из этой инструкции, настройка “тестовое окружение” должна быть отключена.
Проверьте в настройках модуля, включен ли он.
Если включен режим отложенной оплаты, убедитесь, что статус заказа для отсроченной оплаты не совпадает со статусом заказа после подтверждения.
Причины возникновения ошибок при возврате:
Если при оплате возникает ошибка, в первую очередь стоит посмотреть в истории заказа - иногда точная ошибка может быть указана там.
Проверьте, что используется та же версия API, что и при оплате заказа (нельзя переключаться со 2й на 3ю и наоборот).
Убедитесь, что общая сумма возврата не превышает допустимую для этого заказа (если по этому заказу уже осуществлялся возврат, остаток будет указан в предупреждении на странице возврата).
Убедитесь, что сумма возврата по каждому товару не больше суммы оплаты по этому товару.
Убедитесь, что у каждого товара заполнено поле SKU (Артикул) - с пустым полем сделать возврат для товара нельзя.
Часто задаваемые вопросы:
Вопрос: При выборе способа оплаты, заказ исчезает из панель управления магазином, даже если клиент оплатил данный заказ
Ответ: Проверьте корректность указания ссылка уведомления об оплате в личном кабинете системы Инвойсбокс. Заказ отображается в панели управления магазином только в том случае, если система оплаты корректно передала магазину информацию об оплате заказа.
Смотрите также: все платёжные модули →
