Введение
"Мокка – оплата авансом" – это мгновенное предоставление покупателю возможности оплаты покупки равными частями по заранее выбранному графику, в то время как Мокка переведёт вам деньги за покупку сразу.
Оформление авансов осуществляется агентами - сотрудниками розничных магазинов. Агенты оформляют авансы при помощи мобильного приложения Консультант Мокка. Для обеспечения контроля оплаты может быть реализована проверка кассовым ПО сгенерированного приложением штрих-кода, который формируется в результате оформления аванса/возврата.
Для сверки оформленных авансов мы ежедневно направляем реестры по операциям.
Бизнес-процессы
Использование приложения Консультант Мокка позволяет автоматизировать следующие бизнес-процессы:
- Получение лимита клиентом;
- Оплата авансом;
- Возврат товара.
Получение лимита
Процесс инициируется сотрудником магазина в момент, когда он регистрирует или авторизует покупателя в приложении.
- Агент вводит номер мобильного телефона клиента в приложении;
- Клиент подтверждает оформление заявки и согласие на использование его персональных данных называя агенту код, полученный им в смс;
- Агент вводит код и заполняет сведения о клиенте;
- Мокка рассчитывает и отображает в приложении доступный клиенту лимит.
Оплата авансом
Процесс инициируется агентом в момент, когда он оформляет оплату покупки авансом Мокка.
- Агент после авторизации клиента в приложении вводит сумму покупки;
- В приложении отображается информация о доступных графиках и суммах ежемесячных платежей;
- Агент указывает в приложении выбранный клиентом период;
- Мокка направляет клиенту смс для подтверждения оформления аванса;
- Агент вводит код;
- В приложении отображается штрих-код, содержащий информацию, необходимую для проверки наличия оформленного аванса и соответствия его сумме покупки;
- Агент сканирует штрих-код на кассе, тем самым оформляя чек и покупку;
- Мокка отправляет реестр операций, и переводит на счёт партнёра денежные средства за покупку.
Возврат товара
Процесс инициируется агентом в момент, когда требуется оформить возврат покупки, совершенной с использованием аванса Мокка.
- Агент после авторизации в мобильном приложении выбирает оформление возврата и находит ранее оформленную покупку по номеру заказа, телефону или номеру паспорта клиента;
- Мокка направляет клиенту проверочный смс-код, который агент вводит в мобильное приложение;
- Мокка производит отмену аванса и восстанавливает лимит клиента;
- Агент сканирует сформированный мобильным приложением штрих-код на кассе для оформления чека возврата.
Шаги интеграции
Процесс интеграции c агентским приложением Мокка включает в себя следующие шаги:
- Реализация: первичное ознакомление, реализация и тестирование считывания штрих-кода приложения (как правило производится на тестовой кассе партнера).
- Тестовая отладка: поиск и устранение ошибок, которые могут возникнуть в ходе считывания и обработки штрих-кода.
- Размещение маркетинговых материалов: на стороне партнёра (должно соответствовать установленным компанией требованиям к визуализации);
- Запуск: получение коммерческих настроек от менеджера по интеграции Мокка и старт приёма платежей.
Тестирование и отладка в ходе интеграции производятся на тестовой версии агентского приложения.
Тестовые параметры
Для формирования тестовых запросов вам необходимо заранее получить от менеджера по интеграции Мокка тестовый аккаунт: номер телефона для входа и пин-код.
Проверка штрих-кода для оформления покупки/возврата на кассе
Результатом оформления аванса/возврата Мокка в приложении Агента является отображение на экране приложения штрих-кода, содержащего проверочную информацию, которая позволяет избежать ошибок при оформлении.
Штрих-код генерируется с типом Code128.
При согласовании условий сотрудничества оговаривают один из следующих вариантов генерации штрихкода:
- Базовый
- Базовый с копейками
- Короткий с копейками
1. Рассмотрим базовый вариант генерации штрихкода.
Формат:
FBBKKMMMMMSSSSSХХХХХХХХXZ
25 символов, где:
F — код операции
1продажа (для Мокка)2возврат (для Мокка)
BB — банк (2)
KK — код продукта банка (2)
MMMMM — номер магазина (5)
SSSSS — сумма чека = договора (5)
XXXXXXXXX — идентификатор операции Мокка (9)
Z — контрольное (1)
Контрольное число вычисляется как остаток от деления на 10 суммы произведений каждой нечетной цифры кода на 1 и четной на 2. Для преобразования буквенных значений кода в число используется таблица:
| A | 65 |
| B | 66 |
| C | 67 |
| D | 68 |
| E | 69 |
| F | 70 |
| G | 71 |
| H | 72 |
| I | 73 |
| J | 74 |
| K | 75 |
| L | 76 |
| M | 77 |
| N | 78 |
| O | 79 |
| P | 80 |
| Q | 81 |
| R | 82 |
| S | 83 |
| T | 84 |
| U | 85 |
| V | 86 |
| W | 87 |
| X | 88 |
| Y | 89 |
| Z | 90 |
Пример расчета контрольного числа для кода 1RE0110166009990000000001
| № пп | код | код числ | множитель | результат |
|---|---|---|---|---|
| 1 | 1 | 1 | 1 | 1 |
| 2 | R | 82 | 2 | 164 |
| 3 | E | 69 | 1 | 69 |
| 4 | 0 | 0 | 2 | 0 |
| 5 | 1 | 1 | 1 | |
| 6 | 1 | 2 | 2 | |
| 7 | 0 | 1 | 0 | |
| 8 | 1 | 2 | 2 | |
| 9 | 6 | 1 | 6 | |
| 10 | 6 | 6 | 2 | 12 |
| 11 | 0 | 0 | 1 | 0 |
| 12 | 0 | 0 | 2 | 0 |
| 13 | 9 | 9 | 1 | 9 |
| 14 | 9 | 9 | 2 | 18 |
| 15 | 9 | 9 | 1 | 9 |
| 16 | 0 | 0 | 2 | 0 |
| 17 | 0 | 0 | 1 | 0 |
| 18 | 0 | 0 | 2 | 0 |
| 19 | 0 | 0 | 1 | 0 |
| 20 | 0 | 0 | 2 | 0 |
| 21 | 0 | 0 | 1 | 0 |
| 22 | 0 | 0 | 2 | 0 |
| 23 | 0 | 0 | 1 | 0 |
| 24 | 1 | 1 | 2 | 2 |
| 295 | ||||
| 25 | кц | 5 |
Штрихкод без изменений должен сохраняться в транзакции и передаваться в кассу.
2. Вариант "Базовый с копейками"
Отличается от базового тем, что для суммы отводится не 5, а 7 символов (2 дополнительных символа используются для копеек). Соответственно, длина штрихкода в этом случае получается (25+2) = 27 символов.
3. Вариант "Короткий с копейками"
Отличается от базового тем, что не отображаются банк (2 символа) и код продукта банка (2 символа), а для суммы отводится не 5, а 7 символов (2 дополнительных символа используются для копеек). Соответственно, длина штрихкода в этом случае получается (25-2-2+2) = 23 символа.
Другие поля имеют всегда фиксированное количество символов в штрихкоде.
Валидация штрихкода
Валидация штрихкода может проводиться по нескольким параметрам.
1) Проверка контрольного числа. Проверяя контрольное число (алгоритм вычисления см. выше) можно убедиться, что штрихкод не был модифицирован третьей стороной.
2) Проверка суммы покупки. Сумма покупки, указанная в штрихкоде (тело займа) должна совпадать с суммой покупки в учетной системе, чтобы не было расхождений при сверке взаиморасчетов.
Тестовая отладка
На данном шаге необходимо выполнить тестирование корректного считывания, распознавания, проверки корректности и соответствия содержания штрих-кода.
Порядок проведения отладочного тестирования:
- Получение лимита клиента;
- Совершение покупки;
- Отмена совершённого заказа;
- Возврат заказа.
При оформлении тестовых авансов рекомендуется передавать параметры, удовлетворяющие следующим условиям:
- Номер телефона – должен начинаться с префикса
888, чтобы sms не отправлялись реальным людям; - Код подтверждения и пин-код –
8888(код для тестирования на боевом сервере задаётся в настройках партнёра).
Запуск
После успешного прохождения всех предыдущих шагов интеграции вы готовы к приёму платежей с помощью Аванса Мокка. Для запуска приема платежей необходимо обратиться к менеджеру по интеграции Мокка, для перевода вашего магазина в боевой режим и передать ему заполненные шаблоны (предоставляются менеджером Мокка):
- Список сотрудников;
- Список магазинов.
После получения подтверждения от менеджера, что данные загружены в систему вы готовы принимать оплату в магазине авансом Мокка, что существенно повысит количество продаж вашего магазина.