Все инструкции

ПОДКЛЮЧЕНИЕ KASPI PAY

Как подключить Kaspi Pay к WooCommerce

Пошаговое руководство для интернет-магазина в Казахстане: требования, API-ключ, торговая точка, регистрация магазина и проверка оплаты.

Перед подключением

Что нужно для подключения Kaspi Pay

Начните с доступа продавца и готовности магазина. Проверьте API-ключ, валюту и регистрацию: без них прием оплаты не будет готов.

Список требований

  • WooCommerce установлен и активен.
  • Валюта магазина: KZT.
  • Рабочий сайт использует HTTPS.
  • У продавца есть доступ Kaspi Pay для онлайн-оплаты.
  • Получен API-ключ Kaspi Pay.
  • Доступна хотя бы одна торговая точка для платежей магазина.
Порядок настройки

Подключение Kaspi Pay шаг за шагом

Названия элементов зависят от плагина, но последовательность одна: API-ключ, торговая точка, регистрация магазина, включение оплаты и проверка.

  1. 1

    Подготовьте WooCommerce

    Проверьте активность WooCommerce, валюту KZT и работу оформления заказа до добавления нового способа оплаты.

  2. 2

    Установите интеграцию

    Установите и активируйте платежный плагин. Завершите активацию лицензии или пробного периода, если это требуется.

  3. 3

    Добавьте API-ключ Kaspi Pay

    Сохраните рабочий ключ своей организации в настройках плагина и выполните проверку соединения.

  4. 4

    Выберите торговую точку

    Загрузите доступные точки и выберите ту, которая должна принимать оплату вашего магазина.

  5. 5

    Зарегистрируйте магазин

    Завершите регистрацию через настройки, чтобы сайт мог создавать платежи Kaspi.

  6. 6

    Включите способ оплаты

    Включайте оплату после настройки ключа, точки и регистрации.

  7. 7

    Проверьте QR с компьютера

    Владелец магазина должен провести контролируемую оплату в KZT и убедиться, что заказ обновился после итогового результата.

  8. 8

    Проверьте ссылку на телефоне

    Убедитесь, что платежная ссылка открывает Kaspi на том же устройстве и результат относится к правильному заказу.

Проведение платежа

Что происходит после выбора Kaspi Pay

Оплата покупателем, проверка статуса и обновление заказа являются отдельными этапами.

Kaspi QR на компьютере

Покупатель видит QR на странице оплаты и сканирует его приложением Kaspi на другом устройстве.

Ссылка на телефоне

Покупатель продолжает оплату в Kaspi на том же устройстве, не сканируя собственный экран.

Отслеживание статуса

Интеграция проверяет статус до итогового результата: успешной оплаты, ошибки, отмены или истечения срока.

Обновление заказа

WooCommerce обновляет заказ после итогового результата и проверки суммы.

Проверка перед запуском

Владелец магазина проверяет успешную оплату, ошибку, истечение срока и незавершенные попытки.

Возврат покупателю

Автоматические API-возвраты недоступны. Сначала верните деньги в Kaspi Pay, затем отразите возврат в WooCommerce.

Решение проблем

Проверки при настройке магазина

Выполните эти проверки перед обращением в поддержку. Не отправляйте API-ключи, пароли и полные конфиденциальные логи.

Способ оплаты не виден

  • Проверьте валюту KZT.
  • Убедитесь, что метод включен в WooCommerce.
  • Проверьте API-ключ, торговую точку и регистрацию.
  • Проверьте лицензию или пробный период, если они требуются интеграцией.

Ошибка соединения

  • Проверьте ключ без лишних пробелов.
  • Ключ должен принадлежать рабочему аккаунту продавца.
  • Сервер должен поддерживать исходящий HTTPS.
  • Проверьте ограничения плагинов безопасности и хостинга.

Точки не загружаются

  • Проверьте доступ ключа к нужным точкам.
  • Сначала повторите проверку соединения.
  • Уточните активность точки в Kaspi Pay.
  • Посмотрите безопасное сообщение об ошибке в админке.

Ошибка регистрации магазина

  • Рабочий URL должен использовать HTTPS.
  • Проверьте выбранную точку.
  • Сохраните ключ и точку и повторите регистрацию.
  • При повторной ошибке передайте поддержке безопасный текст ошибки и адрес сайта.

QR не создается

  • Сумма должна быть больше нуля, валюта KZT.
  • Проверьте список готовности.
  • Уточните доступность этого типа оплаты для точки.
  • Проверьте заметки заказа об ошибке попытки оплаты.

Оплата остается в ожидании

  • Не отмечайте заказ оплаченным без фактической проверки в Kaspi Pay.
  • Проверьте WP-Cron или Action Scheduler.
  • Посмотрите последние заметки заказа.
  • Передайте поддержке номер заказа и безопасный идентификатор платежа.

Покупатель оплатил, но заказ не обновился

  • Проверьте денежный платеж в Kaspi Pay.
  • Сравните сумму с итогом заказа.
  • Посмотрите заметки о задержке, ошибке или ручной проверке.
  • Зафиксируйте подтвержденное решение в WooCommerce до исполнения заказа, не создавая повторную оплату.

Ссылка не открывается на телефоне

  • Проверьте обычный мобильный браузер, а не встроенный просмотр.
  • Ссылка должна относиться к текущей попытке оплаты.
  • Проверьте доступность приложения Kaspi.
  • Если возможно, предложите QR на компьютере как альтернативу.

Срок оплаты истек

  • Проверьте предыдущий результат и разрешение KZ Pay на повторную попытку.
  • Не используйте истекший QR или ссылку.
  • Сохраните историю попытки в заметках заказа.
  • При слишком быстром истечении срока обратитесь в поддержку с безопасным описанием.
Вопросы и ответы

Вопросы перед подключением Kaspi Pay

Ответы для владельцев магазина и службы поддержки. Проведение QR-платежей подробно разобрано в отдельном руководстве.

Нужен ли аккаунт Kaspi Pay заранее?

Да. Нужны доступ продавца, API-ключ и активная торговая точка. Плагин не предоставляет их.

Можно ли считать заказ оплаченным после появления QR?

Нет. QR и ссылка только начинают попытку. Заказ обновляется после итогового результата.

Что такое торговая точка?

Точка продавца в Kaspi Pay, к которой относятся платежи заказов WooCommerce.

Нужно ли сканировать QR на том же телефоне?

Обычно нет. На телефоне используется платежная ссылка. QR на компьютере сканируют другим устройством.

Что проверить перед запуском?

Контролируемые заказы в KZT: успешную оплату, отмену, истечение срока, незавершенную попытку и ссылку на телефоне.

Есть ли автоматические возвраты?

Нет. Верните деньги в приложении Kaspi Pay, затем отразите возврат в WooCommerce.

Где подробнее прочитать о Kaspi QR?

В отдельном руководстве по QR-платежам и мобильным ссылкам.

Готовый плагин WooCommerce

Подключите Kaspi QR к WooCommerce

Изучите требования и попробуйте KZ Pay в течение 7 дней без банковской карты.

7 дней бесплатно. Банковская карта не нужна.

KZ Pay разработан Group Starlight независимо и не является официальным продуктом Kaspi.kz. Плагин не связан с Kaspi.kz, не одобрен и не спонсируется Kaspi.kz. Товарные знаки принадлежат их владельцам.