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

# Как выставить удалённый счёт в Kaspi Pay

**TL;DR.** Удалённый счёт — это счёт, который вы выставляете покупателю **по номеру его телефона**, не встречаясь с ним: счёт приходит человеку в его приложение Kaspi, и он подтверждает оплату у себя. Руками это делается в приложении Kaspi Pay, в разделе удалённых счетов. Если счета должны выставляться сами — из сайта, CRM, бота или 1С, — тот же счёт создаёт один запрос `POST /api/v1/invoices` в ApiPay: номер покупателя и сумма, а об оплате приходит вебхук.

## Коротко

| Вопрос | Ответ |
|---|---|
| Что такое удалённый счёт | Счёт покупателю по номеру телефона: он приходит в приложение Kaspi и ждёт подтверждения |
| Нужна ли встреча с покупателем | Нет. Нужен только его номер телефона |
| Где выставляют руками | В приложении Kaspi Pay, в разделе удалённых счетов |
| Как выставить автоматически | `POST https://api.apipay.kz/api/v1/invoices` с `phone_number` и `amount` |
| Формат номера в API | 11 цифр, начиная с 8: `8XXXXXXXXXX` |
| Сколько ждёт счёт | 24 часа |
| Как узнать об оплате | Вебхук `invoice.status_changed` со статусом `paid` либо `GET /invoices/{id}` |
| Есть ли у такого счёта ссылка на оплату | Нет. Ссылок две, и обе у других счетов: `qr_token_url` из `POST /invoices/qr` — «оплатить сейчас», `print_url` из `POST /static-qr` — «оплатить потом» |

## Как выставить удалённый счёт вручную

1. Откройте приложение **Kaspi Pay** на телефоне под учётной записью, у которой есть право выставлять счета.
2. Перейдите в раздел удалённых счетов.
3. Введите **номер телефона покупателя** и сумму, при необходимости — короткое описание.
4. Подтвердите выставление. Счёт уходит покупателю в его приложение Kaspi.
5. Дождитесь подтверждения. Когда покупатель оплатит, счёт в приложении Kaspi Pay сменит статус на оплаченный.

