Руководства → OpenCart и ocStore: оплата Kaspi QR

OpenCart и ocStore: оплата Kaspi QR

Модуль KazPayment добавляет в OpenCart 3 способ оплаты «Kaspi QR или любой банк». Покупатель подтверждает заказ и попадает на нашу страницу оплаты: на телефоне это кнопка «Оплатить в Kaspi», на компьютере QR, который понимают Kaspi и приложения других банков. Как только деньги пришли, заказ получает статус «оплачен». Деньги идут прямо на счёт Kaspi Pay вашего бизнеса.

Что нужно заранее

• Бизнес на kazpayment.kz с подключённой кассой: Подключить кассу Kaspi.
• OpenCart 3.0.x или ocStore 3, PHP 7.4+ с расширением curl.
• Валюта «Тенге» с кодом KZT («Система» → «Локализация» → «Валюты»), и покупатель платит в ней. В других валютах способ оплаты не показывается.

Тариф подходит любой, включая бесплатный Free: на нём через API — до 500 заказов в месяц.

Установка

1. Скачайте модуль: kazpayment-opencart.ocmod.zip.
2. «Расширения» → «Установка расширений» → «Загрузить» → выберите архив.
3. «Расширения» → «Расширения» → тип «Оплата» → «KazPayment — Kaspi QR» → «Установить» (зелёный плюс), затем «Изменить».
4. В кабинете KazPayment выпустите ключ: «Подключения» → «Интеграция» → «Выпустить ключ». Скопируйте его сразу — он показывается один раз.
5. В настройках модуля:
   • «Ключ интеграции» — вставьте ключ;
   • отметьте «указать KazPayment адрес этого магазина» — модуль сам сообщит адрес вебхука и сохранит секрет;
   • «Статус» — «Включено» — и сохраните.
6. Рекомендуем: добавьте в планировщик хостинга (cron) открытие адреса из строки «Проверка по расписанию» раз в 10 минут. Он спросит у KazPayment статус заказов, ждущих оплаты, — на случай, если вебхук не дошёл, а покупатель закрыл вкладку, не вернувшись в магазин.

Как это работает

• Номер заказа в KazPayment — номер заказа OpenCart (с префиксом, если вы его задали). Если сумма заказа после первой попытки изменилась, заведётся новый номер с суффиксом; оплата и по старой ссылке найдёт заказ — тогда в истории появится «получено N ₸ из M ₸».
• Оплата отмечается вебхуком: заказ получает статус из настройки «Статус: оплачен» (по умолчанию «В обработке»), покупателю уходит письмо. Если вебхук не настроен или опоздал, статус проверяется, когда покупатель возвращается со страницы оплаты кнопкой «Вернуться в магазин», и по расписанию (cron). Не заплатил и вернулся — попадёт в корзину, а не на «Заказ оформлен».
• Отменённый заказ не становится оплаченным, даже если покупатель заплатил по ещё открытой ссылке: в истории появится заметка — верните деньги в кабинете KazPayment или восстановите заказ. Так же с заказом, который вы уже перевели дальше вручную.
• Телефон покупателя передаётся KazPayment, если он казахстанский.
• Сумма — в целых тенге: тиыны округляются.
• Возврат делается в кабинете KazPayment («Деньги» → «Начисления» → «Возврат»): в OpenCart 3 нет возврата через способ оплаты. Когда деньги вернулись, в истории заказа появится заметка.

Если что-то не так

• Способа оплаты нет при оформлении. Валюта покупателя не KZT, модуль выключен или не вставлен ключ.
• Покупатель видит «Оплата через Kaspi сейчас недоступна». Причина — в журнале ошибок («Система» → «Обслуживание» → «Журнал ошибок»), строки KazPayment:: «Ключ не принят» — выпустите новый ключ; «до 500 заказов» — предел Free.
• Оплачено, а заказ «Ожидает». Вебхук не настроен или не доходит: адрес магазина должен быть https и открываться из интернета, см. вебхук. У бизнеса один адрес вебхука — если он ведёт в другую вашу систему, отметка «указать адрес» перенаправит события в магазин. Несколько сайтов на одном бизнесе: задайте каждому префикс номера и включите проверку по расписанию — вебхук дойдёт только до одного.

Не помогло? Напишите на support@kazpayment.kz — отвечает разработчик сервиса.