Платёжный виджет WhatsApp для сайта

01Что увидит покупатель

На странице заказа появляется сумма и кнопка «Оплатить через Kaspi». После перехода к оплате покупателю приходит сообщение в WhatsApp. Он оплачивает заказ и отправляет PDF-чек в ответ. Виджет показывает, когда заказ подтверждён. Деньги поступают напрямую на ваш Kaspi Pay.

Виджет работает с конкретным заказом: сумма, получатель и телефон покупателя задаются в WAIX. Покупатель не может изменить их в форме. Поступление денег и возвраты проверяются в Kaspi Pay; статус WAIX подтверждается по чеку.

02Установить без разработки

1. 01
   Откройте «Оплаты Kaspi → Настройки», заполните получателя, выберите номер и одобренный шаблон. Включите приём оплат.
2. 02
   Перейдите во вкладку «Виджет для сайта» и нажмите «Новый заказ». Укажите WhatsApp покупателя и сумму.
3. 03
   Скопируйте форму или кнопку. Вставьте код в HTML-блок персональной страницы заказа на вашем сайте.
4. 04
   Откройте предпросмотр. Сообщение отправляется только после перехода по кнопке в Kaspi, а не при показе формы.

Для каждого заказа нужен свой виджет. Не публикуйте персональные ссылки в общем каталоге и не отправляйте их другим покупателям. Форма адаптируется к ширине экрана. Если ваш сайт использует Content-Security-Policy, разрешите https://pay.waix.kz в frame-src.

03Автоматически для интернет-магазина

На сервере магазина создайте запрос POST /api/v1/payments/kaspi. Передайте сумму, телефон покупателя, номер заказа и delivery="on_open". Используйте один Idempotency-Key на заказ. Сервер WAIX вернёт widget_url — вставьте его в iframe на странице этого заказа. API-ключ храните только на сервере.

{
  "amount": 12500,
  "phone": "+77071234567",
  "order_number": "123",
  "delivery": "on_open"
}

<iframe src="WIDGET_URL_ИЗ_ОТВЕТА_API" title="Оплата заказа через WhatsApp" width="100%" height="700" style="max-width:500px;border:0;border-radius:20px" loading="lazy" referrerpolicy="no-referrer"></iframe>

delivery="immediate" — отправить сообщение сразу, прежнее поведение по умолчанию. delivery="on_open" — после перехода к оплате. Повторное открытие ссылки не создаёт новое сообщение.

04Как узнать об оплате

Подключите вебхук payment.paid. Проверяйте подпись и сохраняйте ID события, чтобы повторная доставка не обработала заказ второй раз. Для проверки вручную используйте GET /api/v1/payments/kaspi/{id}. Не считайте переход в Kaspi подтверждением оплаты и не используйте сообщения iframe как основание для выдачи товара.

Отмена или истечение срока закрывает виджет. Если чек не подходит, статус оплаты не меняется; причина доступна в разделе «Чеки». Срок ожидания задаётся в настройках получателя.