Руководства → WooCommerce: оплата Kaspi QR за десять минут

WooCommerce: оплата Kaspi QR за десять минут

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

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

• Бизнес на kazpayment.kz с подключённой кассой: Подключить кассу Kaspi.
• WordPress 6.0+, WooCommerce 7.0+, PHP 7.4+.
• Валюта магазина — тенге (WooCommerce → «Настройки» → «Основные» → «Валюта»). В других валютах способ оплаты не показывается.

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

Установка

1. Скачайте плагин: kazpayment-woocommerce.zip.
2. WordPress → «Плагины» → «Добавить новый» → «Загрузить плагин» → выберите архив → «Установить» → «Активировать».
3. В кабинете KazPayment выпустите ключ: «Подключения» → «Интеграция» → «Выпустить ключ». Скопируйте его сразу — он показывается один раз.
4. WooCommerce → «Настройки» → «Платежи» → «KazPayment — Kaspi QR»:
   • «Включить» — отметьте;
   • «Ключ интеграции» — вставьте ключ;
   • «Настроить вебхук» — отметьте и нажмите «Сохранить». Плагин сам сообщит KazPayment адрес вашего магазина и сохранит секрет.

Готово: оформите тестовый заказ. В тестовом режиме KazPayment оплату отмечаете в кабинете сами («Деньги» → «Начисления»).

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

• Номер заказа в KazPayment — номер заказа WooCommerce (с префиксом, если вы его задали). Покупатель вернулся и нажал «Оплатить» снова — откроется та же оплата. Если сумма заказа с тех пор изменилась, заведётся новый номер с суффиксом; оплата и по старой ссылке всё равно найдёт заказ.
• Оплата отмечается вебхуком: заказ становится оплаченным («Обработка», а для скачиваемых товаров — «Выполнен»). Если вебхук не дошёл, статус проверяется на странице «Спасибо» и в фоне — через 5 минут, 15 минут, час и три часа после оформления.
• Возврат — кнопка «Возврат» в заказе WooCommerce: деньги вернутся покупателю через Kaspi. Возврат по заказу — один и в целых тенге: после первого, даже частичного, второй плагин не примет. Возврат, сделанный мимо WooCommerce (в кабинете KazPayment или в Kaspi), появится заметкой в заказе.
• Телефон покупателя передаётся KazPayment, если он казахстанский — тогда ему можно прислать ссылку на оплату в WhatsApp. Иначе заказ заведётся без телефона.
• Сумма — в целых тенге: тиыны округляются. Заказ в другой валюте (плагины мультивалютности) оплатить через Kaspi нельзя.

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

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

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