Kaspi Pay в 1С: выставление счетов из 1С

Многие ведут учёт в 1С и хотят принимать оплату через Kaspi, но 1С сама не умеет выставлять счета в Kaspi Pay. Готового официального модуля Kaspi для 1С нет. Принимать «каспи в 1с» можно через REST API ApiPay: программа 1С обращается к ApiPay, создаёт счёт по номеру телефона клиента, а после оплаты автоматически проводит платёж. Интеграцию настраивает 1С-специалист — это не плагин «в один клик».

Проблема: почему 1С сама не принимает Kaspi Pay

1С (Бухгалтерия, УНФ, Управление торговлей и другие конфигурации) ведёт учёт продаж, но напрямую с Kaspi Pay не связана. У Kaspi нет готового официального модуля для 1С, который выставлял бы счета прямо из программы. Поэтому «интеграция каспи 1с» силами одной типовой конфигурации невозможна — нужен внешний мост между 1С и Kaspi Pay.

Решение: REST API-мост ApiPay

ApiPay — это REST API поверх вашего Kaspi Pay. 1С обращается к ApiPay обычным HTTP-запросом и выставляет счёт клиенту. Сценарий «выставление счетов из 1с» выглядит так:

1. 1С (Бухгалтерия / УНФ / Управление торговлей — любая конфигурация, откуда можно сделать HTTP-запрос) вызывает ApiPay API и создаёт счёт по номеру телефона клиента (POST /invoices).
2. Клиент получает счёт в приложении Kaspi и оплачивает его привычным способом.
3. 1С узнаёт об оплате: опрашивает статус счёта (GET /invoices/{id}) — основной путь для 1С — либо принимает webhook, если у 1С есть публичный адрес.
4. После подтверждения оплаты 1С автоматически проводит платёж и, при необходимости, отгрузку.

Так «оплата каспи в 1с» отражается в учёте без ручного переноса данных. По сути это тот же счёт по номеру телефона, но выставленный автоматически из вашей программы.

Что нужно для подключения

• Аккаунт Kaspi Pay с правами «Кассира». Кассир подключается в личном кабинете ApiPay — это штатная роль в Kaspi Pay, её описание есть в справке Kaspi. Как это сделать — на странице подключение кассира Kaspi.
• Отдельный номер телефона для кассира. Пока номер привязан, входить в приложение Kaspi Pay под ним не получится — заведите для кассира отдельный номер. Требования к номеру кассира.
• API-ключ ApiPay. Им авторизуются запросы, которые 1С отправляет к ApiPay.
• 1С-специалист. Он встроит вызовы API в вашу конфигурацию 1С. Обмен настраивается через HTTP-сервисы или внешние обработки.

Готового плагина «в один клик» нет: доработку конфигурации выполняет ваш программист 1С. Помочь с подключением кассира и ответить на вопросы может поддержка в WhatsApp: +7 700 307 65 12.

Пример вызова API из 1С

Счёт создаётся одним HTTP-запросом. 1С отправляет:

POST https://api.apipay.kz/api/v1/invoices
X-API-Key: ваш_ключ
Content-Type: application/json

{
  "phone_number": "87001234567",
  "amount": 15000,
  "description": "Оплата заказа №123",
  "external_order_id": "1c-doc-123"
}

В ответе ApiPay возвращает данные счёта, а после оплаты присылает webhook. По полю external_order_id вы связываете платёж с документом 1С и помечаете оплату в программе.

1С штатно повторяет HTTP-запрос при таймауте, а документ можно провести повторно — без ключа идемпотентности так создастся второй счёт и покупатель получит второй push. Передавайте номер документа 1С в двух полях: external_order_id — чтобы найти документ по оплате, и external_order_id_idempotency — чтобы повтор не создал дубль. На повторный запрос с тем же ключом ApiPay отвечает 409 и возвращает invoice_id уже созданного счёта; если прежний счёт истёк или был отменён, по тому же ключу выставляется новый.

Сколько стоит

ApiPay не берёт процент с оборота — оплата по фиксированной месячной подписке:

Комиссии ApiPay с платежей нет — вы платите только фиксированную подписку. Комиссия самого Kaspi за приём платежа остаётся вашей обычной комиссией в Kaspi Pay: ApiPay к ней ничего не добавляет.

Больше 600 счетов в день — договорная цена: напишите в WhatsApp +7 700 307 65 12.

Кому подходит

• Оптовая торговля на 1С. Выставление счёта покупателю прямо из документа программы.
• Розница на 1С. Приём Kaspi без установки и аренды терминала.
• Услуги и работы. Счёт клиенту по номеру телефона прямо из 1С.
• Любой бизнес, который ведёт учёт в 1С и хочет принимать Kaspi без терминала.

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