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, розділ про касу