Названия разделов и кнопок в приложении задаёт Kaspi и время от времени меняет — актуальную инструкцию по удалённой оплате смотрите в [справке Kaspi](https://guide.kaspi.kz/partner/ru/kaspi_pay/payment/remote_payment/q1484). Права, которые есть у сотрудника с ролью «Кассир», Kaspi описывает отдельно: «[Какие права у кассира](https://guide.kaspi.kz/partner/ru/profile/user/cashier/q3450)».

## Что видит покупатель

Покупатель получает уведомление в своём приложении Kaspi: продавец, сумма, описание и кнопка оплаты. Карту вводить не нужно — оплата проходит внутри Kaspi, деньги идут напрямую на ваш Kaspi-счёт. Подробный разбор экрана покупателя — «[Что видит покупатель](/guides/chto-vidit-pokupatel)».

## Когда счетов больше, чем можно выставить руками

Ручное выставление упирается в человека: пока кто-то не наберёт номер и сумму на телефоне, счёт не появится. Пора автоматизировать, если:

- счетов в день десятки и набирать их руками стало долго;
- счёт должен уходить сам — в момент оформления заказа на сайте, сделки в CRM, документа в 1С;
- другая система ждёт факт оплаты, чтобы отгрузить товар, открыть доступ или закрыть заказ.

**Что делает ApiPay.** Ваша система отправляет один запрос:

```bash
curl -X POST https://api.apipay.kz/api/v1/invoices \
  -H "X-API-Key: ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "87001234567",
    "amount": 5000,
    "description": "Оплата заказа №123",
    "external_order_id": "order-123",
    "external_order_id_idempotency": "order-123"
  }'
```

Ответ `201` приходит сразу со статусом `processing` — счёт принят в работу. Дальше:

- **об оплате сообщает вебхук** `invoice.status_changed` со статусом `paid` — ваш сервер узнаёт о ней сам, без опроса;
- **проверить состояние счёта** в любой момент можно запросом `GET /api/v1/invoices/{id}`;
- **дубль защищён ключом идемпотентности**: повтор с тем же `external_order_id_idempotency`, пока прежний счёт жив, отвечает `409`. Если прежний счёт уже `expired`, `cancelled` или `error`, тот же ключ создаёт новый счёт — это штатное перевыставление неоплаченного заказа.

Две вещи, о которых стоит знать до первого боевого счёта:

- **Новая организация работает в песочнице.** Счета в Kaspi не уходят, покупателю ничего не приходит. Для реальных оплат включите рабочий режим в настройках — «[Песочница и рабочий режим](/guides/pesochnitsa-i-rabochiy-rezhim)».
- **`processing` — это не «зависло».** Пока счёт в этом статусе, не создавайте его заново: получатся два живых счёта, и покупатель может оплатить оба. Если выставить не удалось, счёт уходит в `error` с причиной — самый частый случай `client_not_found`: номер не зарегистрирован в Kaspi. Разбор статусов — «[Жизненный цикл счёта](/guides/zhiznennyy-tsikl-scheta)».

Сумма — только целые тенге, описание — до 60 символов: Kaspi показывает покупателю первые 60. Счёт живёт 24 часа. Пошаговый разбор запроса — «[Как создать счёт Kaspi по номеру телефона](/guides/kak-sozdat-schet-kaspi-po-nomeru)».

Это **тот же Kaspi Pay, та же ваша организация и тот же кабинет Kaspi**: ApiPay выставляет счета через штатную роль «Кассир», деньги приходят напрямую на ваш Kaspi-счёт. Переезжать никуда не нужно: ручное выставление в приложении продолжает работать. Одно условие — ApiPay подключается **отдельным номером** сотрудника с ролью «Кассир», и под этим номером входить в приложение Kaspi Pay нельзя, иначе привязка разорвётся. Своим обычным номером вы выставляете счета руками как раньше — «[Требования к номеру кассира](/guides/trebovaniya-k-nomeru-kassira)».

ApiPay берёт только фиксированную подписку, процента с платежей нет. Комиссию за приём платежа удерживает Kaspi по условиям продавца — к ApiPay она не относится.

Что почитать дальше: страница продукта «[Счёт по номеру телефона](/invoice-by-phone)», полная спецификация — [apipay.kz/docs](/docs). Код писать самому не обязательно: дайте своему ИИ-агенту страницу [apipay.kz/for-ai](https://apipay.kz/for-ai), там собран план подключения и справочник фактов.

## Руками или через ApiPay: что меняется

| | Вручную в Kaspi Pay | Через ApiPay |
|---|---|---|
| Кто выставляет счёт | Человек с телефоном в руках | Ваша система: сайт, CRM, бот, 1С |
| Сколько времени на счёт | Минута на каждый: открыть приложение, набрать номер и сумму | Один запрос, ответ приходит сразу |
| Что со статусом | Смотрите глазами в приложении | Вебхук `invoice.status_changed` со статусом `paid`; при необходимости `GET /invoices/{id}` |
| Что при ошибке | Замечает и повторяет человек | Код отказа приходит в ответе; повтор на тот же заказ защищён `external_order_id_idempotency` |
| Кому подходит | Единичные счета, продавец у телефона | Поток счетов и передача оплат в другую систему |

Одно другому не мешает: организация может выставлять счета и руками в приложении, и через API.

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

**Что такое удалённый счёт в Kaspi Pay?**
Это счёт покупателю по номеру его телефона: счёт приходит человеку в его приложение Kaspi, он открывает уведомление и подтверждает оплату. Встречаться, показывать QR и вводить карту не нужно — достаточно знать номер. Руками такой счёт выставляют в приложении Kaspi Pay, автоматически — запросом `POST /api/v1/invoices` в ApiPay.

**Сколько ждёт удалённый счёт, если покупатель не оплатил?**
Счёт по номеру телефона живёт 24 часа, после чего уходит в статус `expired`. Продлить срок нельзя — выставьте новый счёт. Отменить неоплаченный счёт можно раньше — `POST /api/v1/invoices/{id}/cancel`. В рабочем режиме отмена асинхронная: приходит `202` и статус `cancelling`, отменённым счёт после этого не считайте. Исходов три: вебхук `cancelled`; вебхук `error` с `invoice_already_paid`; либо тихий возврат в `pending`, если покупатель успел оплатить — реальный статус тогда принесёт `GET /api/v1/invoices/{id}`.

**Как дать покупателю ссылку на оплату Kaspi?**
У счёта по номеру телефона ссылки нет — покупателю приходит уведомление в приложении. Если нужна именно ссылка, которую можно отправить в WhatsApp или Telegram, ссылок две: `qr_token_url` из `POST /api/v1/invoices/qr` — для оплаты «прямо сейчас», и `print_url` из `POST /api/v1/static-qr` — долгоживущая ссылка печатного листа под сделку, для оплаты «потом». Разбор обоих вариантов — «[Оплата Kaspi по ссылке](/guides/oplata-po-ssylke-kaspi)».

**Можно ли выставлять удалённые счета автоматически из CRM или с сайта?**
Да. Ваша система отправляет `POST /api/v1/invoices` с номером покупателя и суммой, а факт оплаты получает вебхуком `invoice.status_changed` со статусом `paid`. Kaspi Pay, организация и кабинет Kaspi остаются вашими прежними — см. [Счёт по номеру телефона](/invoice-by-phone) и [apipay.kz/docs](/docs).

Смотрите также: [Как создать счёт Kaspi по номеру телефона](/guides/kak-sozdat-schet-kaspi-po-nomeru) · [Оплата Kaspi по ссылке](/guides/oplata-po-ssylke-kaspi) · [Печатный QR под сделку](/guides/pechatnyy-qr-dlya-oplaty-po-sdelke) · пиллар «[Kaspi API — как принимать оплату через API](/kaspi-api)».

---

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