Рефералы и Partner API
Реферальная программа (для каждого мерчанта)
- Кабинет → Партнёрство → личный код и ссылка
https://qut.kz/app/login?ref=КОД. - Первая организация мерчанта, зарегистрировавшегося по этой ссылке, закрепляется за вами (
referred_by). - Каждый раз, когда он оплачивает тариф, вам начисляется 20 % от суммы (
REFERRAL_PERCENT) (referral_earnings, статусaccrued). - Выплату платформа делает вручную: Платформа → Вознаграждения → «Выплачено» (
paid_out).
Partner API (интеграторы, веб-студии, франшизы)
Условие: организация на тарифе «Партнёр» (устанавливает платформа) и у API-ключа есть scope partner:manage.
Тариф «Партнёр» — 79 900 ₸/мес, до 30 000 счетов в месяц (счета организаций клиентов сюда не входят — они идут через их кассиров). Тариф включает платформа (напишите нам), дальше партнёр оплачивает его сам со страницы «Партнёрство» в кабинете через Kaspi. На той же странице есть форма «Открыть организацию клиента» и список клиентов: организацию можно открыть без кода, указав номер владельца, и получить API-ключ клиента (показывается один раз); список совпадает с ответом GET /api/v1/partner/organizations.
| Метод | Что делает | ||
|---|---|---|---|
POST /api/v1/partner/organizations {name, ownerPhone, ownerName?, legalName?, idn?} | Открывает клиенту организацию: аккаунт владельца (создаётся, если его нет), sandbox + 7 дней пробного периода, владелец партнёра становится участником с ролью developer, в ответе apiKey (показывается один раз) | ||
GET /api/v1/partner/organizations | Список клиентов: режим, тариф, статистика платежей, активные подключения Kaspi | ||
GET /api/v1/partner/organizations/{id} | Организация + подключения | ||
POST …/{id}/connections → …/{cid}/kaspi/init → send-phone {processId, phone} → verify-otp {processId, otp} | Подключение кассира Kaspi клиента (SMS-код приходит на телефон кассира) | ||
POST …/{id}/mode {mode: 'live'} | Перевод в live-режим (нужно активное подключение) | ||
POST …/{id}/api-keys {name, scopes?} | Новый ключ для клиента | ||
GET …/{id}/members, `POST …/{id}/members {phone | email, role: manager | developer, name?}, DELETE …/{id}/members/{accountId}` | Сотрудники клиента: список, добавить, удалить. Владельца меняет только сам клиент; не более 10 сотрудников в организации |
DELETE /api/v1/partner/organizations/{id} | Закрыть (архивировать) клиента, открытого по ошибке — только если организация никогда не использовалась: нет счетов, владелец не входил. Иначе 409 client_in_use — закрытие решает владелец клиента в кабинете (Настройки → «Закрыть организацию»). Закрытие = архивация: счета и журнал сохраняются, ключи и кассиры отключаются | ||
GET /api/v1/partner/earnings | Реферальный код, клиенты, начисленное вознаграждение |
Счетами клиента партнёр управляет ключом клиента (/api/v1/invoices) или просматривает их, войдя в кабинет.
Роль «партнёр». Владелец и разработчики организации-партнёра автоматически входят в каждую организацию клиента с ролью «партнёр» (клиенты видны в переключателе организаций). Роль выше developer: создаёт ключи, webhook, счета, может оплатить тариф, добавлять и удалять менеджеров/разработчиков клиента — но не может менять или удалять владельца и закрывать организацию. Если сотрудник покидает организацию партнёра, доступ ко всем клиентам прекращается сразу; сотрудники с ролью менеджер в клиентов не входят. Владелец клиента в любой момент может прекратить доступ партнёра (Настройки → «Доступ партнёра»): реферальная связь сохраняется, добавленные партнёром сотрудники остаются. На странице «Партнёрство» в кабинете у каждого клиента есть раздел «Сотрудники».
Полное описание: https://api.qut.kz/docs (тег Partner).
Нужна помощь? WhatsApp +77788813333 · kazprose@gmail.com · 09:00–21:00 (Алматы)
Можно написать и из кабинета: Поддержка.
Qut Pay — независимый сервис, не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки правообладателя.