Процесорът Daraja M-Pesa приема плащания с M-Pesa през Daraja API на Safaricom в Кения. Касиерът въвежда телефонния номер на клиента, клиентът получава искането за плащане на телефона си и го потвърждава с M-Pesa ПИН, а програмата записва плащането, когато M-Pesa го потвърди. Това е плащането STK Push (Lipa na M-Pesa Online) на Daraja. Процесорът се добавя от Редакция → Плащания → Процесори на разплащания…. Изисква Basic или по-добър лиценз. Общите полета на всички типове са описани в Добавяне, редакция и изтриване на процесори на разплащания.
Преди да започнете
- Basic или по-добър лиценз. Прозорецът показва „Изисква Basic или по-добър лиценз“ до типа, в зелено, когато лицензът е наличен, и в червено, когато не е.
- Daraja приложение на фирмата, пуснато в production API на Safaricom, с неговите Consumer Key, Consumer Secret, Business Short Code и PassKey. Връзката Daraja Developers Portal в прозореца на процесора отваря портала на Safaricom, където се кандидатства за тях.
- Тип на плащане за M-Pesa, например „M-Pesa“, добавен в Типове плащания.
- Интернет връзка на работната станция.
Настройка на процесора
- Изберете Редакция → Плащания → Процесори на разплащания… и натиснете Нов.
- Изберете Daraja M-Pesa в Тип на процесора:.
- Въведете Име:, данните от Safaricom и Тип на плащане: и натиснете Запис.
| Поле | Какво прави |
|---|---|
| Consumer Key:, Consumer Secret: | Задължителни. Ключовете на вашето Daraja приложение. |
| Business Short Code: | Задължително. Номерът (paybill), който получава парите. Новият процесор започва със 174379, тестовия код на Daraja: заменете го със своя. |
| PassKey: | Задължително. Паролата (passkey) за Lipa na M-Pesa Online от Safaricom. |
| Account: | Задължително. Референцията, която клиентът вижда в искането. Новият процесор започва с IncoPOS. |
| PartyB (optional): | Номерът, който получава плащането, ако е различен от Business Short Code:. Празно поле използва кода. |
| Тип на плащане: | Задължително. Плащанията с тези типове пускат искане към M-Pesa. |
Програмата проверява ключовете едва при първото искане, затова след настройката направете малко пробно плащане.
Приемане на плащане с M-Pesa
- Запишете продажбата и в прозореца Плащане изберете типа на плащане за M-Pesa. Натиснете ОК.
- Прозорецът Въведете телефонен номер пита „Моля, въведете телефонния номер на клиента:“. Въведете номера или използвайте цифровата клавиатура и натиснете ОК. Номерата 0712345678, 712345678, 254712345678 и +254712345678 са валидни; ОК не е активен, докато номерът не е валиден кенийски номер.
- Прозорецът Обработка на плащане M-PESA показва „Изпращане на STK Push заявка…“ и след това „Изчакване клиентът да завърши плащане по телефона…“. Помолете клиента да потвърди искането на телефона си с M-Pesa ПИН.
- Когато M-Pesa потвърди плащането, прозорецът се затваря и продажбата се записва. Плащането пази номера на M-Pesa разписката.
M-Pesa приема само цели суми, затова искането е за сумата, закръглена до цели шилинги. Програмата пита M-Pesa за резултата 10 секунди след искането и след това на всеки 5 секунди, до 3 минути. Докато чака, прозорецът показва това, което съобщава M-Pesa, например „Изпратено искане за плащане. В очакване на действие на клиента…“. При мрежови проблеми по време на чакането се показва „Неуспешна връзка. Повторен опит…“ или „Мрежов проблем. Повторен опит…“ и програмата продължава да пита.
Стоп прекратява чакането и връща към прозореца Плащане без плащане. Отказ в прозореца за телефона прави същото. Ако клиентът вече е потвърдил на телефона, проверете плащането в извлечението от M-Pesa, преди да го вземете отново.
Без лиценз програмата показва веднъж „Модулът Процесор на разплащания не е безплатен! За да използвате този модул, моля, закупете лиценз.“ и записва плащането като обикновено, без M-Pesa.
Отстраняване на проблеми
| Проблем | Решение |
|---|---|
| „Неуспешно иницииране на M-PESA плащане: текст„ | Daraja отказа искането или не беше достъпен. При „Failed to initiate STK Push“ проверете интернет връзката, Consumer Key и Consumer Secret. Другите текстове идват от Safaricom, например за кода или паролата (passkey). |
| „Изтекло време за плащане. Моля, опитайте отново или проверете дали плащането е завършено по телефона.“ | M-Pesa не потвърди в рамките на 3 минути. Попитайте клиента дали парите са изпратени, преди да опитате отново. |
| Съобщение от M-Pesa, например че искането е отказано от потребителя | Клиентът е отказал, не е отговорил или няма достатъчно пари. Прозорецът Плащане остава отворен: опитайте отново или изберете друг тип на плащане. |
| ОК не е активен във Въведете телефонен номер | Въведете кенийски мобилен номер, например 0712345678. |
| „Моля, попълнете всички полета!“ при запис на процесора | Попълнете всички полета без PartyB (optional):. |