Коротко
Ссылка на оплату — это постоянный адрес, например qut.kz/p/kofe. После создания он не меняется и не истекает: одну и ту же ссылку можно поставить в шапку профиля Instagram, на визитку, в сообщение WhatsApp или на наклейку в кафе.
Когда покупатель открывает ссылку, в этот момент создаётся новый счёт, и он оплачивает его через Kaspi. То есть ссылка — это не счёт, а «кран», который выпускает счета.
Писать код не нужно: ссылка создаётся в разделе Ссылки в кабинете.
Чем отличается от ссылки на счёт
Эти две вещи часто путают.
Ссылка на оплату (qut.kz/p/<slug>) | Ссылка на счёт (payUrl) | |
|---|---|---|
| Когда создаётся | Один раз, вручную | На каждый счёт, автоматически |
| Адрес | Выбираете сами | Генерируется случайно |
| Срок | Бессрочная | Ограничен окном оплаты счёта |
| Сколько раз оплачивается | Сколько угодно, у каждого свой счёт | Один раз |
| Куда ставится | Профиль, визитка, наклейка, письмо | Редирект со страницы заказа |
| Для кого | Кто работает без кода | Сайт, приложение, интеграция |
Короткое правило: один заказ — ссылка на счёт, постоянное предложение — ссылка на оплату.
Создание
Кабинет → Ссылки → добавить ссылку. Заполняете:
| Поле | Что указывается |
|---|---|
| Адрес (slug) | Часть после qut.kz/p/: kofe, konsultaciya, donat |
| Название | Покупатель видит на странице оплаты |
| Сумма | Фиксированная или открытая |
| Тип | QR или счёт по телефону |
| Описание | Дополнительный текст на странице оплаты |
В адресе допустимы строчные латинские буквы, цифры и дефис. Кириллица и пробелы не подойдут.
Выбирайте свободный адрес: если такой уже занят, придёт ошибка slug_taken. Берите короткое и легко произносимое слово — покупателю, возможно, придётся набирать его вручную.
Фиксированная и открытая сумма
Фиксированная сумма. Сумма зашита в ссылку, покупатель её не меняет. Удобно для того, у чего одна цена: консультация, абонемент, один товар.
Открытая сумма. Сумму вводит сам покупатель. Нужна, когда:
- у каждого клиента своя сумма (индивидуальный заказ, объём работ);
- вы принимаете заранее оговорённую сумму (предоплата, депозит);
- это донат, благотворительность или чаевые.
Для открытой суммы можно задать минимум и максимум — чтобы покупатель не ввёл сумму по ошибке.
Ограничения суммы те же, что у обычного счёта: у QR допустимы два знака после запятой, у счёта по телефону — только целые тенге. Разбор различий: QR-счёт или счёт по телефону.
Остановка и возобновление
Ссылку можно приостановить, не удаляя. При открытии остановленной ссылки покупатель видит сообщение, что оплата временно недоступна, а ранее созданные по ней счета остаются в силе.
Например:
- закончился сезонный товар — останавливаете, в следующем сезоне включаете обратно;
- закончилась акция — ставите на паузу, пока меняете цену;
- ссылка разошлась не туда — останавливаете и разбираетесь.
Возобновление — там же, одной кнопкой. Адрес сохраняется, поэтому ссылки в рекламе и на визитках продолжают работать.
Удаление — окончательное. Удалённый адрес вернуть нельзя, так что при малейшем сомнении ограничьтесь остановкой.
Отчётность: сколько принесла каждая ссылка
В каждом счёте сохраняется, из какой ссылки он создан. Благодаря этому:
- в разделе Ссылки видно количество счетов и оплаченную сумму по каждой ссылке;
- в разделе Счета можно отфильтровать по ссылке;
- в CSV-экспорте источник выгружается отдельной колонкой — годится и для бухгалтерии, и для анализа.
Практический приём: если хотите мерить рекламные каналы, заведите отдельную ссылку на каждый канал — p/insta, p/tiktok, p/vizitka. Содержимое может быть одинаковым, зато в отчёте сразу видно, какой канал сколько принёс.
Коды ошибок
| Код | HTTP | Что случилось | Что делать |
|---|---|---|---|
slug_taken | 409 | Такой адрес уже занят | Выберите другое имя |
link_invalid | 410 | Ссылка недействительна или удалена | Создайте новую |
link_paused | 410 | Ссылка остановлена | Включите её обратно в кабинете |
too_many_links | 409 | Превышено количество ссылок | Удалите ненужные или посмотрите тариф |
Если покупатель жалуется, что ссылка не открывается, первым делом проверьте, не стоит ли она на паузе — link_paused самая частая причина.
Счета, созданные через ссылку, тоже входят в лимит тарифа, поэтому при исчерпании лимита ссылка перестанет выпускать счета.
Кому это удобно
| Ситуация | Как используется |
|---|---|
| Продажи через Instagram | Ссылка в профиле или ответ в директе |
| Фрилансер, частный специалист | Одна ссылка клиенту в WhatsApp |
| Кафе, небольшой магазин | Наклейка на кассе или на столе |
| Мероприятие, билеты | Ссылка с открытой суммой или несколько уровней цены |
| Курс, консультация | Отдельная ссылка на каждую услугу |
Если программиста нет, ссылка на оплату — самый короткий путь начать: Нет программиста — как начать.
Вопросы и ответы
Могут ли несколько покупателей открыть одну ссылку одновременно? Да. Каждому создаётся свой счёт, друг другу они не мешают.
Можно ли изменить сумму ссылки? Да, в кабинете. На уже созданные счета это не влияет, новая сумма действует со следующего покупателя.
Можно ли вернуть деньги по такому платежу? Да, как обычно — возврат делается по конкретному счёту, он виден в разделе «Счета».
Приходят ли вебхуки? Да. По счетам из ссылки приходят те же события invoice.paid и остальные.
Истекает ли сама ссылка? Нет. Истекает не ссылка, а созданный в момент открытия счёт. Если покупатель задержался, он просто открывает ссылку снова и получает новый счёт.
Работают ли ссылки в песочнице? Да, но оплата будет не настоящей — счёт создаётся в тестовом режиме.