ПОДКЛЮЧЕНИЕ KASPI PAY
Как подключить Kaspi Pay к WooCommerce
Пошаговое руководство для интернет-магазина в Казахстане: требования, API-ключ, торговая точка, регистрация магазина и проверка оплаты.
Что подготовить перед подключением
Kaspi Pay относится к сервисам для бизнеса. Подключение к нему и установка плагина в WordPress являются разными этапами. Сначала подготовьте доступ продавца для нужного онлайн-платежного сценария, затем подключайте WooCommerce.
- Активный WooCommerce, валюта KZT и HTTPS на рабочем сайте.
- Свой доступ к Kaspi Pay, API-ключ и хотя бы одна настроенная торговая точка.
- Доступ администратора WordPress, актуальная резервная копия и возможность установить плагин.
- Сервер с исходящими HTTPS-запросами и работающими планировщиками задач WordPress/WooCommerce.
Общие требования к подключению бизнеса смотрите в официальном Kaspi Гиде. Наличие аккаунта само по себе не подтверждает доступ к нужному API. Уточняйте его отдельно в Kaspi Pay.
Как платеж связан с заказом
Покупатель оформляет заказ в WooCommerce, выбирает Kaspi и получает QR-код или платежную ссылку. После подтверждения оплаты в Kaspi интеграция отслеживает итоговый результат и обновляет соответствующий заказ.
Создание QR-кода не означает, что заказ оплачен. WooCommerce должен обновлять заказ только после итогового результата платежа, сопоставленного с заказом и его суммой.
Процесс оплаты на компьютере и телефоне подробно разобран в отдельном руководстве по Kaspi QR.
Подключение по шагам
1. Установите интеграцию WooCommerce
Выберите поддерживаемую интеграцию, например KZ Pay. Установите ZIP в WordPress, активируйте плагин и его лицензию или пробный период. Проверьте, что WooCommerce работает до добавления платежного метода.
2. Подготовьте API-ключ Kaspi Pay
Получите ключ для своей организации и необходимого платежного сценария через Kaspi Pay. Введите его в настройки интеграции без лишних пробелов. Не публикуйте ключ, не отправляйте его покупателям или в обычные сообщения поддержки.
3. Проверьте соединение
Используйте проверку соединения в настройках установленного плагина. При ошибке проверьте ключ, доступ организации и исходящие HTTPS-запросы сервера. Сохраните безопасное сообщение об ошибке без секретных данных.
4. Загрузите торговые точки
Получите доступный список и выберите точку, соответствующую вашему магазину. Пустой список может означать ограничения аккаунта, неверный ключ или ошибку соединения. Не вводите случайные идентификаторы.
5. Зарегистрируйте магазин
Завершите регистрацию через настройки интеграции и убедитесь, что она прошла успешно. После изменения ключа или торговой точки проверьте, соответствует ли существующая регистрация новой конфигурации.
6. Включите способ оплаты
В WooCommerce → Настройки → Платежи включите платежный метод KZ Pay. Проверьте его название для покупателя, валюту KZT и готовность подключения.
Проверка перед запуском
Сначала проверьте страницу оформления заказа и настройки без оплаты. Затем владелец магазина должен выполнить контролируемую проверку в разрешенной для своего аккаунта среде. Не считайте создание QR-кода успешной проверкой завершенного платежа.
- Метод доступен при корректной валюте и положительной сумме заказа.
- С компьютера доступен читаемый QR-код.
- С телефона платежная ссылка открывает поддерживаемый сценарий.
- Заказ остается в ожидании до окончательного результата.
- При подтвержденной оплате сумма и результат относятся к правильному заказу.
- Истечение срока, отмена и ошибка не превращаются в успешную оплату.
- Уведомления и дальнейшая обработка заказа соответствуют настройкам WooCommerce.
Как обрабатывать возврат
Автоматические возвраты через API в текущей интеграции Kaspi QR недоступны. Сначала выполните денежный возврат в приложении Kaspi Pay, затем отразите его в WooCommerce. Запись возврата в WooCommerce сама по себе не переводит деньги покупателю.
Если подключение не работает
Способ оплаты не виден
Возможная причина: метод выключен или не выполнены требования. Проверьте: KZT, положительную сумму, настройки платежей, ключ, торговую точку, регистрацию и статус лицензии. Далее: исправьте отсутствующий этап и повторно откройте оформление заказа.
Проверка соединения не проходит
Возможная причина: неверный ключ, ограничения аккаунта или сети. Проверьте: отсутствие пробелов, принадлежность ключа организации, исходящий HTTPS, ограничения хостинга. Далее: уточните доступ в Kaspi Pay или обратитесь к хостингу с безопасным текстом ошибки.
Торговые точки не загружаются
Возможная причина: нет доступных точек для ключа. Проверьте: ключ, соединение и настройки организации. Далее: подтвердите доступ к нужной точке в Kaspi Pay и загрузите список повторно.
Регистрация магазина не завершается
Возможная причина: неправильная точка или неполная настройка доступа. Проверьте: выбранную точку и безопасное сообщение об ошибке. Далее: исправьте конфигурацию; не заменяйте идентификаторы случайными значениями.
QR-код не создается
Возможная причина: магазин не зарегистрирован или запрос не принят. Проверьте: сумму, KZT, регистрацию, ключ и сеть. Далее: используйте диагностику плагина и передайте поддержке номер заказа без секретных данных.
Оплата остается в ожидании
Возможная причина: клиент не завершил оплату или магазин не получил результат. Проверьте: платеж в Kaspi Pay, заметки заказа, WP-Cron и Action Scheduler. Далее: восстановите отслеживание статуса; не отмечайте заказ оплаченным только по наличию QR.
Клиент оплатил, но заказ не обновился
Возможная причина: результат не получен или не сопоставлен. Проверьте: подтверждение в Kaspi Pay, сумму, номер заказа и задачи планировщика. Далее: сверяйте данные и обратитесь в поддержку. Не просите клиента платить повторно до проверки.
Мобильная платежная ссылка не открывается
Возможная причина: ограничения встроенного браузера или приложения. Проверьте: актуальность ссылки и поддержку приложения на устройстве. Далее: откройте страницу в обычном браузере; при необходимости используйте QR на другом экране.
Срок оплаты истек
Возможная причина: платеж не завершен в отведенное время. Проверьте: фактический статус в Kaspi Pay. Далее: если оплаты нет, начните новый доступный платежный сценарий. Старый QR повторно не используйте.
Частые вопросы о подключении
Можно подключить Kaspi Pay без API-ключа?
Для этой интеграции нужен ваш API-ключ Kaspi Pay. Номер телефона или распечатанный QR торговой точки не заменяют ключ.
Подойдет ли сайт на WordPress без WooCommerce?
KZ Pay предназначен для WooCommerce. Сначала установите и настройте WooCommerce.
Это подключение к Магазину на Kaspi.kz?
Нет. Руководство описывает прием оплаты на вашем собственном сайте WooCommerce.
Может ли плагин получить доступ продавца за меня?
Нет. Подключение аккаунта и банковские условия нужно согласовать с Kaspi Pay самостоятельно.
Готовая интеграция для WooCommerce
KZ Pay предоставляет поддерживаемую интеграцию Kaspi QR и платежных ссылок, настройку продавца, отслеживание статуса и обновление заказа WooCommerce.
Подробнее о KZ Pay и тарифах · Документация по установке
7 дней бесплатно. Банковская карта не требуется.
Подключите Kaspi QR к WooCommerce
Изучите требования и попробуйте KZ Pay в течение 7 дней без банковской карты.