> Источник: https://apipay.kz/guides/kaspi-api-zakazy-ili-oplata · Обновлено: 2026-09-06 · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

# Kaspi API: заказы магазина или приём оплаты — какое API вам нужно

**TL;DR.** Под «Kaspi API» люди ищут две совершенно разные вещи. Если нужны **заказы, товары, цены и остатки Kaspi Магазина** — это API самого маркетплейса (в поиске его называют Kaspi Merchant API или Kaspi Shop API); он на стороне Kaspi, и за доступом и документацией обращаются к Kaspi — [справка Kaspi](https://guide.kaspi.kz/). Если нужно **принимать оплату Kaspi Pay в своём сайте, CRM, боте или 1С** — это ApiPay: REST API поверх вашего же Kaspi Pay, счёт создаётся одним запросом `POST /api/v1/invoices`. Заказами маркетплейса ApiPay не занимается.

## Коротко

| Вопрос | Ответ |
|---|---|
| Нужны заказы Kaspi Магазина | Это API маркетплейса, он на стороне Kaspi — за доступом к Kaspi |
| Нужны товары, цены, остатки на витрине Kaspi | Тоже API маркетплейса, к ApiPay отношения не имеет |
| Нужно выставить счёт покупателю и получить деньги | Это ApiPay: `POST /api/v1/invoices` (по номеру телефона) или `POST /api/v1/invoices/qr` (ссылка и QR) |
| Нужно узнать, что заказ оплачен | Вебхук `invoice.status_changed` со статусом `paid` |
| Делает ли ApiPay что-то с заказами маркетплейса | Нет |
| Одно исключает другое | Нет. Продавец Kaspi Магазина может параллельно принимать оплату Kaspi Pay через ApiPay |

## Два разных API: что кому нужно

| Задача | Какое API нужно | Кто его выдаёт | Что делает ApiPay |
|---|---|---|---|
| Получить список заказов Kaspi Магазина | API Kaspi Магазина | Kaspi | Нет |
| Подтвердить или отменить заказ маркетплейса | API Kaspi Магазина | Kaspi | Нет |
| Обновить цены и остатки на витрине Kaspi | API Kaspi Магазина | Kaspi | Нет |
| Выставить покупателю счёт по номеру телефона | ApiPay поверх Kaspi Pay | ApiPay | `POST /api/v1/invoices` |
| Дать ссылку на оплату или QR-код | ApiPay поверх Kaspi Pay | ApiPay | `POST /api/v1/invoices/qr`, `POST /api/v1/static-qr` |
| Узнать об оплате автоматически | ApiPay поверх Kaspi Pay | ApiPay | Вебхуки `invoice.status_changed`, `invoice.qr_scanned`, `invoice.refunded` |
| Сделать возврат из своей системы | ApiPay поверх Kaspi Pay | ApiPay | `POST /api/v1/invoices/{id}/refund` |

Простое правило: **товар на витрине Kaspi Магазина — к Kaspi; деньги в вашем собственном сервисе — к ApiPay.**

## Если вам нужны заказы Kaspi Магазина

Идите к Kaspi. Доступ к API маркетплейса, ключи и документация — на стороне Kaspi: условия уточняйте в [справке Kaspi](https://guide.kaspi.kz/) и в своём кабинете продавца Kaspi Магазина.

ApiPay заказы Kaspi Магазина не отдаёт, витрину не ведёт и остатки не обновляет: мы работаем только с приёмом оплаты через Kaspi Pay. Если ваш вопрос звучит как «как получить заказы из Kaspi Магазина» — эта страница вам не поможет: за доступом к API маркетплейса обращайтесь в Kaspi.

## Если вам нужно принимать оплату Kaspi Pay

Это как раз задача ApiPay: REST API поверх **вашего же** Kaspi Pay. Счета выставляются через штатную роль «Кассир», деньги приходят напрямую на ваш Kaspi-счёт.

Что можно делать из своего кода:

- **Счёт по номеру телефона** — `POST /api/v1/invoices`: покупатель получает счёт в своём приложении Kaspi и подтверждает оплату, счёт ждёт 24 часа. Подробно — «[Как выставить удалённый счёт в Kaspi Pay](/guides/udalyonnyy-schet-kaspi-pay)».
- **Ссылка на оплату и QR** — `POST /api/v1/invoices/qr` возвращает `qr_token_url` (отправить в чат) и `qr_image_url` (показать на экране). Для оплаты «потом» есть печатный лист под сделку: `POST /api/v1/static-qr` с долгоживущим `print_url`.
- **Уведомление об оплате** — вебхук `invoice.status_changed` со статусом `paid`; у QR-счёта дополнительно приходит `invoice.qr_scanned`, у возвратов — `invoice.refunded`.
- **Регулярные счета** — `POST /api/v1/subscriptions`: очередной счёт выставляется по расписанию, платит покупатель подтверждением в Kaspi. Продуктовая страница — «[Рекуррентные платежи и подписки](/recurring-payments-kaspi)».
- **Возвраты** — `POST /api/v1/invoices/{id}/refund`, полный или частичный.

**Сколько это стоит.** Тариф фиксированный: Старт — 10 000 ₸/мес (до 30 счетов в день), Бизнес — 25 000 ₸ (до 100), Про — 60 000 ₸ (до 300), Про Макс — 90 000 ₸ (до 600); больше 600 счетов в день — договорная цена. ApiPay берёт только фиксированную подписку, процента с платежей нет. Комиссию за приём платежа удерживает Kaspi по условиям продавца — к ApiPay она не относится. Разбор — «[Тарифы и комиссия ApiPay](/guides/tarify-i-komissiya-apipay)».

**Как подключиться.** Нужен отдельный номер (реальная SIM), добавленный в вашем Kaspi Pay как сотрудник с ролью «Кассир»; мастер подключения проходится за несколько минут — [apipay.kz/connect-cashier](/connect-cashier). Дальше — [Kaspi API: обзор](/kaspi-api) и спецификация [apipay.kz/docs](/docs). Код может написать ваш ИИ-агент: дайте ему [apipay.kz/for-ai](https://apipay.kz/for-ai). Для 1С есть отдельная страница — [Kaspi Pay и 1С](/kaspi-pay-1c), для сценариев без кода — [n8n](/n8n-integration).

## Можно ли совместить?

Да, это независимые вещи. Продавец Kaspi Магазина работает с заказами маркетплейса через API Kaspi и одновременно принимает оплату Kaspi Pay через ApiPay — за услуги, доставку, ремонт, предоплату, продажу вне витрины. Одно не отменяет и не заменяет другое: у них разные источники заказов и разные интерфейсы.

Что при этом нужно понимать: ApiPay не видит заказы маркетплейса, поэтому «подтянуть заказ из Kaspi Магазина и выставить по нему счёт» автоматически не получится — сумму и номер покупателя в `POST /api/v1/invoices` передаёт ваша система.

## Частые вопросы

**Есть ли у Kaspi API для получения заказов?**
Заказы, товары, цены и остатки Kaspi Магазина отдаёт API самого маркетплейса — он на стороне Kaspi: доступ, ключи и документацию запрашивают у Kaspi, условия — в [справке Kaspi](https://guide.kaspi.kz/) и в кабинете продавца Магазина. ApiPay заказы маркетплейса не отдаёт: наш API — про приём оплаты Kaspi Pay в вашем собственном сервисе.

**Kaspi Pay API — это то же самое, что Kaspi Merchant API?**
Нет, это разные вещи. Merchant API (он же Shop API) — про витрину и заказы Kaspi Магазина. Kaspi Pay — про приём оплаты: покупателю выставляется счёт, он платит в приложении Kaspi. Программный доступ к приёму оплаты Kaspi Pay даёт ApiPay: `POST /api/v1/invoices` для счёта по номеру телефона и `POST /api/v1/invoices/qr` для ссылки или QR.

**Как принимать оплату Kaspi на своём сайте, если я не продавец Kaspi Магазина?**
Магазин на маркетплейсе для этого не нужен. Нужен ваш Kaspi Pay и отдельный номер сотрудника с ролью «Кассир»: после подключения ([apipay.kz/connect-cashier](/connect-cashier)) сайт создаёт счёт запросом `POST /api/v1/invoices`, а об оплате узнаёт вебхуком `invoice.status_changed` со статусом `paid`.

**Может ли продавец Kaspi Магазина пользоваться ApiPay?**
Да. Это независимые вещи: заказы маркетплейса идут своим путём через API Kaspi, а оплату за услуги, доставку или продажу вне витрины можно принимать через ApiPay. Переносить магазин или менять организацию не нужно — ApiPay работает поверх того же Kaspi Pay.

Смотрите также: [Как выставить удалённый счёт в Kaspi Pay](/guides/udalyonnyy-schet-kaspi-pay) · [Как создать счёт Kaspi по номеру телефона](/guides/kak-sozdat-schet-kaspi-po-nomeru) · [Тарифы и комиссия ApiPay](/guides/tarify-i-komissiya-apipay) · пиллар «[Kaspi API — как принимать оплату через API](/kaspi-api)».

---

ApiPay — независимый сервис и не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.
База знаний: https://apipay.kz/guides