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

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

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

• Перейдите на apipay.kz/login
• Укажите email и создайте пароль
• Подтвердите email (опционально)

Подключите организацию через поддержку

Напишите нам в WhatsApp — мы подключим ваш Kaspi Business с правами Кассира.

• Напишите в WhatsApp поддержки
• Укажите ваш ID из личного кабинета
• Мы подключим Kaspi Business с правами Кассира
• Обычно это занимает 5-30 минут

Дождитесь подтверждения

Мы подключим вашу организацию и сообщим вам в WhatsApp.

• Обычно подключение занимает 5-30 минут в рабочее время
• После подключения вы увидите организацию в личном кабинете

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

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

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

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

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

// Создание счёта
const response = await fetch('https://bpapi.bazarbay.site/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 пришёл и заказ обновился