Документация KZ Pay
Установка плагина, активация лицензии, API-ключ Kaspi Pay, торговая точка и проверка оплаты в WooCommerce.
- Начало работы
- Подключение Kaspi Pay
- Проверка оплаты
Настройте KZ Pay шаг за шагом
Проверьте требования, установите плагин, активируйте лицензию, подключите Kaspi Pay и зарегистрируйте магазин. Включайте оплату только после завершения настройки.
Перед установкой
Проверьте WordPress, WooCommerce, HTTPS, валюту KZT, доступ продавца Kaspi Pay, API-ключ и торговую точку.
Установка и активация
Загрузите ZIP KZ Pay, активируйте плагин и завершите оформление лицензии или пробного периода через Freemius.
Подключение Kaspi Pay
Сохраните API-ключ, проверьте соединение, загрузите и выберите торговую точку, зарегистрируйте магазин.
Оформление заказа
Включите KZ Pay после настройки ключа, торговой точки и регистрации магазина.
Платежи и заказы
Покупатель оплачивает через QR или мобильную ссылку. KZ Pay отслеживает результат и обновляет соответствующий заказ.
Проблемы и поддержка
Сначала выполните проверки по описанию проблемы. Не отправляйте секретные данные и полные конфиденциальные логи.
Начало работы
Убедитесь, что ваш магазин WordPress и аккаунт Kaspi Pay соответствуют требованиям KZ Pay.
- WordPress 6.9 или новее
- WooCommerce 7.0 или новее установлен и активен
- Рабочий сайт использует HTTPS
- Валюта магазина WooCommerce: KZT
- У продавца есть доступ к Kaspi Pay
- Получен API-ключ Kaspi Pay
- Настроена хотя бы одна торговая точка
- На сервере PHP 8.1 или новее и OpenSSL
Доступ к Kaspi Pay оформляется отдельно
KZ Pay не предоставляет аккаунт Kaspi Pay или API-ключ. Продавец получает их самостоятельно через Kaspi Pay.
Установка
Установите ZIP как обычный коммерческий плагин WordPress. Перед включением приема оплаты откройте его настройки. Используйте файл из своей покупки или кабинета клиента, а не из неизвестных источников.
- Загрузите ZIP Скачайте установочный архив KZ Pay через доступ, предоставленный после оформления покупки или пробного периода.
- Загрузите в WordPress Откройте Плагины > Добавить плагин > Загрузить плагин.
- Установите и активируйте Выберите ZIP, установите плагин и активируйте его. Перед обновлением сделайте резервную копию сайта.
- Откройте настройки Используйте меню Kaspi Pay или WooCommerce > Настройки > Платежи > KZ Pay for WooCommerce.
Активация лицензии
После активации плагина следуйте приглашению Freemius. Загрузка, обновления, доступ, управляемый лицензией, и техническая поддержка зависят от действующего пробного периода или подписки.
- Начните активацию Следуйте приглашению Freemius в WordPress после включения плагина.
- Укажите данные лицензии Используйте email покупки или лицензионный ключ из аккаунта KZ Pay. Не публикуйте ключ.
- Проверьте статус Убедитесь, что Freemius показывает активный пробный период или подписку перед использованием загрузок, обновлений и поддержки.
- Если активация не удалась Проверьте email покупки, лицензию и сетевой доступ сервера к Freemius. Затем повторите попытку.
Подключение Kaspi QR
Завершите эти шаги до включения оплаты. Английские названия в скобках помогают найти соответствующие элементы англоязычного интерфейса плагина.
API-ключ Kaspi Pay и порядок подключения
API-ключ позволяет KZ Pay подключить магазин к Kaspi Pay с сервера WordPress. Не добавляйте реальные учетные данные в сообщения поддержки, скриншоты или публичную документацию.
- Укажите API-ключ В разделе подключения Kaspi QR (Kaspi QR Connection) вставьте рабочий ключ своей организации.
- Сохраните ключ Нажмите Save API key. Сохраненный ключ шифруется и повторно не отображается.
- Проверьте соединение Нажмите Test connection перед загрузкой торговых точек.
- Загрузите торговые точки Нажмите Load trade points.
- Выберите торговую точку В поле Trade point выберите точку, которая будет принимать оплату этого магазина.
- Зарегистрируйте магазин Нажмите Register this store. KZ Pay передает автоматически созданный идентификатор установки и выбранную точку в Kaspi Pay.
- Включите оплату После выполнения списка готовности включите KZ Pay на странице оформления заказа и сохраните настройки.
Торговая точка и регистрация магазина
Торговая точка определяет, к какой точке Kaspi Pay относится оплата магазина. Регистрация связывает текущую установку WordPress с выбранной точкой.
Торговая точка
Выберите точку Kaspi Pay, которая должна принимать платежи вашего магазина.
KZ Pay Device ID
Идентификатор создается автоматически для этой установки WordPress и отображается в настройках.
Регистрация магазина
После успешной регистрации появляется статус Registered with Kaspi Pay.
Отключение магазина
Используйте Disconnect this store только для отключения регистрации или переноса. После этого прием оплаты выключается.
Настройка оформления заказа
Включайте KZ Pay после подключения и регистрации магазина. Проверьте способ оплаты в вашей теме, классическом оформлении заказа или Checkout Blocks.
- API-ключ Kaspi Pay сохранен
- Торговая точка выбрана
- Магазин зарегистрирован в Kaspi Pay
- Включено Enable KZ Pay at WooCommerce checkout
- Валюта оформления заказа и заказа: KZT
Перед приемом реальных платежей
Владелец магазина должен провести контролируемую проверку оплаты перед запуском. Убедитесь, что QR или платежная ссылка работают, а итоговый результат относится к правильному заказу WooCommerce.
- API-ключ настроен
- Выбрана правильная торговая точка
- Магазин зарегистрирован
- KZ Pay включен при оформлении заказа
- Валюта оплаты: KZT
- Владелец завершил контролируемую оплату
- WooCommerce получил итоговый результат
- Заказ обновился правильно
Как KZ Pay обрабатывает оплату
После создания заказа WooCommerce KZ Pay открывает защищенную страницу оплаты и создает Kaspi QR или мобильную платежную ссылку.
Оплата через Kaspi QR
- Покупатель оформляет заказ WooCommerce создает заказ и открывает страницу оплаты KZ Pay.
- KZ Pay создает запрос на оплату Плагин передает сумму заказа и созданный платежный идентификатор в Kaspi Pay.
- Покупатель подтверждает оплату С компьютера он сканирует QR в Kaspi. На телефоне может перейти в приложение по ссылке.
- KZ Pay отслеживает результат Плагин проверяет статус с сервера WordPress.
- WooCommerce обновляет заказ Заказ обновляется только после получения и проверки итогового результата оплаты.
Мобильные платежные ссылки
На телефоне покупатель может продолжить оплату в Kaspi на том же устройстве. Открытие ссылки не означает, что заказ оплачен.
Статус платежа и заказы WooCommerce
KZ Pay отслеживает статус и обновляет соответствующий заказ после получения проверенного итогового результата.
Ожидание оплаты
Покупатель видит QR или ссылку; окончательный результат еще не получен.
Оплата завершена
Kaspi вернул успешный результат с корректными данными транзакции и совпадающей суммой.
Ошибка или истечение срока
Получен итоговый статус ошибки, отмены или истечения срока. Повторная попытка возможна, когда сохраненный статус это разрешает.
Ручная проверка
KZ Pay не может безопасно завершить обработку автоматически и отмечает необходимость проверки администратором.
Возвраты
Автоматические возвраты через API в текущей интеграции Kaspi QR недоступны. Сначала выполните денежный возврат в приложении Kaspi Pay, затем отразите его в WooCommerce. Запись возврата в WooCommerce не равнозначна фактическому возврату денег.
Проверки настройки и оплаты
Выполните эти проверки перед обращением в поддержку. Не отправляйте API-ключи, пароли и полные конфиденциальные логи.
KZ Pay не виден при оформлении заказа
- Возможная причина
- Способ оплаты выключен, настройка не завершена, валюта не KZT или нужно проверить лицензию.
- Что проверить
- Проверьте список готовности, валюту заказа и статус лицензии или пробного периода Freemius.
- Что делать дальше
- Завершите настройку ключа, точки и регистрации, затем включите оплату и сохраните настройки.
Проверка соединения не проходит
- Возможная причина
- API-ключ отсутствует, недействителен или сервер не соединяется с Kaspi Pay.
- Что проверить
- Проверьте правильность ключа своей организации и исходящий HTTPS.
- Что делать дальше
- Сохраните ключ повторно и запустите Test connection. При повторной ошибке обратитесь в поддержку без передачи ключа.
Торговые точки не загружаются
- Возможная причина
- Kaspi Pay не вернул точки или ключ не имеет доступа.
- Что проверить
- Проверьте наличие настроенных торговых точек у продавца.
- Что делать дальше
- Исправьте настройку в Kaspi Pay и повторите Load trade points.
Магазин не регистрируется
- Возможная причина
- Точка не выбрана или Kaspi Pay отклонил регистрацию.
- Что проверить
- Проверьте торговую точку и принадлежность ключа организации.
- Что делать дальше
- Повторите Register this store или передайте поддержке безопасный reference запроса, если он доступен.
QR не создается
- Возможная причина
- Настройка не завершена, нет GD/PNG или запрос отклонен.
- Что проверить
- Проверьте KZT, готовность настройки, расширения PHP и сумму заказа.
- Что делать дальше
- Исправьте причину и повторите попытку. Если покупатель ожидает, предложите другой способ оплаты.
Платеж остается в ожидании
- Возможная причина
- Итоговый результат еще не получен или задачи WordPress задерживаются.
- Что проверить
- Проверьте заметки заказа, WP-Cron и Action Scheduler.
- Что делать дальше
- Дождитесь следующей проверки или обратитесь в поддержку с номером заказа.
Покупатель оплатил, но заказ не обновился
- Возможная причина
- Результат нельзя безопасно подтвердить автоматически.
- Что проверить
- Проверьте заметки о ручной проверке, несовпадении суммы или отсутствующих данных транзакции.
- Что делать дальше
- Не создавайте повторную оплату. Передайте номер заказа и безопасное описание в поддержку.
Мобильная ссылка не открывается
- Возможная причина
- Браузер или приложение не поддерживают переход либо ссылка неактуальна.
- Что проверить
- Проверьте доступность Kaspi на устройстве и используйте обычный браузер.
- Что делать дальше
- Повторите оплату после проверки предыдущего результата, когда KZ Pay разрешает повторную попытку, либо выберите другой способ.
Срок оплаты истек
- Возможная причина
- Покупатель не подтвердил оплату вовремя.
- Что проверить
- Проверьте статус заказа и возможность повторной попытки.
- Что делать дальше
- Разрешите повторную оплату только после проверки предыдущего результата и разрешения KZ Pay.
Лицензия не активируется
- Возможная причина
- Лицензия неактивна, указан неверный email или Freemius не может проверить ее.
- Что проверить
- Проверьте аккаунт KZ Pay, email покупки и подписку.
- Что делать дальше
- Активируйте или продлите лицензию и обновите страницу настроек.
Вопросы по настройке KZ Pay
Краткие ответы на распространенные вопросы установки и поддержки.
Где ввести API-ключ Kaspi Pay?
В меню Kaspi Pay или WooCommerce > Настройки > Платежи > KZ Pay for WooCommerce, в разделе Kaspi QR Connection.
Как выбрать торговую точку?
Нажмите Load trade points и выберите нужную точку в Trade point.
Зачем регистрировать магазин?
Регистрация связывает установку WordPress и ее KZ Pay Device ID с торговой точкой Kaspi Pay.
Почему KZ Pay не виден при оплате?
Проверьте завершение настройки, включение метода, KZT и статус лицензии или пробного периода.
Как оплачивать с телефона?
Покупатель может перейти в Kaspi по платежной ссылке на том же устройстве.
Как определяется успешная оплата?
KZ Pay проверяет статус с сервера WordPress и обновляет заказ после итогового проверенного результата.
Можно ли использовать другую валюту?
Нет. KZ Pay доступен только для оформления заказа и заказов в KZT.
Как выполнить возврат?
Сначала верните деньги через Kaspi Pay, затем отразите возврат в WooCommerce. Автоматические API-возвраты недоступны.
Можно ли перенести плагин?
Новая установка WordPress получает свой Device ID. Зарегистрируйте ее с нужной торговой точкой и проверьте лицензию.
Что отправить в поддержку?
Версии WordPress, WooCommerce и KZ Pay, номер заказа и безопасное описание. Не отправляйте API-ключ.
Информация для разработчиков
Детали интеграции для администраторов и разработчиков. Для обычной настройки следуйте инструкции выше.
Упрощенная схема доступа
Интеграция использует Kaspi Public QR API Scheme 1. Настройка сертификатов для других схем в WordPress не предусмотрена.
Авторизация API
Сохраненный API-ключ передается с сервера и не выводится в публичной документации.
DeviceToken
При регистрации Kaspi Pay возвращает DeviceToken. KZ Pay сохраняет его для последующих запросов.
Проверка статуса
Статус проверяется сервером; при необходимости сохраняется первая работающая версия API статуса.
Внутренние статусы
QrTokenCreated, RemotePaymentCreated, Wait, Processing, Processed и итоговые статусы ошибок интерпретируются вместе с данными транзакции.
Возможности интеграции
QR, мобильные ссылки, регистрация магазина, загрузка торговых точек и отслеживание статуса. Платежные webhooks, автоматические API-возвраты и Kaspi Shop не предоставляются.
Нужна помощь?
Если инструкция не помогла, напишите на support@group-starlight.com. Укажите версии WordPress, WooCommerce и KZ Pay, а также номер заказа, связанного с проблемой.
Не отправляйте API-ключ Kaspi Pay, пароли, полные конфиденциальные логи и учетные данные.
Написать в поддержкуПродолжите с нужной страницы
Тарифы и ограничения смотрите на странице продукта. Практические инструкции помогут разобраться в подключении и проведении платежей.