M-Pesa (Safaricom, Кения)

Модуль для магазинов в Кении, которые принимают оплату через M-Pesa — мобильные платежи Safaricom. Покупатель платит со своего телефона на номер магазина (Till — «Buy Goods» или Paybill), а Safaricom сообщает ERPJS о каждом платеже. Платёж появляется в регистре сам — с кодом транзакции из SMS покупателя, суммой и именем плательщика.

Кассир не вводит сумму M-Pesa с клавиатуры: он выбирает платёж из регистра. Чек, в котором сумма M-Pesa не совпадает с выбранными платежами, не проводится. Так каждый шиллинг M-Pesa в чеках сверен с деньгами, которые реально пришли.

Маршрут: от оплаты покупателя до проведённого чека

Учётная запись M-Pesa (номер Till / Paybill, способ оплаты кассы, ключи Daraja)
        ↓
Адрес уведомлений зарегистрирован в Safaricom
        ↓
Покупатель платит → уведомление Safaricom → запись в «Платежах M-Pesa»
        ↓
Касса: кнопка третьего способа оплаты → выбор платежа → чек проведён
        ↓
Код транзакции и сумма — на чеке; номер чека — у платежа в регистре

Учётные записи M-Pesa — номер магазина в Safaricom, способ оплаты кассы для платежей на него, ключи Daraja и адрес, на который Safaricom сообщает о платежах.
Платежи M-Pesa — каждый платёж, о котором сообщил Safaricom (или который внесли вручную), и чек или документ «Платежи», в который его взяли.
Инструкция M-Pesa — подключение по шагам и работа на кассе.

Что важно понимать

Один платёж — один чек или один документ «Платежи». Платёж, взятый одним чеком, другой чек (и другая касса) взять не может. Удалили непроведённый чек — его платежи снова свободны. Деньги, пришедшие заранее, берут в документ «Платежи» как предоплату клиента.

Платёж берётся целиком. Если он больше, чем осталось оплатить по чеку, касса откажет: сдачи с M-Pesa нет.

Чек сверяется при проведении. Сумма каждого способа оплаты M-Pesa в чеке должна равняться сумме взятых чеком платежей на номера этого способа — и когда чек закрывает касса, и когда счёт проводят из окна.

Закрытая учётная запись выключает M-Pesa для своего способа оплаты. Касса снова принимает сумму с клавиатуры, сверки нет. Закрывает запись тот, у кого есть права на учётные записи M-Pesa, а не кассир.

Модуль есть только в версии ERPJS для Кении. В украинской версии его регистров, кнопок и колонки «Код транзакции M-Pesa» в документе «Платежи» нет вовсе. Версию задаёт настройка сервера ERPJS, а не права ролей. В версии для Кении без открытой учётной записи M-Pesa касса принимает сумму третьего способа с клавиатуры, как раньше, а уведомления Safaricom не принимаются.

С чего начать

Способ оплаты для M-Pesa и третий способ оплаты кассы.
Учётная запись M-Pesa — номер, способ оплаты, ключи Daraja.
Адрес уведомлений — в Safaricom (кнопкой из окна учётной записи или через Safaricom).
Тестовый платёж и тестовый чек на кассе.

Частые задачи

Нужно	Куда идти
подключить номер Till или Paybill	Учётные записи M-Pesa
найти платёж по коду из SMS	Платежи M-Pesa
узнать, в какой чек взят платёж	Платежи M-Pesa, колонка «Счет-фактура»
уведомление не пришло, а деньги есть	Платежи M-Pesa → новый платёж вручную
провести предоплату клиента с M-Pesa	Платежи M-Pesa → «Создать платеж клиента (предоплата)»
принять M-Pesa на кассе	Инструкция M-Pesa, раздел о кассе