Что видит покупатель

Коротко

В своём приложении Kaspi покупатель видит сумму, описание, которое написали вы, и номер кассира. Показ номера кассира — штатное поведение Kaspi, скрыть его нельзя. После оплаты у покупателя остаётся чек самого Kaspi, а вы можете дополнительно дать ему нашу страницу чека. Не видно ничего из: metadata, вашего номера заказа (externalOrderId) и любых других внутренних данных.

Что видно до оплаты

Описание — единственный текст, который читает покупатель

Поле description — ваше единственное место для разговора с покупателем. Поэтому пишите его осознанно.

Ограничения:

• QR-счёт — 100 символов
• Счёт на телефон (phone) — 60 символов

Всё, что длиннее, обрезается. Поэтому самое важное ставьте в начало.

Хорошие примеры:

• Заказ №1043, 2 шт. — сразу понятно, за что платят
• Май, абонемент — однозначно для повторяющихся платежей
• Стол 7, счёт — в ресторане

Плохие примеры:

• Оплата — покупатель не понимает, за что платит, и потом спрашивает
• inv_8f3a2b91c... — внутренний идентификатор, покупателю не говорит ничего
• Длинный маркетинговый текст — обрежется на середине фразы

Совет: пишите то, что покупатель узнаёт сам — номер заказа, название товара, период. Меньше споров и меньше просьб о возврате.

Номер кассира виден

В уведомлении о счёте покупатель видит номер кассира. Так работает Kaspi: показать, кто именно принимает платёж, — это сделано для безопасности. Отключить показ или подменить номер нельзя.

Практические следствия:

• Держите номер кассира отдельным. Пусть это не будет вашим личным номером — покупатели начнут писать и звонить именно на него
• Лучше, чтобы на этом номере не было WhatsApp, иначе туда пойдут все вопросы
• Отдельно публикуйте номер поддержки, чтобы покупатель знал, куда писать
• Если кассиров несколько, покупатель видит, какой именно выставил счёт

Подробнее: Номер кассира и ваш личный номер.

Что видно после оплаты

Чек Kaspi. Kaspi выдаёт покупателю чек в своём приложении, он остаётся в истории платежей.

Наша страница чека. После оплаты у счёта заполняется поле receiptUrl — это страница, которую можно отправить покупателю. На ней основные данные счёта и факт оплаты. Её удобно вставлять в сообщение, письмо или страницу «спасибо» на вашем сайте. Подробнее: Чеки и доставка их покупателю.

Ваша страница successUrl. Если при создании счёта вы передали successUrl, покупатель после оплаты вернётся на неё. Там можно показать статус заказа, срок доставки или открыть доступ.

Фискальный чек — отдельная тема: когда его выпускает сам Kaspi, а когда отвечаете вы: Фискальный чек.

Чего покупатель не видит

До покупателя никогда не доходит:

• metadata — что бы там ни лежало, оно только для вашей системы и вебхука. Состав заказа, адрес доставки, внутренние метки — всё скрыто
• externalOrderId — ваш номер заказа. Если покупателю его нужно видеть, впишите номер в description сами
• Внутренний идентификатор счёта вида inv_…
• Ваш API-ключ, адрес webhook и его секрет
• Данные других покупателей — счета полностью изолированы

То есть metadata — безопасное место, но не бездонное: не храните там пароли и чужие персональные данные. Подробнее: Metadata и номер заказа и Данные и конфиденциальность.

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

Можно скрыть номер кассира? Нет. Его показывает Kaspi, повлиять на это мы не можем. Поэтому заведите для кассира отдельный, не личный номер.

Видит ли покупатель название магазина? Да, в том виде, в каком оно записано в вашем аккаунте Kaspi Pay. Меняется оно на стороне Kaspi Pay.

Можно вставить эмодзи в описание? Технически это текст, но помните про лимит символов: эмодзи тоже занимают место, а длинный текст обрежется.

Увидит ли покупатель возврат? Да, возврат денег отображается в приложении Kaspi.

Можно отправить чек покупателю на почту? Да, ссылку receiptUrl вы отправляете сами. Подробнее: Чеки.