# Ссылки на оплату — постоянный адрес для приёма платежей

> Постоянная ссылка вида qut.kz/p/<slug>: свой адрес, фиксированная и открытая сумма, остановка и возобновление, чем отличается от ссылки на счёт, отчётность по ссылкам и коды ошибок.

## Коротко

Ссылка на оплату — это **постоянный адрес**, например `qut.kz/p/kofe`. После создания он не меняется и не истекает: одну и ту же ссылку можно поставить в шапку профиля Instagram, на визитку, в сообщение WhatsApp или на наклейку в кафе.

Когда покупатель открывает ссылку, **в этот момент создаётся новый счёт**, и он оплачивает его через Kaspi. То есть ссылка — это не счёт, а «кран», который выпускает счета.

Писать код не нужно: ссылка создаётся в разделе **Ссылки** в кабинете.

## Чем отличается от ссылки на счёт

Эти две вещи часто путают.

| | Ссылка на оплату (`qut.kz/p/<slug>`) | Ссылка на счёт (`payUrl`) |
|---|---|---|
| Когда создаётся | Один раз, вручную | На каждый счёт, автоматически |
| Адрес | Выбираете сами | Генерируется случайно |
| Срок | Бессрочная | Ограничен окном оплаты счёта |
| Сколько раз оплачивается | Сколько угодно, у каждого свой счёт | Один раз |
| Куда ставится | Профиль, визитка, наклейка, письмо | Редирект со страницы заказа |
| Для кого | Кто работает без кода | Сайт, приложение, интеграция |

Короткое правило: **один заказ — ссылка на счёт, постоянное предложение — ссылка на оплату**.

## Создание

Кабинет → **Ссылки** → добавить ссылку. Заполняете:

| Поле | Что указывается |
|---|---|
| Адрес (slug) | Часть после `qut.kz/p/`: `kofe`, `konsultaciya`, `donat` |
| Название | Покупатель видит на странице оплаты |
| Сумма | Фиксированная или открытая |
| Тип | QR или счёт по телефону |
| Описание | Дополнительный текст на странице оплаты |

В адресе допустимы строчные латинские буквы, цифры и дефис. Кириллица и пробелы не подойдут.

Выбирайте **свободный** адрес: если такой уже занят, придёт ошибка `slug_taken`. Берите короткое и легко произносимое слово — покупателю, возможно, придётся набирать его вручную.

## Фиксированная и открытая сумма

**Фиксированная сумма.** Сумма зашита в ссылку, покупатель её не меняет. Удобно для того, у чего одна цена: консультация, абонемент, один товар.

**Открытая сумма.** Сумму вводит сам покупатель. Нужна, когда:

- у каждого клиента своя сумма (индивидуальный заказ, объём работ);
- вы принимаете заранее оговорённую сумму (предоплата, депозит);
- это донат, благотворительность или чаевые.

Для открытой суммы можно задать минимум и максимум — чтобы покупатель не ввёл сумму по ошибке.

Ограничения суммы те же, что у обычного счёта: у QR допустимы два знака после запятой, у счёта по телефону — только целые тенге. Разбор различий: [QR-счёт или счёт по телефону](/kb/ru/qr-vs-phone).

## Остановка и возобновление

Ссылку можно **приостановить**, не удаляя. При открытии остановленной ссылки покупатель видит сообщение, что оплата временно недоступна, а ранее созданные по ней счета остаются в силе.

Например:

- закончился сезонный товар — останавливаете, в следующем сезоне включаете обратно;
- закончилась акция — ставите на паузу, пока меняете цену;
- ссылка разошлась не туда — останавливаете и разбираетесь.

Возобновление — там же, одной кнопкой. Адрес сохраняется, поэтому ссылки в рекламе и на визитках продолжают работать.

**Удаление** — окончательное. Удалённый адрес вернуть нельзя, так что при малейшем сомнении ограничьтесь остановкой.

## Отчётность: сколько принесла каждая ссылка

В каждом счёте сохраняется, из какой ссылки он создан. Благодаря этому:

- в разделе **Ссылки** видно количество счетов и оплаченную сумму по каждой ссылке;
- в разделе **Счета** можно отфильтровать по ссылке;
- в 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 |
| Кафе, небольшой магазин | Наклейка на кассе или на столе |
| Мероприятие, билеты | Ссылка с открытой суммой или несколько уровней цены |
| Курс, консультация | Отдельная ссылка на каждую услугу |

Если программиста нет, ссылка на оплату — самый короткий путь начать: [Нет программиста — как начать](/kb/ru/no-developer).

## Вопросы и ответы

**Могут ли несколько покупателей открыть одну ссылку одновременно?** Да. Каждому создаётся свой счёт, друг другу они не мешают.

**Можно ли изменить сумму ссылки?** Да, в кабинете. На уже созданные счета это не влияет, новая сумма действует со следующего покупателя.

**Можно ли вернуть деньги по такому платежу?** Да, как обычно — возврат делается по конкретному счёту, он виден в разделе «Счета».

**Приходят ли вебхуки?** Да. По счетам из ссылки приходят те же события `invoice.paid` и остальные.

**Истекает ли сама ссылка?** Нет. Истекает не ссылка, а созданный в момент открытия счёт. Если покупатель задержался, он просто открывает ссылку снова и получает новый счёт.

**Работают ли ссылки в песочнице?** Да, но оплата будет не настоящей — счёт создаётся в тестовом режиме.