Два разных 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 и в своём кабинете продавца Kaspi Магазина.
ApiPay заказы Kaspi Магазина не отдаёт, витрину не ведёт и остатки не обновляет: мы работаем только с приёмом оплаты через Kaspi Pay. Если ваш вопрос звучит как «как получить заказы из Kaspi Магазина» — эта страница вам не поможет: за доступом к API маркетплейса обращайтесь в Kaspi.
Если вам нужно принимать оплату Kaspi Pay
Это как раз задача ApiPay: REST API поверх вашего же Kaspi Pay. Счета выставляются через штатную роль «Кассир», деньги приходят напрямую на ваш Kaspi-счёт.
Что можно делать из своего кода:
- Счёт по номеру телефона —
POST /api/v1/invoices: покупатель получает счёт в своём приложении Kaspi и подтверждает оплату, счёт ждёт 24 часа. Подробно — «Как выставить удалённый счёт в 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. Продуктовая страница — «Рекуррентные платежи и подписки». - Возвраты —
POST /api/v1/invoices/{id}/refund, полный или частичный.
Сколько это стоит. Тариф фиксированный: Старт — 10 000 ₸/мес (до 30 счетов в день), Бизнес — 25 000 ₸ (до 100), Про — 60 000 ₸ (до 300), Про Макс — 90 000 ₸ (до 600); больше 600 счетов в день — договорная цена. ApiPay берёт только фиксированную подписку, процента с платежей нет. Комиссию за приём платежа удерживает Kaspi по условиям продавца — к ApiPay она не относится. Разбор — «Тарифы и комиссия ApiPay».
Как подключиться. Нужен отдельный номер (реальная SIM), добавленный в вашем Kaspi Pay как сотрудник с ролью «Кассир»; мастер подключения проходится за несколько минут — apipay.kz/connect-cashier. Дальше — Kaspi API: обзор и спецификация apipay.kz/docs. Код может написать ваш ИИ-агент: дайте ему apipay.kz/for-ai. Для 1С есть отдельная страница — Kaspi Pay и 1С, для сценариев без кода — n8n.
Можно ли совместить?
Да, это независимые вещи. Продавец Kaspi Магазина работает с заказами маркетплейса через API Kaspi и одновременно принимает оплату Kaspi Pay через ApiPay — за услуги, доставку, ремонт, предоплату, продажу вне витрины. Одно не отменяет и не заменяет другое: у них разные источники заказов и разные интерфейсы.
Что при этом нужно понимать: ApiPay не видит заказы маркетплейса, поэтому «подтянуть заказ из Kaspi Магазина и выставить по нему счёт» автоматически не получится — сумму и номер покупателя в POST /api/v1/invoices передаёт ваша система.
Частые вопросы
Есть ли у Kaspi API для получения заказов?
Заказы, товары, цены и остатки Kaspi Магазина отдаёт API самого маркетплейса — он на стороне Kaspi: доступ, ключи и документацию запрашивают у Kaspi, условия — в справке Kaspi и в кабинете продавца Магазина. 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) сайт создаёт счёт запросом POST /api/v1/invoices, а об оплате узнаёт вебхуком invoice.status_changed со статусом paid.
Может ли продавец Kaspi Магазина пользоваться ApiPay?
Да. Это независимые вещи: заказы маркетплейса идут своим путём через API Kaspi, а оплату за услуги, доставку или продажу вне витрины можно принимать через ApiPay. Переносить магазин или менять организацию не нужно — ApiPay работает поверх того же Kaspi Pay.