Как подключить Kaspi Pay к сайту

Регистрация в ApiPay.kz

Создайте аккаунт на платформе ApiPay.kz. Это займёт менее минуты.

• Перейдите на apipay.kz/login
• Войдите по номеру телефона — вход подтверждается в WhatsApp, при первом входе аккаунт создаётся автоматически
• Указывайте свой личный номер (владельца или руководителя) — на него будут приходить уведомления о счетах и ошибках. Это не номер кассира

Подключите кассира Kaspi

Подключить кассира можно двумя способами. Подробная инструкция

• Сами в кабинете: Настройки → «Авторизация Kaspi», около 1 минуты, в любое время
• Через поддержку: сначала зарегистрируйтесь на apipay.kz (шаг 1), затем напишите в WhatsApp и укажите ваш ID из личного кабинета — подключим за 15–30 минут
• В обоих случаях Kaspi Pay подключается с правами Кассира

Получите доступ

После подключения кассира организация появляется в личном кабинете.

• При самостоятельном подключении доступ открывается сразу
• Через поддержку — обычно 15-30 минут в рабочее время
• После подключения вы увидите организацию в личном кабинете

Получите API ключ

API ключ нужен для аутентификации запросов к ApiPay.kz API.

• После успешной верификации ключ появится в личном кабинете
• Скопируйте ключ и сохраните в безопасном месте
• Используйте его в заголовке X-API-Key для всех запросов

Интеграция на сайт

Добавьте код для создания счетов при оформлении заказа.

// Создание счёта
const response = await fetch('https://api.apipay.kz/api/v1/invoices', {
  method: 'POST',
  headers: {
    'X-API-Key': 'ВАШ_API_КЛЮЧ',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 15000,                    // Сумма в тенге
    phone_number: '87001234567',      // Телефон клиента
    description: 'Заказ #123',        // Описание
    external_order_id: 'order_123'    // Ваш ID заказа
  })
})

const { id, amount, status, created_at } = await response.json()

// Клиент получит push-уведомление в Kaspi и оплатит
console.log('Invoice created:', id)

Настройка Webhook

Webhook позволяет получать уведомления об оплате в реальном времени.

• Перейдите в личный кабинет → Настройки → Подключение
• Укажите URL вашего webhook-обработчика
• Сохраните secret-ключ (показывается один раз)
• При создании счёта можно указать webhook_id для выбора конкретного webhook

ApiPay.kz отправит POST-запрос на ваш URL при изменении статуса счёта:

{
  "event": "invoice.status_changed",
  "invoice": {
    "id": 42,
    "external_order_id": "order_123",
    "status": "paid",
    "amount": "15000.00",
    "paid_at": "2025-01-22T10:30:00Z"
  }
}

Тестирование

Проверьте интеграцию от начала до конца.

• Создайте тестовый счёт на небольшую сумму
• Оплатите его со своего Kaspi
• Убедитесь, что webhook пришёл и заказ обновился