Оплата курьеру через Kaspi: предоплата и QR у двери
Как доставке принимать оплату через Kaspi: предоплата по ссылке, QR с экрана курьера, заказы через API, отмена, возврат и контроль неоплаченных заказов.
Короткий ответ. Оплату за доставку через Kaspi можно принять двумя способами: предоплатой по ссылке при оформлении заказа или у двери, когда курьер показывает с экрана своего телефона страницу оплаты с QR. В обоих случаях деньги идут на счёт кассы компании, а не на карту курьера, и в кабинете по каждому заказу видно, оплачен он или нет. Заказы заводятся из кабинета вручную или вашей системой через API, а о каждой оплате, отмене и возврате ваша система узнаёт вебхуком. Неоплаченный заказ можно отменить, оплаченный вернуть целиком или частично. На вопрос «сколько я должен» в WhatsApp клиенту может ответить автоответчик.
Что обычно идёт не так
Доставка еды, цветов, воды или товаров теряет деньги в двух местах. Первое: наличные и переводы на карту курьера, которые потом сверяют с заказами вручную. Второе: заказы, за которые так и не заплатили, хотя курьер уже съездил.
KazPayment закрывает денежную часть: счёт, оплату, сверку с выпиской кассы, отмену и возврат. Маршруты, назначение курьеров и их выработка остаются вашей системе доставки.
Два способа принять оплату
| Предоплата по ссылке | Оплата у курьера | |
|---|---|---|
| Когда платит клиент | при оформлении, до выезда | у двери, при получении |
| Как платит | открывает ссылку и нажимает «Оплатить в Kaspi» | сканирует QR с экрана телефона курьера |
| Какой банк нужен | Kaspi, а по QR и другие банки | любой банк, который читает Единый QR |
| Куда идут деньги | на счёт кассы компании | на счёт кассы компании |
| Что даёт | курьер едет только к оплаченному заказу | нет наличных и переводов на личные карты |
Предоплата. Заказ создан, клиенту уходит ссылка на оплату. На телефоне главная кнопка страницы «Оплатить в Kaspi»: она открывает приложение уже с суммой, номер вводить не нужно. Ниже есть «Показать QR-код» для оплаты другим банком. Ссылку можно отправить в мессенджере или через KazPayment (об этом ниже).
Оплата у двери. Курьер открывает страницу оплаты этого заказа и показывает экран. Клиент наводит камеру из приложения своего банка: это Единый QR, его читает не только Kaspi. Как только деньги пришли, страница сама показывает «Оплачено», и курьер видит это сразу.
Одна настройка здесь важна. По умолчанию страница на телефоне предлагает «Оплатить в Kaspi», то есть открыть Kaspi на том телефоне, где она открыта. Курьеру это не нужно: платить должен клиент, а не он. Если курьеры принимают оплату со своего экрана, включите «Настройки» → «Страница оплаты» → «Оплата с телефона» → «Как на компьютере». Тогда и с телефона страница сразу показывает QR-код и счёт на номер. Настройка действует на все ссылки бизнеса: из кабинета, с ценников товаров и через API. Подробнее о странице оплаты в инструкции Оплата по ссылке и QR.
QR нельзя распечатать заранее
QR на странице оплаты живёт около трёх минут. Это ограничение Kaspi. Код выпускается в момент, когда на странице нажимают кнопку, и содержит сумму конкретного заказа. Не успели, кнопка выпустит новый, а сама ссылка не устаревает.
Поэтому курьеру нужна ссылка на страницу оплаты, а не скриншот кода.
Если у вас есть позиции с постоянной ценой, например бутыль воды или доставка по городу, для них можно сделать постоянный QR в разделе «Товары». Его можно печатать: он не устаревает и принимает оплату сколько угодно раз. Как это устроено, в статье QR-код Kaspi на товар.
Откуда берутся заказы
Из кабинета. Подходит, если заказов немного и их принимает диспетчер. Заведите тариф с режимом «Разовый», например «Доставка», а клиента по телефону получателя. Заказ оформляется ручным начислением в разделе «Начисления»: подписка клиента, сумма, срок и номер заказа. Затем у начисления нажимается кнопка «Ссылка», и ссылку можно отправить клиенту или курьеру. Пошагово в инструкции Служба доставки.
Через API. Подходит, если заказы приходят с сайта, из бота или из вашей системы доставки. Ваша программа создаёт заказ запросом POST /api/v1/orders и сразу получает в ответе pay_url, ссылку на страницу оплаты. Её можно показать курьеру рядом с адресом в его приложении или отправить клиенту.
Что важно знать про заказ через API:
external_ref— ваш номер заказа. Повторный запрос с тем же номером не создаст второй заказ, а вернёт первый, поэтому обрыв связи не приведёт к двойному счёту.- Сумма закрепляется за номером. Повтор с другой суммой вернёт ошибку, а не тихо заменит сумму.
customer_phoneнеобязателен. Если он указан, клиенту примерно через минуту придёт ещё и счёт в приложение Kaspi, а сам клиент появится в разделе «Клиенты». Без телефона заказ оплачивается только по ссылке.- Статус заказа можно спросить запросом
GET /api/v1/orders/<номер>:pending,paidилиcancelled.
API и вебхуки работают на любом тарифе, включая бесплатный Free: на нём через API можно создать до 500 заказов и принять до 100 оплат за 30 дней. Маршрут от ключа до первой оплаты описан в инструкции Подключить интернет-магазин или телеграм-бот, все поля и ответы в документации API.
Сообщения клиенту в WhatsApp
Через API можно отправить покупателю в WhatsApp ссылку на оплату заказа: POST /api/v1/orders/<номер>/notify. Номер берётся из customer_phone заказа, текст собирается по одобренному шаблону с названием вашего бизнеса, суммой и ссылкой. По одному заказу уходит одно такое сообщение, по оплаченному или отменённому не уходит ничего.
Сообщить клиенту, что заказ в пути, можно ручкой POST /api/v1/whatsapp/order. Состояние вы передаёте готовой строкой, например «курьер в пути» или «можно забирать», потому что этапы у каждой доставки свои. Это служебное сообщение, оно списывается с баланса по цене WhatsApp, 18 ₸.
Если клиент сам пишет в WhatsApp «сколько я должен» или «пришлите ссылку», ему может ответить автоответчик. Его включают в разделе «WhatsApp», по умолчанию он выключен. Он отвечает суммой долга и ссылкой на самое старое неоплаченное начисление, а на «я оплатил» ссылку не присылает никогда: говорит, что видно по начислениям, и передаёт вопрос вам. Отвечает он только тем, кто есть в разделе «Клиенты». Заказ через API без телефона клиента не создаёт, и такому покупателю автоответчик не ответит. Про его ограничения подробно в инструкции Автоответчик в WhatsApp.
Отмена, возврат и поздняя оплата
Неоплаченный заказ отменяется. В кабинете это кнопка «Отменить» у начисления, через API запрос POST /api/v1/orders/<номер>/cancel. После отмены счёт в приложении Kaspi гасится, а страница оплаты отвечает, что платить нечего.
У отмены есть одно исключение. Если клиент уже открыл страницу и получил QR, этот код Kaspi отменить не даёт, и он живёт свои три минуты. Деньги, заплаченные по нему после отмены, не теряются: заказ становится оплаченным, а вебхук приходит с пометкой "late": true. Дальше вы решаете сами: везти заказ или вернуть деньги.
Оплаченный заказ возвращается. Не довезли, клиент отказался, ошиблись суммой. В кабинете возврат делается кнопкой «Возврат» у оплаченного начисления, нужно указать сумму и причину. Через API это POST /api/v1/orders/<номер>/refund с суммой, причиной и вашим номером возврата refund_ref. Возврат бывает полным или частичным, деньги уходят на ту карту, с которой пришли. Возврат делает владелец, у сотрудника такой кнопки нет. Подробнее в инструкции Вернуть деньги клиенту.
Вебхук для вашей системы
Если заказы ведёт ваша программа, ей нужно узнавать об оплате без опроса. Для этого настраивается вебхук: адрес, на который KazPayment присылает события.
| Событие | Когда приходит |
|---|---|
payment.received |
заказ оплачен; late: true значит, что оплата пришла после отмены |
order.cancelled |
заказ отменён, через API или в кабинете |
order.refunded |
по заказу вернули деньги, через API, в кабинете или в приложении Kaspi |
payment.partial |
по отменённому заказу пришла не вся сумма |
В событии есть ваш order_ref, сумма и оплаченная сумма, а персональных данных нет. Подпись нужно проверять, повторы отбрасывать по event_id. Если клиент закрыл страницу, не дождавшись «Оплачено», оплату подхватит сверка с выпиской кассы, которая идёт раз в час. Поэтому вебхук в худшем случае приходит в пределах часа.
Как увидеть, какие заказы не оплачены
В разделе «Начисления» у каждого заказа есть статус: «Ожидает», «Выставлен счёт», «Оплачено», «Отменено» или «В разборе». Поиск находит заказ по номеру, клиенту или тарифу, а список можно выгрузить в CSV.
Отдельной роли «курьер» и привязки заказа к курьеру в KazPayment нет. Кто вёз какой заказ, знает ваша система доставки. Сводка «неоплаченное по курьерам» складывается у вас: по номеру заказа из вебхука или по статусу из GET /api/v1/orders/<номер>.
Давать курьеру доступ в кабинет не нужно: ему хватает ссылки на страницу оплаты. Если доступ всё же нужен, например старшему смены, заведите ему роль «Сотрудник» в разделе «Команда». Сотрудник видит списки, но не создаёт начисления, не отменяет счета и не делает возвраты. Владелец может разрешить сотрудникам выдавать ссылку на оплату: «Команда» → «Что ещё можно сотрудникам» → «Выдавать клиенту ссылку на оплату». Тогда сотрудник выдаёт ссылку только на выставленный и ещё не оплаченный счёт и сумму не меняет.
Частые вопросы
Деньги приходят курьеру или компании?
Компании. Страница оплаты и счёт в приложении Kaspi выставляются от кассы вашего бизнеса, и клиент платит на её счёт. Курьер только показывает экран, через его карту деньги не проходят. Комиссию за приём, 0,95%, удерживает Kaspi, своей комиссии с оборота у KazPayment нет.
Может ли клиент заплатить не через Kaspi?
Да. QR на странице оплаты это Единый QR, его сканирует приложение любого банка, который его поддерживает. Kaspi нужен клиенту только для кнопки «Оплатить в Kaspi» и для счёта в приложение по номеру телефона.
Можно ли напечатать QR на чеке или пакете?
QR оплаты конкретного заказа нельзя: он живёт около трёх минут. Печатать можно ссылку на страницу оплаты или постоянный QR товара с фиксированной ценой из раздела «Товары». Постоянный QR подходит для позиций, у которых цена всегда одна.
Что будет, если клиент заплатил дважды?
Заказ останется оплаченным один раз, а второй платёж попадёт в раздел «Расхождения». Оттуда его видно, и лишнее можно вернуть тем же порядком, что и обычный возврат.
Клиент заплатил, а курьер не видит «Оплачено». Что делать?
Пока страница открыта, она проверяет кассу каждые несколько секунд и обычно показывает оплату почти сразу. Если страницу закрыли раньше, оплату найдёт сверка с выпиской кассы, она идёт раз в час. Статус заказа в это время можно проверить в разделе «Начисления» или запросом к API.
Можно ли приходить к клиенту без предоплаты и не терять деньги?
Можно принимать оплату у двери по QR, тогда деньги сразу идут на счёт компании. Но от отказа у двери это не защищает: если для вас важно, чтобы курьер не ездил впустую, лучше брать предоплату по ссылке и отправлять курьера только к заказам со статусом «Оплачено».
Попробуйте KazPayment бесплатно
Тестовый режим без ограничения по времени: заведите тарифы, товары и счета и посмотрите, как это работает, до того как подключать настоящую кассу.
Начать бесплатно