# ApiPay.kz API

> Интернет-эквайринг через Kaspi Pay. API для приёма платежей по номеру телефона в Казахстане. Без договора с банком, без комиссий.

## Docs

- [HTML Documentation](https://baypay.bazarbay.site/docs.html): Полная документация с примерами кода на JS, Python, PHP
- [Markdown Documentation](https://baypay.bazarbay.site/apipay-api-docs.md): Для парсинга ИИ-агентами
- [OpenAPI Specification](https://baypay.bazarbay.site/openapi.json): OpenAPI 3.0 спецификация

## API

- Base URL: `https://bpapi.bazarbay.site/api`
- Auth: Header `X-API-Key: your_key`
- Rate Limit: 60 requests/minute

## Endpoints

- [POST /organizations/verify]: Верификация организации по ИИН/БИН
- [GET /organizations/:id/status]: Статус верификации (polling)
- [POST /invoices]: Создание счёта на оплату (поддерживает webhook_id для выбора webhook)
- [GET /invoices]: Список счетов
- [POST /invoices/:id/cancel]: Отмена счёта

## Webhooks

Webhooks настраиваются через личный кабинет ApiPay.kz (Настройки → Подключение).
При создании webhook вы получите secret для верификации подписи.
При создании счёта можно указать webhook_id для отправки уведомления на конкретный webhook.

## Quick Start

1. Войдите в личный кабинет: https://baypay.bazarbay.site/login
2. В Kaspi Business добавьте номер 77056610934 как "Кассир"
3. POST /organizations/verify с вашим ИИН/БИН
4. Дождитесь статуса "verified" (polling каждые 2 сек)
5. POST /invoices для создания счёта
6. Редирект клиента на payment_url
7. Настройте webhook в личном кабинете для уведомлений

## Example

```javascript
const response = await fetch('https://bpapi.bazarbay.site/api/invoices', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 10000,
    phone_number: '87001234567'
  })
})
const { payment_url } = await response.json()
// Redirect customer to payment_url
```

## Optional

- [Login](https://baypay.bazarbay.site/login): Войти в личный кабинет
- [FAQ](https://baypay.bazarbay.site/faq): Частые вопросы
- [WhatsApp Support](https://wa.me/77085167489): Техподдержка