Учетные записи M-Pesa
Запись описывает один номер магазина в Safaricom — Till («Buy Goods») или Paybill: на какой способ оплаты кассы ложатся платежи на этот номер, какими ключами Daraja ERPJS говорит с Safaricom и на какой адрес Safaricom сообщает о платежах. Регистр есть только в версии ERPJS для Кении.
Касса узнаёт себя по способу оплаты: если среди кодов третьего способа оплаты кассы есть способ оплаты открытой учётной записи M-Pesa, кнопка этого способа открывает выбор платежа из Платежей M-Pesa, а не ввод суммы.
Где искать: Модули → M-Pesa → Регистры → Учетные записи M-Pesa
Разбор на примере
Учётная запись VIC-MALL:
| Поле | Значение | Зачем |
|---|---|---|
| Код | VIC-MALL |
его пишет в платёж уведомление Safaricom |
| Номер M-Pesa (Till / Paybill) | 512345 |
номер, на который платят покупатели, — 5–7 цифр |
| Тип номера | Till (Buy Goods) | Paybill — если покупатель вводит ещё и номер счёта |
| Способ оплаты | MPESA |
третий способ оплаты касс, которые принимают этот номер |
| Среда Daraja | Sandbox (тест) | куда идут ключи: тестовая или боевая среда Safaricom |
| Ключ Daraja (consumer key), Секрет Daraja (consumer secret) | маска | ключи приложения Daraja; хранятся зашифрованными |
| Закрыто | — | закрытая запись выключает M-Pesa для своего способа оплаты |
Ключи. После сохранения поле показывает маску. Не трогайте его — ключ останется; наберите новый — он заменит старый; очистите поле — ключ сотрётся при сохранении. Если меняете среду, введите ключи ещё раз: система не отправит старые ключи в другую среду. Без ключей запись сохраняется и уведомления принимает — они нужны только для регистрации адреса в Safaricom.
Одна открытая запись — на номер и на способ оплаты. Касса ищет запись по коду своего третьего способа оплаты, а платёж — по номеру, на который он пришёл. Две открытые записи на одном номере или на одном способе оплаты система не сохранит.
Секрет адреса уведомлений создаёт сервер при первом сохранении; в окне его не видно и не изменить.
Меню окна
- «Адрес уведомлений» — адреса, на которые Safaricom сообщает о платежах (Confirmation URL и Validation URL). В них — секрет записи: кто знает адрес, тот может записать платёж. Показываются только тому, кто может изменять учётные записи M-Pesa.
- «Зарегистрировать адрес в Safaricom» — передать эти адреса в Safaricom ключами записи. Адрес ERPJS берётся тот, по
которому открыто окно: он должен начинаться с
https://и не содержать слов, которые Safaricom не принимает в адресе (M-Pesa, Safaricom, exe, cmd, sql, query). Регистрируется сохранённая запись: сначала сохраните изменения; нужны ключи Daraja. Права — те же, что для пункта «Адрес уведомлений».
Закрыть запись
Флажок «Закрыто»: уведомления на адрес записи больше не принимаются, а касса снова принимает сумму третьего способа с клавиатуры, без сверки. Платежи, уже записанные в регистр, остаются.
Платежи, которые открытый чек успел взять до закрытия, остаются за этим чеком, а выбрать или убрать платёж касса после закрытия уже не даёт. Поэтому сначала закройте или удалите такие чеки, а потом закрывайте запись.
Пошаговое подключение — в Инструкции M-Pesa.